Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Linux man pages are notoriously verbose, and often obtuse and incomplete, this is in great part due to the extra complexity of GNU tools and their preference for the infamous info documentation system.

OpenBSD has probably the best Unix manual pages:

http://www.openbsd.org/cgi-bin/man.cgi?query=ed

And Plan 9 has a manual that is a pleasure to read, this is helped in part because the commands themselves have been cleaned up and simplified in many cases:

http://man.cat-v.org/p9p/1/ed



I think instead of `verbose' you meant the opposite `terse.'


They're either the output of --help turned into -man macros or more noise than signal. Damn info!


I dream of a system with features such as iPython live doc, or Bret Victor's tangle. It seems an approachable goal nowadays.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: