Subject: Re: Writing Man Pages with *roff
To: None <jeremy@broder.com>
From: Mike Long <mike.long@analog.com>
List: tech-kern
Date: 03/03/1997 17:49:33
>Date: Mon, 3 Mar 1997 14:15:19 -0800 (PST)
>From: Jeremy Cooper <jeremy@broder.com>

>I learned the roff format from Kernigan & Pike's "The UNIX Programming
>Environment", chapter 9 "Document Preparation".  I really suggest you
>check it out.  Even though we have quite a few more macros since the book
>was published in 1984, it is an immensely helpful good start.  Yes, you
>are correct in that most macros are delimited by newlines, and are hence
>'one per line'.

That chapter is a good introduction, but note that it uses the
old-style -man macros.  New manpages should use the 4.4BSD -mdoc
macros (see mdoc(7) and mdoc.samples(7)) instead.
-- 
Mike Long <mike.long@analog.com>     <URL:http://www.shore.net/~mikel>
VLSI Design Engineer         finger mikel@shore.net for PGP public key
Analog Devices, CPD Division          CCBF225E7D3F7ECB2C8F7ABB15D9BE7B
Norwood, MA 02062 USA       (eq (opinion 'ADI) (opinion 'mike)) -> nil