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