Dear OCaml Users,

 

I started to use ocamldoc (via ocamlbuild doc.docdir/index.html). It works as expected, just it ignores all section headers (they don’t appear in the generated HTML at all). I wonder what I am doing wrong here.

 

The syntax I am using is

 

(** {2 Lexer utilities} *)

 

One thing I didn’t fully understand from the documentation is if ocamldoc generates one HTML file per module or one per ML file or both (I don’t have explicit modules as yet) and how section headers are interpreted in this context. If I have more than one module in a file, do the section headers belong to the module, or the ML file or both?

 

Best regards,

 

Michael