gbranden pushed a commit to branch master
in repository groff.
commit 4b6dda0f2ed52c10eac9df407ca0188845d587ec
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Apr 14 09:12:02 2025 -0500
[doc,man]: Clarify and align register descs.
Specifically, those that count input or output lines.
---
doc/groff.texi.in | 20 ++++++++++----------
man/groff.7.man | 11 +++++++----
man/groff_diff.7.man | 13 +++++++------
3 files changed, 24 insertions(+), 20 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 983269e96..300900934 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8477,9 +8477,9 @@ length and indentation without filling, then break again
regardless of
the invoking control character.
@c Temporary indentation is ignored.
If the argument is not positive, centering is disabled. Omitting the
-argument implies an @var{n} of @samp{1}. The count of lines remaining
-to be centered is stored in the read-only register @code{.ce} and is
-associated with the environment (@pxref{Environments}).
+argument implies an @var{n} of @samp{1}. The count of input lines
+remaining to be centered is stored in the read-only register @code{.ce}
+and is associated with the environment (@pxref{Environments}).
@cindex @code{ce} request, difference from @w{@samp{.ad c}}
While the @w{@samp{.ad c}} request also centers text, it fills the text
@@ -8527,8 +8527,8 @@ of the next @var{n} productive input lines to the right
margin without
filling, then break again regardless of the control character.
@c Temporary indentation is ignored.
If the argument is not positive, right-alignment is disabled. Omitting
-the argument implies an @var{n} of @samp{1}. The count of lines
-remaining to be right-aligned is stored in the read-only register
+the argument implies an @var{n} of @samp{1}. The count of input lines
+remaining to be right-aligned is stored in the read-only registeinput r
@code{.rj} and is associated with the environment
(@pxref{Environments}).
@@ -15655,10 +15655,10 @@ the trap is sprung.
@endExample
The @code{.it}, @code{.itc}, and @code{.itm} registers report the number
-of lines remaining in a pending input trap, a Boolean indication of
-whether that pending input trap honors output line continuation, and the
-name of the macro associated with the pending input trap, respectively.
-All are read-only; @code{.itm} is string-valued as well.
+of input lines remaining in a pending input trap, a Boolean indication
+of whether that pending input trap honors output line continuation, and
+the name of the macro associated with the pending input trap,
+respectively. All are read-only; @code{.itm} is string-valued as well.
@need 500
Let us consider in more detail the sorts of input lines that are or are
@@ -17489,7 +17489,7 @@ lines once
enables it.
The @code{.nn} register stores the
-count of lines @c in the environment
+count of lines remaining in the environment
for which numbering is suppressed
while output line numbering is enabled.
diff --git a/man/groff.7.man b/man/groff.7.man
index 21b0cc793..2b5273e86 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6619,7 +6619,8 @@ positive if glyph extends below the baseline.
.
.TP
.REG .ce
-Count of output lines remaining to be centered in the environment.
+Count of input lines remaining to be centered
+in the environment.
.
.TP
.REG .cht
@@ -6754,7 +6755,8 @@ was \[lq]interrupted\[rq] or continued with
.
.TP
.REG .it
-The count of lines remaining in the environment's pending input trap.
+Count of input lines remaining
+in the environment's pending input trap.
.
.TP
.REG .itc
@@ -6854,7 +6856,7 @@ Output line numbering is enabled in the environment
(Boolean-valued).
.
.TP
.REG .nn
-Count of lines in the environment
+Count of lines remaining in the environment
for which numbering is suppressed
while output line numbering is enabled.
.
@@ -6919,7 +6921,8 @@ Maximum representable integer in GNU
.
.TP
.REG .rj
-Count of lines remaining to be right-aligned in the environment.
+Count of input lines remaining to be right-aligned
+in the environment.
.
.TP
.REG .s
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c23293227..11baf690b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4491,7 +4491,7 @@ It is positive if the glyph extends below the baseline.
.
.TP
.B \[rs]n[.ce]
-Interpolate number of input lines remaining to be centered
+Interpolate count of input lines remaining to be centered
in the environment.
.
.
@@ -4631,8 +4631,8 @@ was \[lq]interrupted\[rq] or continued with
.
.TP
.B \[rs]n[.it]
-Interpolate the count of lines remaining in the environment's
-pending input trap.
+Interpolate count of input lines remaining
+in the environment's pending input trap.
.
.
.TP
@@ -4712,8 +4712,9 @@ Interpolate\~1 if output line numbering is enabled in the
environment
.
.TP
.B \[rs]n[.nn]
-Interpolate count of output lines remaining in the environment
-to have numbering suppressed.
+Interpolate count of lines remaining in the environment
+for which numbering is suppressed
+while output line numbering is enabled.
.
.
.TP
@@ -4772,7 +4773,7 @@ Interpolate the environment's post-vertical line spacing
amount.
.
.TP
.B \[rs]n[.rj]
-Interpolate number of input lines remaining to be right-aligned
+Interpolate count of input lines remaining to be right-aligned
in the environment.
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
