Bug 15352

Summary:	manpage section inconsistancy
Product:	Documentation	Reporter:	David E. O'Brien <obrien>
Component:	Books & Articles	Assignee:	mpp
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description David E. O'Brien freebsd_committer

1999-12-08 06:00:01 UTC

	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.

Fix: 

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

Comment 1 mpp freebsd_committer

1999-12-08 21:10:32 UTC

Responsible Changed
From-To: freebsd-doc->mpp

I had already started looking into this after some private 
e-mail from David.  Sorry for how long it has been taking me :-(

Comment 2 mpp freebsd_committer

1999-12-08 22:15:25 UTC

State Changed
From-To: open->closed

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.