Personally I don’t think manpages can do justice to the highly hyperlinked and cross referenced docsets the ocamldoc language produces. As a documentation author I find it a bit annoying that all my work (and the
odoc dev’s hard linking work) gets destroyed by using such a poor documentation medium.
I’m wondering whether you considered using a text mode browser (.e.g emacs’
w3m, etc.). For example:
BROWSER=w3m odig doc odig
Last time I checked
odoc generated docsets worked quite well with it (and we should improve
odoc generation if they don’t, because it likely also improves accessibility) and provided in my opinion a far better experience that a manpage could.
That being said if you really think the above is not satisfactory, it costs nothing to open an issue on
odig. I won’t prioritize it but I might consider it when I review
odoc's driving (which needs to be modernized to the new odoc ways of working).