From mboxrd@z Thu Jan 1 00:00:00 1970 From: gtaylor@tnetconsulting.net (Grant Taylor) Date: Tue, 19 Sep 2017 22:26:30 -0600 Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation In-Reply-To: <20170920010206.GZ25650@mcvoy.com> References: <201709191701.v8JH1vck032168@darkstar.fourwinds.com> <20170919233525.k3otv5as6xi2rqht@thunk.org> <91641FC6-4CF5-4682-B8C3-8BB3DCCB208C@orthanc.ca> <20170920010206.GZ25650@mcvoy.com> Message-ID: <67952143-4adb-2c51-1874-d34825e92171@tnetconsulting.net> On 09/19/2017 07:02 PM, Larry McVoy wrote: > +1. Man pages should be short things that remind you how to run the program. > Putting a user guide in man pages is nuts, and in today's world texinfo is > just as nuts. Put it on the web and move on. But don't give me the see > texinfo man page, I hate that crap. I have long told people trying to learn unix "Most people don't learn from man pages. Man pages are great reference after you know (some of) ." I typically refer someone to online tutorials or start an in person / email discussion with them about what they are trying to learn. Usually I try to tailor it to and / or reference things that I'm aware they are familiar with. -- Grant. . . . unix || die