2 ms·
Manpages outweigh info mindshare by a huge margin. And for most programs, a manpage is more than enough. But when your application is large enough to require a
by goku12 3y ago
Manpages outweigh info mindshare by a huge margin. And for most programs, a manpage is more than enough. But when your application is large enough to require a manual the size of a book, manpages simply aren't enough. It's too hard to arrange them properly or to search them up. A good example is git. Your system probably has the best and most comprehensive git material sitting in it as manpages. But even seasoned git users may not know about it.
Info pages shine when it comes to material like this. It feels exactly like a book. If you're comfortable with the terminal, you get the advantage of Gnu's multipage online manuals locally on the terminal. It may feel hard to navigate - but it takes hardly an hour to learn the basic navigation, whether that be in Emacs, info or pinfo.
PS: Coincidentally, I was looking for a way to document my own program before release. I was looking at both formats, or perhaps choose something that can be converted into man, info and html. I'm open to any suggestion.