2020-01-13 22:33:42 +00:00
|
|
|
# ocaml-odoc
|
|
|
|
|
2022-02-09 16:36:31 +00:00
|
|
|
This package contains [odoc](https://github.com/ocaml/odoc), a documentation
|
|
|
|
generator for [OCaml](https://ocaml.org/) and
|
|
|
|
[Reason](https://reasonml.github.io/). It reads doc comments, delimited with
|
|
|
|
`(** ... *)`, and outputs HTML. Text inside doc comments is marked up in
|
|
|
|
[ocamldoc syntax](https://ocaml.org/manual/ocamldoc.html).
|
|
|
|
|
|
|
|
Odoc's main advantage over ocamldoc is an accurate cross-referencer, which
|
|
|
|
handles the complexity of the OCaml module system. Odoc also offers a good
|
|
|
|
opportunity to improve HTML output compared to ocamldoc, but this is very much
|
|
|
|
a work in progress.
|