man pages
man pages
Posted Sep 6, 2008 23:28 UTC (Sat) by bronson (subscriber, #4806)In reply to: man pages by giraffedata
Parent article: Feature removal sparks Git flamewar
- It's manually laborious. With manpages, when you see an unrecognized keyword in a Bash script: 'man bash' /REPLY. Turnaround time two seconds. With info, you spend minutes clicking forward and back through a hierarchical structure of pages never knowing if you're hunting in the right place or not. The manpage will tell you instantly if the keyword is in the man documentation, info won't really.
- Info documentation tends to contain a lot more philosophical junk and background info that you need to sift through. I'm all for documenting that stuff, just make sure the reference docs come first!
- If you quit the info reader, it took a lot of effort to find your way back to where you were. With manpages, just '334G'.
- The original info reader was quite user-hostile. At least pinfo came along later.
So, I completely agree that manpages are really showing their age and that we need a better system. The system should be optimized for reference documentation though, not the lean-back, chopped up docs that Info, Gopher, Archie, and the WWW are built for.
