%%VERSION%%
odig is a command line tool to lookup documentation of installed OCaml
packages. It shows package metadata, readmes, change logs, licenses,
cross-referenced odoc API documentation and manuals.
odig is distributed under the ISC license. The theme fonts have their own licenses.
Homepage: https://erratique.ch/software/odig
odig can be installed with opam:
opam install ocaml-manual odig
If you don't use opam consult the opam file for build
instructions.
A few commands to get you started:
odig doc # Show API docs and manuals of installed packages
odig readme odig # Consult the readme of odig
odig changes odig # Consult the changelog of odig
odig browse issues odig # Browse odig's issues.
The manual and packaging conventions can be consulted online or
via odig doc odig.
A sample output of generated API documentation and manuals on a best-effort maximal set of packages of the OCaml opam repository is available here.
The Vg module and its sub-modules is a good example to look at, it has a good mix of documentation cases.
The different themes distributed with odig can be seen on the sample
at the following addresses.
- https://b0-system.github.io/odig/doc/
- https://b0-system.github.io/odig/doc@odig.default/
- https://b0-system.github.io/odig/doc@odig.dark/
- https://b0-system.github.io/odig/doc@odig.light/
- https://b0-system.github.io/odig/doc@odig.gruvbox/
- https://b0-system.github.io/odig/doc@odig.gruvbox.dark/
- https://b0-system.github.io/odig/doc@odig.gruvbox.light/
- https://b0-system.github.io/odig/doc@odig.solarized/
- https://b0-system.github.io/odig/doc@odig.solarized.dark/
- https://b0-system.github.io/odig/doc@odig.solarized.light/
- https://b0-system.github.io/odig/doc@odoc.default/
Note that for technical reasons the OCaml manual under these addresses
is always themed according to odig.default. This is not what happens
if you use odig for yourself, the manual will render according to
your theme's color scheme.