[groff] 31/51: groff_man*(7): Tweak documentation of `C` register.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 441021b2104e2782d2ed831375cdd7261aa7b2d2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Sep 7 21:42:42 2022 -0500

    groff_man*(7): Tweak documentation of `C` register.
    
    * tmac/groff_man.7.man.in (Options): Describe register as enabling
      "consecutive" page numbering, rather than "continuous", to try to
      reduce confusion with "continuous rendering".
    
    Also annotate seemingly redundant argument to `bp` request.
---
 tmac/an.tmac            | 12 ++++--------
 tmac/groff_man.7.man.in |  4 ++--
 2 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/tmac/an.tmac b/tmac/an.tmac
index 5e45a1a84..90ccb67fc 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -171,10 +171,10 @@
 .
 .\" Cause a page transition to a new man(7) document.  Clear the page
 .\" header trap so it is not sprung with stale information.  Update the
-.\" page number depending on the C (continuous page numbering) register.
+.\" page number depending on the C (consecutive numbering) register.
 .de an-start-new-document
 .  ch an-header
-.  ie \\n[C] .bp (\\n[%] + 1)
+.  ie \\n[C] .bp (\\n[%] + 1) \" argument NOT redundant before page 1
 .  el        .bp 1
 ..
 .
@@ -1187,22 +1187,18 @@ contains unsupported escape sequence
 .  el   .nr cR 0
 .\}
 .
-.\" continuous page numbering over multiple documents
+.\" consecutive page numbering across multiple documents
 .\"
 .\" We must use consecutive page numbers when using PostScript to
 .\" generate HTML images; we must not reset the page number at the
 .\" beginning of each document (the 'ps4html' register is automatically
 .\" added to the command line by the pre-HTML preprocessor).
-.\"
-.\" \n[C] may get set to 1 redundantly in the below; we could replace
-.\" that with a complex conditional, but it doesn't seem to be worth the
-.\" trouble given restrictions on use of '!', '&', and ':' operators.
 .ie !r C \
 .  nr C 0
 .el \
 .  if !\n[C] \
 .    if \n[an-is-output-html] \{\
-.       tm \*[an]: ignoring continuous page numbering in HTML output
+.       tm \*[an]: consecutive page numbering required for HTML output
 .       nr C 1
 .    \}
 .if \n[an-is-output-html] \
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 7661359f0..d572c4056 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3236,9 +3236,9 @@ to disable it.
 .
 .TP
 .B \-rC1
-Number output pages continuously,
+Number output pages consecutively,
 in strictly increasing sequence,
-rather than resetting the page number to\~1 at each new
+rather than resetting the page number to\~1 with each new
 .I man
 document.
 .