[TUHS] man-page style

[arnold at skeeve.com]

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.

Indeed, the latter was the point of the famed 2nd volume of the Unix
programmer's manual.  The shame is that it was not propogated into
most of the Unix descendants as the man pages were.

Arnold