Re: Template for GNOME man pages.

[Jeff Waugh <jdub perkypants org>]

<quote who="Pat Costello"/>

> Yes, basically, man pages are a requirement for executables, to give a
> list of options, eegees, exceptions, cop-outs, and come-ons. Well, maybe
> not the latter.  But in general, the sort of stuff that goes into a man
> page would be too nitty-gritty for standard user documentation.

As an aside, for everyone else's benefit, Sun has a long-standing reputation
for crackerjack man pages. They're really, really good. Stuff like pointing
to configuration files, other related files (like logs, locks, etc)... Like
Pat says, the nitty gritty. Admins feel very comfortable having this stuff
to hand. :-)

- Jeff

-- 
  "If you want to start a debate on a subject, however, all that seems to   
     be necessary is to involve perennial target Richard Gooch." - LWN