From obrien@NUXI.com Tue Dec  7 21:58:46 1999
Return-Path: <obrien@NUXI.com>
Received: from relay.nuxi.com (nuxi.cs.ucdavis.edu [169.237.7.38])
	by hub.freebsd.org (Postfix) with ESMTP id 3F56A154C8
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  7 Dec 1999 21:58:46 -0800 (PST)
	(envelope-from obrien@NUXI.com)
Received: from dragon.nuxi.com (root@d60-025.leach.ucdavis.edu [169.237.60.25])
	by relay.nuxi.com (8.9.3/8.9.3) with ESMTP id VAA46731
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 7 Dec 1999 21:58:45 -0800 (PST)
	(envelope-from obrien@dragon.nuxi.com)
Received: (from obrien@localhost)
	by dragon.nuxi.com (8.9.3/8.9.1) id VAA63883;
	Tue, 7 Dec 1999 21:58:45 -0800 (PST)
	(envelope-from obrien)
Message-Id: <199912080558.VAA63883@dragon.nuxi.com>
Date: Tue, 7 Dec 1999 21:58:45 -0800 (PST)
From: obrien@freebsd.org
Sender: obrien@NUXI.com
Reply-To: obrien@freebsd.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: manpage section inconsistancy
X-Send-Pr-Version: 3.2

>Number:         15352
>Category:       docs
>Synopsis:       manpage section inconsistancy
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    mpp
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec  7 22:00:01 PST 1999
>Closed-Date:    Wed Dec 8 14:15:25 PST 1999
>Last-Modified:  Wed Dec  8 14:17:45 PST 1999
>Originator:     David O'Brien
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
The FreeBSD Project
>Environment:

	

>Description:

	What's the definitive source for manpage sections?
	mdoc(7), or /usr/share/examples/mdoc/example.?

	For instance example.4 has BUGS below AUTHOR, but mdoc(7) in "Page
	Layout Macros" says the opposite.

>How-To-Repeat:

	

>Fix:

	Please review /usr/share/examples/mdoc/example.? and mdoc(7)
	and resolve the conflicts.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->mpp 
Responsible-Changed-By: mpp 
Responsible-Changed-When: Wed Dec 8 13:10:32 PST 1999 
Responsible-Changed-Why:  
I had already started looking into this after some private 
e-mail from David.  Sorry for how long it has been taking me :-( 
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Wed Dec 8 14:15:25 PST 1999 
State-Changed-Why:  
examples/mdoc and the mdoc man pages have been updated to 
all be consistent with each other.  They now document 
the preferred ordering of man page sections. 

Existing man page should be left alone, unless other 
major renovations are being done to the man pages, 
and the section ordering is only a small part of the change. 
>Unformatted:
