===================================================================
RCS file: /cvs/mandoc/Attic/mdoc.template,v
retrieving revision 1.1
retrieving revision 1.8
diff -u -p -r1.1 -r1.8
--- mandoc/Attic/mdoc.template	2009/06/11 13:13:44	1.1
+++ mandoc/Attic/mdoc.template	2010/08/28 22:08:38	1.8
@@ -2,37 +2,41 @@
 .\"
 .\" Copyright notice goes here.
 .\"
-.\" The uncommented requests are required for all man pages.
+.\" The uncommented requests are required for all manual pages.
 .\" The commented requests should be uncommented and used where appropriate.
 .\"
 .\" See mdoc(7) for further reference.
 .\"
 .Dd $\&Mdocdate$
-.Dt DOCUMENT_TITLE SECTION
+.Dt title section
 .Os
 .Sh NAME
-.\" The next request should be used for sections 2 and 3 only.
+.Nm name
+.Nd short description
 .\" .Sh LIBRARY
+.\" For sections 2, 3, & 9 only.
+.\" Not used in OpenBSD.
 .Sh SYNOPSIS
 .Sh DESCRIPTION
-.\" This next request is for sections 1 and 8 exit statuses only.
-.\" .Sh EXIT STATUS
-.\" This next request is for sections 2 and 3 function return values only.
+.\" .Sh IMPLEMENTATION NOTES
 .\" .Sh RETURN VALUES
-.\" This next request is for sections 1, 6, 7 & 8 only.
+.\" For sections 2, 3, & 9 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, 6, 7 & 8 only
 .\" .Sh DIAGNOSTICS
-.\" The next request is for sections 2 and 3 error and signal handling only.
+.\" For sections 1, 4, 6, 7, & 8 only
 .\" .Sh ERRORS
+.\" For sections 2, 3, & 9 only.
 .\" .Sh SEE ALSO
-.\" Cross-references should be ordered by section (low to high), then in
-.\"     alphabetical order.
+.\" .Xr foobar 1
 .\" .Sh STANDARDS
 .\" .Sh HISTORY
 .\" .Sh AUTHORS
 .\" .Sh CAVEATS
 .\" .Sh BUGS
 .\" .Sh SECURITY CONSIDERATIONS
+.\" Not used in OpenBSD.