[TUHS] man-page style

Dave Horsfall dave at horsfall.org
Fri Nov 16 15:32:37 AEST 2018

On Thu, 15 Nov 2018, Larry McVoy wrote:

> How good is good enough: documentation
>    Looking at Sun man pages versus Linux man pages is like looking at a Van
>    Gogh or Monet after studying the work of the high school football player
>    taking art as an "easy" elective.
> Amy Graf, BitMover

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.

-- Dave

More information about the TUHS mailing list