gbranden pushed a commit to branch master
in repository groff.
commit c7f3a0a0cbac8538d21ccd2cd25f7f8d69cc716b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Apr 14 00:16:08 2026 -0500
[doc,man]: Revise terminology and sync.
* Refer to request arguments not present in the input as "omitted"
rather than "absent" or "empty", for clarity. The term "empty" is
especially hazardous given its use elsewhere to describe roff language
objects that exist but have no contents. An omitted argument does
not exist; if it did, the `.$` register would count it.
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 29 ++++++++++++++++++++---------
man/groff_diff.7.man | 10 +++++-----
2 files changed, 25 insertions(+), 14 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 7e58b486b..9b5456589 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -15615,9 +15615,9 @@ and
@var{end},
inclusively.
The first element of the string has index@tie{}0.
-An absent
+Omitting
@var{end}
-argument implies the largest valid value
+implies the largest valid value
(the string length minus one).
Negative indices count backward from the end of the string:@:
the last element has index@tie{}@minus{}1,
@@ -16124,7 +16124,7 @@ resembles
@samp{.if 1};
it puts a break on the output if
@var{input}
-is empty.
+is omitted.
Unlike
@code{if},
it cannot govern conditional blocks.
@@ -21766,12 +21766,23 @@ and the horizontal page location in ens.
@endDefreq
@Defreq {spreadwarn, [@Var{limit}]}
-Emit a @code{break} warning if the additional space inserted for each
-space between words in an output line adjusted to both margins with
-@w{@samp{.ad b}} is larger than or equal to @var{limit}. A negative
-value is treated as zero; an absent argument toggles the warning on and
-off without changing @var{limit}. The default scaling unit is @samp{m}.
-At startup, @code{spreadwarn} is inactive and @var{limit} is 3@dmn{m}.
+Emit a
+@code{break}
+warning if the additional space inserted for each space between words in
+an output line adjusted to both margins with
+@w{@samp{.ad b}}
+is larger than or equal to
+@var{limit}.
+A negative value is treated as zero;
+an absent argument toggles the warning on and off without changing
+@var{limit}.
+The default scaling unit is
+@samp{m}.
+At startup,
+@code{spreadwarn}
+is inactive and
+@var{limit}
+is 3@dmn{m}.
For example,
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index b2c8952a0..b165a4181 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -636,7 +636,7 @@ ignoring scaling units in
.I e
if
.I c
-is empty.
+is omitted.
.
.
.P
@@ -3237,7 +3237,7 @@ requests,
is used.
If
.I g
-is missing or identical
+is omitted or identical
.RI to\~ f ,
then
.RI font\~ f
@@ -3823,7 +3823,7 @@ resembles
.RB \[lq] ".if 1" \[rq];
it puts a break on the output if
.I input
-is empty.
+is omitted.
.
Unlike
.RB \[lq]\| if \|\[rq],
@@ -4432,7 +4432,7 @@ is larger than or equal to
.IR limit .
.
A negative value is treated as zero;
-an absent argument toggles the warning on and off without changing
+omitting the argument toggles the warning on and off without changing
.IR limit .
.
The default scaling unit is
@@ -4498,7 +4498,7 @@ inclusively.
.
The first element of the string has index\~0.
.
-An absent
+Omitting
.I end
argument implies the largest valid value
(the string length minus one).
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
