README

README.md

odoc

OCaml Documentation Generator.

odoc is a powerful and flexible documentation generator for OCaml. It readsdoc comments, demarcated by(** ... *), and transforms them into a variety of output formats, including HTML, LaTeX, and man pages.

• Output Formats: Odoc generates HTML for web browsing, LaTeX for PDF generation, and man pages for use on Unix-like systems.

• Cross-References: odoc uses theocamldoc markup, which allows to create links for functions, types, modules, and documentation pages.

• Link to Source Code: Documentation generated includes links to the source code of functions, providing an easy way to navigate from the docs to the actual implementation.

• Code Highlighting: odoc automatically highlights syntax in code snippets for different languages.

odoc is part of theOCaml Platform, the recommended set of tools for OCaml.

Getting Started

To begin using odoc, first install it using opam with the following command:

$ opam install odoc

Once installed, you can generate your project documentation withDune:

$ dune build @doc

Upon completion, you'll find your freshly minted docs in_build/default/doc/html/index.html:

$ open _build/default/doc/html/index.html

For more in-depth information and usage instructions, see theodoc website.

Documentation

The full documentation for odoc, including comprehensive user and API guides, can be found on ourwebsite.

Contributing

Contributing Guide

We wholeheartedly welcome contributors! To start, please read ourContributing Guide to familiarize yourself with our development process, including how to propose and how to start hacking on odoc.

Code of Conduct

In order to foster a welcoming and respectful community, odoc has adopted theOCaml Code of Conduct.

Roadmap

Interested in the future of odoc? Take a look at ourRoadmap to understand our vision and planned advancements for odoc.

Discussions

For conversations on ongoing development, be sure to visit theodoc section of the OCaml Discuss forum.

License

odoc is distributed under the terms of the ISC License. See theLICENSE file for complete details.

Acknowledgments

odoc owes its existence to the efforts ofThomas Refis,Leo White, andDavid Sheets. The project was initiated in 2014 and 2015.

We'd also like to extend our appreciation toAnton Bachin andDaniel Bünzli andJon Ludlam for their pivotal contributions to odoc.

Furthermore, we express our gratitude toJane Street andTarides, whose funding has been critical to support the ongoing development of odoc.

1. camlp-streams
2. result
3. astring
4. ocaml>= "4.02.0" & < "5.4"
5. dune>= "3.7"

1. sexplib0with-test
2. ocaml< "4.04.1" & with-test
3. ppx_expectwith-test

1. odoc= "2.4.4"

None