[Caml-list] Ocamldoc ignores section header special comments

["Soegtrop, Michael" <michael.soegtrop@intel.com>]

[-- Attachment #1: Type: text/plain, Size: 986 bytes --]

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
Intel Deutschland GmbH
Registered Address: Am Campeon 10-12, 85579 Neubiberg, Germany
Tel: +49 89 99 8853-0, www.intel.de
Managing Directors: Christin Eisenschmid, Christian Lamprechter
Chairperson of the Supervisory Board: Nicole Lau
Registered Office: Munich
Commercial Register: Amtsgericht Muenchen HRB 186928

[-- Attachment #2: Type: text/html, Size: 3198 bytes --]