2 ms·
> Advantages of man over "--help": You can have the best both worlds if the manpages are built automatically from the "--help" output (e.g., using help2man).
by enriquto 8y ago
> Advantages of man over "--help":
You can have the best both worlds if the manpages are built automatically from the "--help" output (e.g., using help2man). Then you can have "-h" give a brief rundown and "--help" give the full docs.
> FWIW I think that texinfo is (mostly) even better than man, as it considerably improves on the navigation
I am curious about that. Do you really like texinfo navigation? I find it completely unusable, to the point of prefering to download and print a pdf from the web instead of opening (gasp!) the dreaded "info" program.
- TeMPOraL 8y agoI use info browser from Emacs and like it very much. The best benefit is that you can stuff a whole book into info pages - and projects using info usually drop their full manual in there, to be perused off-line and distraction-free.
- enriquto 8y agoHow do you search for a word inside the whole info documentation of a program (say, gcc), and cycle through all appearances of that word? I never managed to do that (which is trivial for manpages).
- jwilk 8y agoTypographical quality of automatically generated manpages is usually very poor. Also, I expect man pages to be more detailed than --help.