From owner-freebsd-doc Wed Dec 8 15: 6:30 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mppsystems.com (dslmpp.pro-ns.net [208.210.148.205]) by hub.freebsd.org (Postfix) with ESMTP id 97A881524E for ; Wed, 8 Dec 1999 15:06:24 -0800 (PST) (envelope-from mpp@mppsystems.com) Received: (from mpp@localhost) by mppsystems.com (8.9.3/8.9.3) id QAA16319; Wed, 8 Dec 1999 16:28:35 -0600 (CST) (envelope-from mpp) Date: Wed, 8 Dec 1999 16:28:35 -0600 From: Mike Pritchard To: Alexey Zelkin Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/15353: manpage section missing from examples Message-ID: <19991208162835.B16225@mppsystems.com> References: <199912080930.BAA55744@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre3i In-Reply-To: <199912080930.BAA55744@freefall.freebsd.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Dec 08, 1999 at 01:30:03AM -0800, Alexey Zelkin wrote: > > >Synopsis: manpage section missing from examples > > >Description: > > > > Some manpages like ls.1 have a "COMPATIBILITY" section. > > Where is the proper location for it? > > ls.1 has it above "SEE ALSO". I would have guessed it should be > > before or after "STANDARDS". > > > > > >Fix: > > > > Please add "COMPATIBILITY" to /usr/share/examples/mdoc/example.? and > > doc(7). > > Quick look shown that we have about 200 nonstandalone (not listed in mdoc(7)) > sections headers. It's impossible to add all of them to mdoc(7). I not > sure that it's good idea. I added COMPATIBILITY, since it is used in a number of man pages. A large number of the references are from the original 4.4BSD-Lite import. I also added IMPLEMENTATION NOTES, since it was already somewhat documented by mdoc.samples(7). As for the other section headers, mdoc does state that other non-standard section headers may be added at the authors descretion. I would like to point out that while that is true, efforts should be made to work within the framework of the standard section headers. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message