[groff] 08/08: [ms]: Note different \*[CF] default in nroff mode.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9b27576eeb970ea7e44f878bd0851ead699ac49a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed May 5 02:48:57 2021 +1000

    [ms]: Note different \*[CF] default in nroff mode.
    
    * doc/groff.texi (Differences from AT&T ms):
    * doc/ms.ms (Differences from AT&T ms):
    * tmac/groff_ms.7.man (Differences from AT&T ms): Document our different
      default (empty) for the center footer in nroff mode; this behavior
      appears to date back to June 1991 or earlier, drawing few complaints.
    
    Fixes <https://savannah.gnu.org/bugs/?59826>.
    
    * doc/groff.texi:
    * doc/ms.ms: Bump document date.
---
 ChangeLog           | 11 +++++++++++
 doc/groff.texi      |  9 ++++++++-
 doc/ms.ms           | 28 ++++++++++++++++++++++++++--
 tmac/groff_ms.7.man | 24 ++++++++++++++++++++++++
 4 files changed, 69 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f0283e3..6418207 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/groff.texi (Differences from AT&T ms):
+       * doc/ms.ms (Differences from AT&T ms):
+       * tmac/groff_ms.7.man (Differences from AT&T ms): Document our
+       different default (empty) for the center footer in nroff mode;
+       this behavior appears to date back to June 1991 or earlier,
+       drawing few complaints.
+
+       Fixes <https://savannah.gnu.org/bugs/?59826>.
+
 2021-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/tests/*: Rename files to use consistent scheme; one
diff --git a/doc/groff.texi b/doc/groff.texi
index 3686787..3ecc555 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -432,7 +432,7 @@ developing GNU and promoting software freedom.''
 @title groff
 @subtitle The GNU implementation of @code{troff}
 @subtitle Edition 1.23.0
-@subtitle April 2021
+@subtitle May 2021
 @author by Trent A.@tie{}Fisher
 @author and Werner Lemberg
 
@@ -4189,6 +4189,13 @@ Multiple line spacing is not supported.  Use a larger 
vertical spacing
 instead.
 
 @item
+@code{groff} @file{ms} uses the same header and footer defaults in both
+@code{nroff} and @code{troff} modes as @acronym{AT&T} @file{ms} does in
+@code{troff} mode; @acronym{AT&T}'s default in @code{nroff} mode is to
+put the date, in U.S.@: traditional format (e.g., ``January 1, 2021''),
+in the center footer (the @code{CF} string).
+
+@item
 The @acronym{AT&T} @file{ms} manual describes @code{CW} and @code{GW}
 registers that can be used to control the column width and gutter width,
 respectively.  These registers are not used in @code{groff} @file{ms}.
diff --git a/doc/ms.ms b/doc/ms.ms
index 8199d66..0198e84 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -20,8 +20,8 @@
 .nr VS 13
 .ie t .nr PI 3.5n
 .el   .nr PI 4n
-.ND March 2021
-.EH '%''March 2021'
+.ND May 2021
+.EH '%''May 2021'
 .EF ''''
 .OH 'Using \f[I]groff\f[] with the \f[I]ms\f[] macros''%'
 .OF ''''
@@ -2450,6 +2450,30 @@ manual [Lesk 1978].
 .
 .PP
 .I "groff ms"
+uses the same header and footer defaults in both
+.CW nroff
+and
+.CW troff
+modes
+as AT&T
+.I ms
+does in
+.CW troff
+mode;
+AT&T's default in
+.CW nroff
+mode is to put the date,
+in U.S.\& traditional format
+(e.g.,
+\[lq]January 1, 2021\[rq]),
+in the center footer
+(the
+.CW CF
+string).
+.
+.
+.PP
+.I "groff ms"
 supports the
 .CW PN
 register,
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 3f085d3..dcd22af 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1629,6 +1629,30 @@ Multiple line spacing is not supported
 .
 .
 .IP \[bu]
+.I groff ms
+uses the same header and footer defaults in both
+.B nroff
+and
+.B troff
+modes
+as AT&T
+.I ms
+does in
+.B troff
+mode;
+AT&T's default in
+.B nroff
+mode is to put the date,
+in U.S.\& traditional format
+(e.g.,
+\[lq]January 1, 2021\[rq]),
+in the center footer
+(the
+.B CF
+string).
+.
+.
+.IP \[bu]
 The AT&T
 .I ms
 manual describes