This patch addresses the following issues with .TH macro usage:
.TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhverion%]
1) "MH.6.8" is no longer relevant.
2) %nmhdate% is a hardwired value that only gets updated along with
%nmhversion% and is therefore redundant.
This patch nukes the MH.6.8 tag, and replaces the hardwired
%nmhdate% field with the latest date the associated manpage has
been updated. I pulled the dates - as best I could - from the
git logs.
Going forward, it is incumbent on developers to update the
manpage date stamps as they update the pages themselves.
59 files changed:
nmh manpages should be in this general form:
nmh manpages should be in this general form:
-.TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH COMP %manext1% "DATE" "%nmhversion%"
----------------------------------------
+---------------------------------------------------------------------
+
+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
+
+ January 2, 1904
+
+not the unparseable
+
+ 01/02/04
+
+
+Don't include a CONTEXT section if contexts don't directly apply to what the
+manpage describes.
+
+
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.
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.
+The BUGS section goes last.
+
+
Source files
There should be no ".so" commands to source an external file,
Source files
There should be no ".so" commands to source an external file,
-.TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH ALI %manext1% "January 1, 2001" "%nmhversion%"
-.TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH ANNO %manext1% "December 7, 2005" "%nmhversion%"
-.TH AP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH AP %manext8% "March 6, 2012" "%nmhversion%"
-.TH BURST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH BURST %manext1% "January 1, 2001" "%nmhversion%"
-.TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH COMP %manext1% "May 21, 2012" "%nmhversion%"
-.TH CONFLICT %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH CONFLICT %manext8% "June 24, 2012" "%nmhversion%"
-.TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH DIST %manext1% "June 18, 2012" "%nmhversion%"
-.TH DP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH DP %manext8% "March 6, 2012" "%nmhversion%"
-.TH FLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH FLIST %manext1% "January 1, 2001" "%nmhversion%"
-.TH FMTDUMP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH FMTDUMP %manext8% "January 1, 2001" "%nmhversion%"
-.TH FOLDER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH FOLDER %manext1% "January 1, 2001" "%nmhversion%"
-.TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH FORW %manext1% "February 28, 2012" "%nmhversion%"
-.TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] XXX
+.TH INC %manext1% "July 1, 2012" "%nmhversion%"
-.TH INSTALL-MH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH INSTALL-MH %manext1% "June 10, 2012" "%nmhversion%"
-.TH MARK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MARK %manext1% "February 11, 2012" "%nmhversion%"
-.TH MH-ALIAS %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-ALIAS %manext5% "Oct 14, 2012" "%nmhversion%"
#
# Generates mh-chart.man from other .man files that have a SYNOPSIS
# section.
nmhmandir=`dirname $0`
#
# Generates mh-chart.man from other .man files that have a SYNOPSIS
# section.
nmhmandir=`dirname $0`
-cat <<'EOF'
-.TH MH-CHART %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
+# The following ensures the generated date field in the manpage is divorced
+# from the local build environment when building distribution packages.
+export LC_TIME=C
+unset LANG
+datestamp=`date '+%B %d, %Y'`
+
+cat <<__HOOPY_FROOD
+.TH MH-CHART %manext7% "${datestamp}" "%nmhversion%"
mh-chart \- Chart of nmh Commands
.SH SYNOPSIS
.na
mh-chart \- Chart of nmh Commands
.SH SYNOPSIS
.na
for i in $nmhmandir/*.man; do
case $i in
for i in $nmhmandir/*.man; do
case $i in
-.TH MH-DRAFT %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-DRAFT %manext5% "January 2, 2001" "%nmhversion%"
-.TH MH-FORMAT %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-FORMAT %manext5% "March 24, 2012" "%nmhversion%"
-.TH MH-MAIL %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-MAIL %manext5% "July 9, 2012" "%nmhversion%"
-.TH MH-PROFILE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-PROFILE %manext5% "October 15, 2012" "%nmhversion%"
-.TH MH-SEQUENCE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-SEQUENCE %manext5% "January 9, 2001" "%nmhversion%"
-.TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-TAILOR %manext5% "July 11, 2012" "%nmhversion%"
-.TH MHBUILD %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHBUILD %manext1% "May 31, 2012" "%nmhversion%"
-.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHL %manext1% "January 31, 2012" "%nmhversion%"
-.TH MHLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHLIST %manext1% "January 9, 2001" "%nmhversion%"
-.TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHMAIL %manext1% "October 16, 2012" "%nmhversion%"
-.TH MHN %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHN %manext1% "January 9, 2001" "%nmhversion%"
-.TH MHPARAM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHPARAM %manext1% "June 14, 2012" "%nmhversion%"
-.TH MHPATH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHPATH %manext1% "February 18, 2012" "%nmhversion%"
-.TH MHSHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHSHOW %manext1% "April 30, 2012" "%nmhversion%"
-.TH MHSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MHSTORE %manext1% "September 15, 2012" "%nmhversion%"
-.TH MSGCHK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MSGCHK %manext1% "January 27, 2012" "%nmhversion%"
-.TH MSH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MSH %manext1% "January 8, 2012" "%nmhversion%"
-.TH NEW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH NEW %manext1% "January 17, 2009" "%nmhversion%"
-.TH NEXT %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH NEXT %manext1% "January 9, 2001" "%nmhversion%"
-.TH NMH %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH NMH %manext7% "September 11, 2012" "%nmhversion%"
-.TH PACKF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH PACKF %manext1% "January 8, 2012" "%nmhversion%"
-.TH PICK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH PICK %manext1% "March 6, 2012" "%nmhversion%"
-.TH POST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH POST %manext8% "July 21, 2012" "%nmhversion%"
-.TH PREV %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH PREV %manext1% "January 9, 2001" "%nmhversion%"
-.TH PROMPTER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH PROMPTER %manext1% "January 18, 2001" "%nmhversion%"
-.TH RCVDIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RCVDIST %manext1% "January 18, 2001" "%nmhversion%"
-.TH RCVPACK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RCVPACK %manext1% "January 18, 2001" "%nmhversion%"
-.TH RCVSTORE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RCVSTORE %manext1% "January 18, 2001" "%nmhversion%"
-.TH RCVTTY %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RCVTTY %manext1% "January 18, 2001" "%nmhversion%"
-.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH REFILE %manext1% "January 18, 2001" "%nmhversion%"
-.TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH REPL %manext1% "July 1, 2012" "%nmhversion%"
-.TH RMF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RMF %manext1% "January 18, 2001" "%nmhversion%"
-.TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH RMM %manext1% "November 9, 2010" "%nmhversion%"
-.TH SCAN %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SCAN %manext1% "March 6, 2012" "%nmhversion%"
-.TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SEND %manext1% "September 11, 2012" "%nmhversion%"
.SH NAME
send \- send a message
.SH SYNOPSIS
.SH NAME
send \- send a message
.SH SYNOPSIS
-.TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SENDFILES %manext1% "October 16, 2012" "%nmhversion%"
-.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SHOW %manext1% "June 6, 2012" "%nmhversion%"
-.TH SLOCAL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SLOCAL %manext1% "January 16, 2006" "%nmhversion%"
-.TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SORTM %manext1% "October 11, 2012" "%nmhversion%"
-.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH WHATNOW %manext1% "%nmhdate%" "%nmhversion%"
-.TH WHOM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH WHOM %manext1% "July 11, 2012" "%nmhversion%"