Re:Simplified and community-driven man pages
by microcolonel on Sunday November 26, 2017 @04:19AM
(#15780128)
For what it's worth, find is truly awful, and tar is just a bit unconventional in terms of option parsing. These are stand-out failures of interface design, for which no documentation would be sufficient for all but the most regular of users.
Re:Simplified and community-driven man pages
by mjw1007 on Sunday November 26, 2017 @05:55AM
(#15780334)
Note that the commonly-used GNU implementations of tar and find both have info documentation which is much better than the manpages.
Re:Simplified and community-driven man pages
by minusf on Sunday November 26, 2017 @06:11AM
(#15780373)
dash is web documentation kept offline with limited search added on top of it. it's basically a browser window...
Re:Simplified and community-driven man pages
by dmitriid on Sunday November 26, 2017 @11:46AM
(#15781669)
Which already makes it orders of magnitudes better than man
Re:Simplified and community-driven man pages
by vthriller on Monday November 27, 2017 @04:54AM
(#15786123)
But why? You already can search through man pages with / key in your $PAGER (more/less/most/vimpager), and across pages with `man -k`/`man -K`, and I wouldn't really call proportional fonts as "orders of magnitude" better.
Edit: the wording was angrier than it needed to be. A concrete example of a better documentation tool : https://kapeli.com/dash