Generating Documentation With odoc

The documentation rendering tool odoc generates documentation in the form of HTML, LaTeX, or man pages, from the docstrings and interfaces of the project's modules

Dune can run odoc on your project to generate HTML documentation with this command:

$ opam exec -- dune build @doc

# Unix or macOS
$ open _build/default/_doc/_html/index.html

# Windows
$ explorer _build\default\_doc\_html\index.html

Generating .mld Documentation Pages

In addition to documenting the publicly-visible API of your project, odoc also gives you the ability to add individual documentation pages.

For example, to replace the automatically generated documentation index file, you have to add a file index.mld to your project.

To make Dune find your .mld pages and process them with odoc, the dune file in the same directory as your .mld files needs to include this stanza:

(documentation
 (package name-of-your-package))

A common place to put .mld files is a directory named doc or docs.

For more information on how to write documentation pages for odoc, see the odoc for authors documentation.

Help Improve Our Documentation

All OCaml docs are open source. See something that's wrong or unclear? Submit a pull request.

OCaml

Innovation. Community. Security.