From: Lyndon Nerenberg Date: Sun, 21 Oct 2012 19:33:21 +0000 (-0700) Subject: Merge branch 'master' of ssh://git.sv.gnu.org/srv/git/nmh X-Git-Url: http://git.marmaro.de/?a=commitdiff_plain;h=6e04c69fadd2c8534aa28ca7d115e7bbedbf1608;hp=cbaaccc109298129f33411909d68e772d138bb1b;p=mmh Merge branch 'master' of ssh://git.sv.gnu.org/srv/git/nmh --- diff --git a/docs/README.manpages b/docs/README.manpages index ce9ac26..806e3c7 100644 --- a/docs/README.manpages +++ b/docs/README.manpages @@ -52,11 +52,10 @@ None .SH BUGS 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 in English prose: Month Day, Year +Spell out the date (no abbreviations or shortcuts): January 2, 1904 @@ -64,9 +63,7 @@ not the unparseable 01/02/04 - -Don't include a CONTEXT section if contexts don't directly apply to what the -manpage describes. +Don't abbreviate the month. In the FILES section, prefer the default .TP indent. The pathnames are @@ -74,9 +71,6 @@ variable and long, so any indentation value that works for you won't work for someone else. -The BUGS section goes last. - - Source files There should be no ".so" commands to source an external file, @@ -203,3 +197,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.