`man' is awful when there is more than a few "pages" to scroll through and you can't easily skip stuff because it is an all or nothing endless scroll of text.
It is great for references, but not for reading in a non-linear way. They are called "manpages" after all, not "mantomes" :-P.
Texinfo and similar are much better for this and the info format is fine as a text-based format (or with some minimal image use but not all viewers support those).
The problem is that the default `info' viewer feels weird to most people, but there are alternatives like `pinfo' (which IIRC uses lynx-like keys) and `tkinfo' (a GUI-based viewer written in Tcl and Tk). IIRC KDE's help viewer can also view info documents.
Texinfo and info is also nice with its index functionality and how it supports multiple indices. In a way info is kinda like CHM (but with optionally multiple indices) and Texinfo is the official way to make info documents.
It is great for references, but not for reading in a non-linear way. They are called "manpages" after all, not "mantomes" :-P.
Texinfo and similar are much better for this and the info format is fine as a text-based format (or with some minimal image use but not all viewers support those).
The problem is that the default `info' viewer feels weird to most people, but there are alternatives like `pinfo' (which IIRC uses lynx-like keys) and `tkinfo' (a GUI-based viewer written in Tcl and Tk). IIRC KDE's help viewer can also view info documents.
Texinfo and info is also nice with its index functionality and how it supports multiple indices. In a way info is kinda like CHM (but with optionally multiple indices) and Texinfo is the official way to make info documents.