[plug] Writing 'man' pages

[Cameron Patrick]

On Mon, Dec 08, 2003 at 03:55:49PM +0800, James Devenish wrote:
| In message <200312081541.43476.derekfountain at yahoo.co.uk>
| on Mon, Dec 08, 2003 at 03:41:43PM +0800, Derek Fountain wrote:
| > Is there a simple way to create 'man' pages these days? I mean without having 
| > to learn tex or docbook or some other horribly complicated page formatting 
| > program? I've never needed to write one before and don't know the 'native' 
| > format. I was kind of hoping for a nice utility to reformat a simple bit of 
| > text. I found pod2man - is there anything else?
| 
| Don't know about Linux, but under some OSes, the mandoc roff macros are
| very well described

Under Debian, at least, try
	$ man 7 man
and
	$ man 7 groff_man

Disclaimer: I've never written a man page and have no idea how useful
those pages actually are.

Cameron.