this diff does two things (usually a bad sign):

- note which section headings (.Sh) are not used by openbsd
- move the description of the section heading to under the heading, rather
than before it: a much more logical way to read

diffs mailed upstream...

1 files changed, 7 insertions, 5 deletions

diff --git a/share/misc/mdoc.template b/share/misc/mdoc.template
index 05abf74ebc9..f22478a16b6 100644
--- a/share/misc/mdoc.template
+++ b/share/misc/mdoc.template
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mdoc.template,v 1.10 2007/05/31 22:10:19 jmc Exp $
+.\"	$OpenBSD: mdoc.template,v 1.11 2010/08/31 17:51:31 jmc Exp $
 .\"
 .\" The following requests are required for all man pages.
 .\"
@@ -19,16 +19,18 @@ The
 .Nm
 utility processes files ...
 .\" The following requests should be uncommented and used where appropriate.
-.\" This next request is for sections 2, 3, and 9 function return values only.
 .\" .Sh RETURN VALUES
-.\" This next request is for sections 1, 6, 7 & 8 only.
+.\" For sections 2, 3, and 9 function return values only.
 .\" .Sh ENVIRONMENT
+.\" For sections 1, 6, 7 & 8 only.
 .\" .Sh FILES
+.\" .Sh EXIT STATUS
+.\" For sections 1 & 8 only.
 .\" .Sh EXAMPLES
-.\" This next request is for sections 1, 4, 6, and 8 only.
 .\" .Sh DIAGNOSTICS
-.\" The next request is for sections 2, 3, and 9 error and signal handling only.
+.\" For sections 1, 4, 6, 7, and 8 only.
 .\" .Sh ERRORS
+.\" For sections 2, 3, and 9 error and signal handling only.
 .\" .Sh SEE ALSO
 .\" .Xr foobar 1
 .\" .Sh STANDARDS