User: Password:
|
|
Subscribe / Log in / New account

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

I'm not sure about that... I loathed info even before I really knew much about Archie or the WWW. It had some serious issues:

- 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.


(Log in to post comments)

man pages

Posted Sep 6, 2008 23:48 UTC (Sat) by nix (subscriber, #2304) [Link]

info will instantly tell you if keywords are in the documentation. "i
KEYWORD" if there's an index (info documents have keyword indexes), "s
KEYWORD" otherwise.

Most people's complaints about info boil down to "I don't know its
keybindings". This one does too.

(What I really dislike is the way the info format ditches all the nice
layout and formatting in the source texinfo documents.)


Copyright © 2017, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds