Message-Id: <199907261351.IAA03490@darwin.sfbr.org>
Date: Mon, 26 Jul 1999 08:51:03 -0500 (CDT)
From: Jeff Williams <jeffw AT darwin DOT sfbr DOT org>
Subject: man page style guide
To: djgpp AT delorie DOT com
MIME-Version: 1.0
Content-Type: TEXT/plain; charset=US-ASCII
Content-MD5: SnY1qRgqsyHu0cKhHG3alg==
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.3.4 SunOS 5.7 sun4u sparc 
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from QUOTED-PRINTABLE to 8bit by delorie.com id KAA13209
Reply-To: djgpp AT delorie DOT com

Hi,

I would like to document, using the man-page format, some utility and
analysis programs I have written using djgpp.  Maybe man pages are
becoming obsolete, and maybe not, but:

[1] I actually *like* man-pages more than info pages [:-/

[2] The programs don't require a lot of documentation, and certainly
    their docs won't need the sophistication of hot links, etc.

I can glean the general man-page format by studying my Solaris man pages,
but does anyone know if there exists an official (FSF, GNU, POSIX...?)
`style-guide' for writing man pages?

TIA--jtw