Clarify comments around Lwt_sequence aliases

Fixes #504.
ocsigen · Dec 3, 2017 · 35df29e · 35df29e
1 parent a59ed6e
commit 35df29e
Showing 1 changed file with 5 additions and 2 deletions.
diff --git a/src/unix/lwt_daemon.ml b/src/unix/lwt_daemon.ml
@@ -19,8 +19,11 @@
  * 02111-1307, USA.
  *)
 
-(* [Lwt_sequence] is deprecated to prevent users from using it, but it is used
-   internally by Lwt. *)
+(* [Lwt_sequence] is deprecated – we don't want users outside Lwt using it.
+   However, it is still used internally by Lwt. So, briefly disable warning 3
+   ("deprecated"), and create a local, non-deprecated alias for
+   [Lwt_sequence] that can be referred to by the rest of the code in this
+   module without triggering any more warnings. *)
 [@@@ocaml.warning "-3"]
 module Lwt_sequence = Lwt_sequence
 [@@@ocaml.warning "+3"]