X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=docs%2FREADME.manpages;h=775849832eb21419bb9191d019d1f45c11a12fe5;hb=eba408368603a3afe170ef61a334c3a479ea5a29;hp=8c6516a57dcf8b61373faef6cb6582d887fc9ffd;hpb=84823bbc56258951ea24c1906f9cd6fb42d85c4a;p=mmh

diff --git a/docs/README.manpages b/docs/README.manpages
index 8c6516a..7758498 100644
--- a/docs/README.manpages
+++ b/docs/README.manpages
@@ -2,7 +2,7 @@ NMH MANPAGE STYLE GUIDE
 
 nmh manpages should be in this general form:
 
-.TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH COMP %manext1% "DATE" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -53,6 +53,19 @@ None
 None
 
 ---------------------------------------
+The DATE in the .TH macro should reflect the most recent non-trivial
+update to the content of the manpage; formatting changes don't count.
+Spell out the date (no abbreviations or shortcuts):
+
+  January 2, 1904
+
+not the unparseable
+
+  01/02/04
+
+Don't abbreviate the month.
+
+
 In the FILES section, prefer the default .TP indent. The pathnames are
 variable and long, so any indentation value that works for you won't
 work for someone else.
@@ -96,8 +109,7 @@ Program names
 		.B comp
 		.BR comp ,
 
-	If this is a manpage reference (outside of the SEE ALSO
-	section, which just uses regular text), use:
+	If this is a manpage reference, use:
 
 		.IR mh-draft (5)
 
@@ -184,3 +196,17 @@ Pointer manpages
 		.so man1/folder.1
 
 	Also, add this manpage to the appropriate section in Makefile.in
+	
+
+CONTEXT
+    Don't include a CONTEXT section when contexts are out of context.
+
+
+AUTHOR and HISTORY sections
+
+    These have no place in a manpage.  If you want everlasting glory,
+    try the release notes.
+
+BUGS
+
+    The BUGS section goes last.