[TUHS] man-page style

Jim Capp jcapp at anteil.com
Sat Nov 17 03:33:15 AEST 2018

>On Fri, Nov 16, 2018 at 11:55:28AM -0500, Paul Winalski wrote: 
>> On 11/16/18, Grant Taylor via TUHS <tuhs at minnie.tuhs.org> wrote: 
>> > On 11/15/2018 10:32 PM, Dave Horsfall wrote: 
>> >> The Unix manpage format is the epitome of perfection; they tell you 
>> >> everything you need to know, and in the right order. Frequently I 
>> >> cannot recall a particular flag (but I know what it does), and it's 
>> >> right there at the start. 
>> > 
>> > I think man pages make a great reference. But I don't think they are a 
>> > good teaching source for someone that doesn't know the material or what 
>> > the components are for. 
>> > 
>> I agree with Grant. If you want to know what a particular command 
>> does and what its options are, man pages are fantastic. If you are a 
>> new or casual user trying to find out what command(s) to use to 
.> accomplish a particular task, the man pages are an exercise in. 
>> frustration and futility. Other OSes have done a better job in that 
>> area (the VMS and DTSS HELP commands come to mind). IMO ideally one 
>> should have both--a generalized "help" command for those trying to 
>> find out what command to use, and "man" as reference material. UNIX 
>> and Linux have never had a proper help facility. Or at least I never 
>> was able to find it. 
>I think there was a help at one point but it got lost. PWB maybe? 
>There is still apropos which can be useful. 
>What helped me starting out was one of those trifold summaries of 
>common commands. 
>ls for directory listings? Very poor choice for newbies but pleasant 
>once you know it is there. Short is nice for common stuff. 
>I just remember a steep learning curve initially. But you got over 
>it pretty quickly and then things were pleasant. I found the Unix 
>docs to be great but hard to figure where things were at first. 
>Once you were past that, smooth sailing. 

PWB was great too, but what was most useful to me was the 
"UNIX programmer's manual" from Bell Telephone Laboratories (c) 1979, 1983 

The first volume included all the man pages, a quick reference, and an index. 

The second volume contained all the "how to" guides, including concise summaries 
of the facilities available on UNIX, the original UNIX paper from Ritchie and Thompson, 
UNIX for Beginners from Kernighan, NROFF/TROFF User's Manual, TROFF Tutorial, 
C Programming Language, Lint, Make, YACC, LEX, AWK, and on and on. 

The combination of those two volumes was invaluable. 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://minnie.tuhs.org/pipermail/tuhs/attachments/20181116/32eb88ff/attachment.html>

More information about the TUHS mailing list