gbranden pushed a commit to branch master
in repository groff.
commit e0a29cf41c5cf72a7468e558ef5d1fb329dccfe3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Jul 29 04:02:11 2025 -0500
doc/*,troff(1): Recast "Warnings" material.
* Favor active voice over passive.
* Sync line breaks between Texinfo and man(7).
---
doc/groff.texi.in | 21 +++++++++++++++------
src/roff/troff/troff.1.man | 17 ++++++++---------
2 files changed, 23 insertions(+), 15 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index f0dd51779..da7891af8 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19133,12 +19133,21 @@ codes of enabled warning categories.
@subsection Warnings
@cindex warnings
-Warning diagnostics emitted by GNU @code{troff} are divided into named,
-numbered categories. The name associated with each warning category is
-used by the @option{-w} and @option{-W} options. Each category is also
-assigned a power of two; the sum of enabled category values is used by
-the @code{warn} request and the @code{.warn} register.
-
+GNU
+@command{troff} @c GNU
+divides its warning diagnostics into named,
+numbered categories.
+The
+@option{-w}
+and
+@option{-W}
+options use the associated names.
+A power of two characterizes each category;
+the
+@code{warn}
+request and the
+@code{.warn}
+register respectively set and report the sum of enabled category codes.
Warnings of each category are produced under the following
circumstances.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 4aafeeab6..13e1d566f 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -530,23 +530,22 @@ Suppress formatted output.
.
.\" BEGIN Keep parallel with groff.texi node "Warnings".
.\" Caveat: the Texinfo manual sorts them by number, not name.
-Warning diagnostics emitted by
-.I @g@troff
-are divided into named,
+GNU
+.I troff \" GNU
+divides its warning diagnostics into named,
numbered categories.
-.
-The name associated with each warning category is used by the
+The
.B \-w
and
.B \-W
-options.
+options use the associated names.
.
-Each category is also assigned a power of two;
-the sum of enabled category codes is used by the
+A power of two characterizes each category;
+the
.B warn
request and the
.B .warn
-register.
+register respectively set and report the sum of enabled category codes.
.
Warnings of each category are produced under the following
circumstances.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
