[ANN] Odig 0.0.4

announce

#1

Hello,

It’s my pleasure to announce a new release of odig.

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.

To browse the documentation of your opam switch’s packages simply
proceed with:

opam install ocaml-manual odig 
odig doc 

An odig manual and the packaging conventions can be consulted via:

odig doc odig # or see https://b0-system.github.io/odig/doc/odig 

A sample output on a best-effort maximal set of packages of the
opam repository can be found here:

https://b0-system.github.io/odig/doc/

The highlights of this release are:

  • Support for the latest odoc (includes navigation improvements).

  • Support for mld manuals and package landing page customization.
    See for example: https://b0-system.github.io/odig/doc/odig

  • Support for API documentation themes. The default odoc theme
    and light and dark themes optimized for legibility are bundled
    with odig; and you can bring your own via opam packages. The
    odig default themes can be spotted online by following the
    links here:
    https://github.com/b0-system/odig#sample-odoc-api-documentation-and-manuals

  • Support for OCaml manual theming when the ocaml-manual
    package is installed. Provides a best-effort (for better
    results a closer rework of the manual HTML gen would be needed)
    seamless style transition between API docs and the OCaml
    manual. For example follow the link to the manual on:
    https://b0-system.github.io/odig/doc/

The release notes have all the details, especially removals details from 0.0.3:

https://github.com/b0-system/odig/blob/v0.0.4/CHANGES.md

Most of this is brought to you thanks to support added in odoc
by Thomas Refis and Rizo Isrof. Thanks also to Thomas Refis for
helping with odoc driving details, with odoc bug chasing and
discussions.

Homepage: http://erratique.ch/software/odig

Best & happy documentation reading,

Daniel