[groff] 01/03: [ms]: Clarify when the date must be declared.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 022e24945d0f4a2bc1a2cd4d81661ac0e9ec5a26
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed May 5 06:12:29 2021 +1000

    [ms]: Clarify when the date must be declared.
    
    Generalize; if someone uses the arguments to DA or ND macros, they'll
    need to call them well before the end of the first page if they also
    redefine one of the header strings to include it.  There are sufficient
    variables here involving use of the header/footer-setting macros, their
    corresponding strings, and the .P1 macro that it's easier just to be
    abstract and trust users to experiment and/or think for themselves.
---
 doc/groff.texi      | 9 +++++----
 doc/ms.ms           | 2 +-
 tmac/groff_ms.7.man | 2 +-
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 3ecc555..383fb56 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2853,10 +2853,11 @@ revision, explicitly identified authors, sponsoring 
institutions for
 authors, and, at the rarefied heights, an abstract of their content.
 Define these data by using the macros below in the order shown;
 @code{DA} or @code{ND} can be called to set the document date (or other
-identifier) at any time before (a) the abstract, if present, or (b) the
-end of the first page.  Use of these macros is optional, except that
-@code{TL} is mandatory if any of @code{RP}, @code{AU}, @code{AI}, or
-@code{AB} is called, and @code{AE} is mandatory if @code{AB} is called.
+identifier) at any time before (a) the abstract, if present, or (b) its
+information is required in a header or footer.  Use of these macros is
+optional, except that @code{TL} is mandatory if any of @code{RP},
+@code{AU}, @code{AI}, or @code{AB} is called, and @code{AE} is mandatory
+if @code{AB} is called.
 
 @Defmac {RP, [@code{no}], ms}
 Use the ``report'' (@acronym{AT&T}: ``released paper'') format for your
diff --git a/doc/ms.ms b/doc/ms.ms
index 0198e84..60a3dc5 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -384,7 +384,7 @@ can be called to set the document date
 (or other identifier)
 at any time before (a) the abstract,
 if present,
-or (b) the end of the first page.
+or (b) its information is required in a header or footer.
 .
 Use of these macros is optional,
 except that
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index dcd22af..f8b37de 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -323,7 +323,7 @@ can be called to set the document date
 (or other identifier)
 at any time before (a) the abstract,
 if present,
-or (b) the end of the first page.
+or (b) its information is required in a header or footer.
 .
 Use of these macros is optional,
 except that