Support for reading docs in terminals

[shym]

This is a feature request.
In some contexts, man pages are handier than html pages (for accessibility, for instance).
Could Odig provide a command to build the manpages?

[dbuenzli]

Manpages are ill suited for the highly hyperlinked and cross referenced docs that odig generates¹

However in the next release – which I hope will happen before the end of the year – I plan to add an odig man [MODULE|PKG] command which will directly load the corresponding page in a text mode browser like w3m. Basically a shortcut for:

w3m $(odig doc -f cmdliner)

Footnotes

1. I personally find that generating manpages from the documentation I write is an insult to all the work that goes in producing them. ↩

[jrfondren]

I found this option as soon as I looked for it: odig doc --browser=w3m cmdliner

Terminal docs are very helpful over an ssh session, as well.