diff --git a/src/plugins/server/main.mli b/src/plugins/server/main.mli
index 4c4da8678f190aa2c6ec5180c030b9a5d67cec59..acd7ef46c6b7030dc51c34cc2b0c187852f00768 100644
--- a/src/plugins/server/main.mli
+++ b/src/plugins/server/main.mli
@@ -83,10 +83,15 @@ val create :
   fetch:(unit -> 'a message option) ->
   unit -> 'a server
 
-(** Run the server forever. *)
+(** Run the server forever.
+    The function will not return until the server is shut down. *)
 val run : 'a server -> unit
 
-(** Start the server in background. *)
+(** Start the server in background.
+    The function returns immediately
+    after installing a daemon that accepts GET requests received by
+    the server on calls to `Db.yield()`.
+*)
 val start : 'a server -> unit
 
 (** Stop the server if it is running in background. *)