From mboxrd@z Thu Jan 1 00:00:00 1970 From: jon@fourwinds.com (Jon Steinhart) Date: Wed, 20 Sep 2017 11:35:19 -0700 Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation In-Reply-To: References: <201709191701.v8JH1vck032168@darkstar.fourwinds.com> Message-ID: <201709201835.v8KIZJth016318@darkstar.fourwinds.com> Another point that has been hinted at on the man page discussion. A concept that seemed to get lost at the FSF is that man pages are summaries. They're not exhaustive. While a man page is all that's needed for something simple like "ls", I expect there to be well written documents for more complex programs. For example, I do not expect a complete description of yacc on the man page; that belongs in a separate document. I still have notebooks with the printed versions of the old docs around. The man page problem is also exacerbated by the bloatage that afflicts the FSF versions of many formerly simple utilities. Huge numbers of dash options plague many utilities that in my opinion should be broken up into separate simpler programs. Not to mention that by adding so many options they felt the need for long options, and now one has to deal with two options for some but not all things. Making things worse, some man pages are just not written with the user in mind. The one that constantly annoys me is bash. There's around 450 lines of gunk about shell variables near the front which I always have to skip past because I forgot the syntax of some parameter expansion. I hardly ever care about the shell variables, and I don't think that I'm alone. Jon