prepare for 0.9

CHANGES.md

@@ -1,3 +1,7 @@
+# 0.9
+
+- add an extensible sum type, so users can implement custom events. For example
+    an OTEL collector can provide custom events to link two spans to one another.
 
 # 0.8
 

dune-project

@@ -4,7 +4,7 @@
 
 (generate_opam_files true)
 
-(version 0.8)
+(version 0.9)
 
 (source
  (github c-cube/ocaml-trace))

src/core/collector.ml

@@ -98,7 +98,7 @@ module type S = sig
   (** Handle an extension event.
       A collector {b MUST} simple ignore events it doesn't know,
       and return [()] silently.
-      @since NEXT_RELEASE *)
+      @since 0.8 *)
 
   val shutdown : unit -> unit
   (** Shutdown collector, possibly waiting for it to finish sending data. *)

src/core/trace_core.mli

@@ -219,11 +219,11 @@ val shutdown : unit -> unit
 
 type extension_event = Types.extension_event = ..
 (** Extension event
-  @since NEXT_RELEASE *)
+  @since 0.8 *)
 
 val extension_event : extension_event -> unit
 (** Trigger an extension event, whose meaning depends on
     the library that defines it. Some collectors will
     simply ignore it. This does nothing if no collector
     is setup.
-    @since NEXT_RELEASE *)
+    @since 0.8 *)

src/core/types.ml

@@ -27,4 +27,4 @@ type explicit_span = {
 type extension_event = ..
 (** An extension event, used to add features that are backend specific
     or simply not envisioned by [trace].
-  @since NEXT_RELEASE *)
+  @since 0.8 *)

src/subscriber/callbacks.ml

@@ -108,7 +108,7 @@ module type S = sig
   val on_extension_event :
     st -> time_ns:float -> tid:int -> extension_event -> unit
   (** Extension event
-      @since NEXT_RELEASE *)
+      @since 0.8 *)
 end
 
 type 'st t = (module S with type st = 'st)