From owner-freebsd-doc Tue Dec 7 23:30:15 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mta4.rcsntx.swbell.net (mta4.rcsntx.swbell.net [151.164.30.28]) by hub.freebsd.org (Postfix) with ESMTP id 8A5D514D12 for ; Tue, 7 Dec 1999 23:30:12 -0800 (PST) (envelope-from chris@holly.calldei.com) Received: from holly.calldei.com ([216.62.157.60]) by mta4.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.1999.09.16.21.57.p8) with ESMTP id <0FME0002OVA0MC@mta4.rcsntx.swbell.net> for doc@FreeBSD.org; Wed, 8 Dec 1999 01:30:10 -0600 (CST) Received: (from chris@localhost) by holly.dyndns.org (8.9.3/8.9.3) id AAA18863 for doc@FreeBSD.org; Wed, 08 Dec 1999 00:10:21 -0600 (CST envelope-from chris) X-URL: http://www.FreeBSD.org/~chris/ Date: Wed, 08 Dec 1999 00:10:20 -0600 From: Chris Costello Subject: mdoc(7) vs. example.? vs. real man pages To: doc@FreeBSD.org Reply-To: chris@calldei.com Message-id: <19991208001020.D976@holly.calldei.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.4i X-Operating-System: FreeBSD 4.0-CURRENT (i386) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org As you may just have seen from a recent problem report, David O'Brien brought up the issue of inconsistant documentation. So here's the deal. There are several different disagreeing ideas here: - Real manual pages. Take a look at chmod(1). It's got the BUGS listing above SEE ALSO. Compare with mdoc(7) and example.1 in /usr/share/examples/mdoc - /usr/share/examples/mdoc/example.?. These conflict with mdoc(7) in the way of ordering sections. BUGS here are at the very bottom. How are we going to deal with this? I propose (due to preference) that mdoc(7) be updated to reflect the type of layout that's in the example manual pages. Can anybody give feedback so we can reach a conclusion and make everything consistent? -- |Chris Costello |User: A harmless drudge. `---------------------------------- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message