gbranden pushed a commit to branch master
in repository groff.
commit 6612ffb3fc3f689f45bc246e85ff1b2336aad282
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Dec 30 04:15:30 2025 -0600
[doc,man]: Tweak material on warnings.
Favor active voice over passive. Improve use of terminology.
---
doc/groff.texi.in | 16 +++++++++-------
src/roff/troff/troff.1.man | 7 ++++---
2 files changed, 13 insertions(+), 10 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index e800085bd..e0523decb 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20250,11 +20250,13 @@ created if it does not exist.
@cindex @code{nr} request, and warnings
@cindex @code{\R}, and warnings
@cindex @code{\n}, and warnings
-An undefined register was used. When an undefined register is
-dereferenced, it is automatically defined with a value of@tie{}0.
+An undefined register was used.
+When an undefined register is dereferenced,
+the formatter automatically defines it with a value of@tie{}0.
So,
unless it is later deleted,
-GNU @command{troff}
+GNU
+@command{troff} @c GNU
issues at most one warning for each.
@item tab
@@ -20306,10 +20308,10 @@ when it occurs in non-ignored input.
@item color
@itemx 524288
-An undefined color was selected, an attempt was made to define a color
-using an unrecognized color space, an invalid component in a color
-definition was encountered, or an attempt was made to redefine a default
-color.
+An undefined color was selected,
+an attempt was made to define a color using an unrecognized color space,
+an invalid channel value in a color definition was encountered,
+or an attempt was made to redefine a default color.
@item file
@itemx 1048576
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 1f91d6373..6347e2fe5 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -631,7 +631,7 @@ T}
color 524288 T{
An undefined color name was selected,
an attempt was made to define a color using an unrecognized color space,
-an invalid component in a color definition was encountered,
+an invalid channel value in a color definition was encountered,
or an attempt was made to redefine a default color.
T}
.
@@ -769,11 +769,12 @@ reg 1024 T{
An undefined register was used.
.
When an undefined register is dereferenced,
-it is automatically defined with a value of\~0.
+the formatter automatically defines it with a value of\~0.
.
So,
unless it is later deleted,
-.I @g@troff
+GNU
+.I troff \" GNU
issues at most one warning for each.
T}
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
