odocify the parsetree comments (#11107)

* Odocify the parsetree comments Signed-off-by: Paul-Elliot <peada@free.fr>
ocaml · Mar 28, 2022 · 766888d · 766888d
1 parent 094725c
commit 766888d
Show file tree

Hide file tree

Showing 3 changed files with 533 additions and 464 deletions.
diff --git a/Changes b/Changes
@@ -459,6 +459,9 @@ OCaml 4.14.0
   CSS for coloring bullets
   (Wiktor Kuchta, review by Florian Angeletti)
 
+- #11107: Lifted comments in the Parsetree module into actual documentation.
+  (Paul-Elliot Anglès d'Auriac, review by Florian Angeletti)
+
 ### Compiler user-interface and warnings:
 
 - #10328, #10780: Give more precise error when disambiguation could not

diff --git a/parsing/asttypes.mli b/parsing/asttypes.mli
@@ -48,8 +48,8 @@ type label = string
 
 type arg_label =
     Nolabel
-  | Labelled of string (*  label:T -> ... *)
-  | Optional of string (* ?label:T -> ... *)
+  | Labelled of string (** [label:T -> ...] *)
+  | Optional of string (** [?label:T -> ...] *)
 
 type 'a loc = 'a Location.loc = {
   txt : 'a;