[groff] 17/31: [docs]: Tweak descriptions of troff warnings.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 26fb0727e69ff12e8aac86a64e2e213bf052c1db
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jan 30 06:25:12 2022 +1100

    [docs]: Tweak descriptions of troff warnings.
    
    Use terminology more precisely.
---
 doc/groff.texi             | 23 +++++++++++------------
 src/roff/troff/troff.1.man | 16 ++++++++--------
 2 files changed, 19 insertions(+), 20 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 9a588b2b..e7e6f076 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15732,9 +15732,9 @@ by default.
 @itemx 4
 @cindex filling, and @code{break} warnings
 @cindex mode, fill, and @code{break} warnings
-A line could not be broken such that its length was less than the output
-line length, @samp{\n[.l]}; this can occur only when filling is enabled.
-This category is enabled by default.
+A filled output line could not be broken such that its length was less
+than the output line length @samp{\n[.l]}.  This category is enabled by
+default.
 
 @item delim
 @itemx 8
@@ -15749,7 +15749,7 @@ The @code{el} request was encountered with no prior 
corresponding
 
 @item scale
 @itemx 32
-An inappropriate scaling indicator was used in a numeric expression.
+An inappropriate scaling unit was used in a numeric expression.
 
 @item range
 @itemx 64
@@ -15787,8 +15787,8 @@ is dereferenced, an empty one of that name and type is 
automatically
 created.  So, in most cases, at most one warning is given for each name.
 
 This warning is also emitted upon an attempt to move an unplanted trap
-(@pxref{Page Location Traps}).  In such cases, the unplanted macro is
-@emph{not} dereferenced, so it is not created if it does not exist.
+macro (@pxref{Page Location Traps}).  In such cases, the unplanted macro
+is @emph{not} dereferenced, so it is not created if it does not exist.
 
 @item reg
 @itemx 1024
@@ -15835,8 +15835,7 @@ occurs in compatibility mode.
 
 @item font
 @itemx 131072
-A non-existent font was dereferenced.  This category is enabled by
-default.
+A non-existent font was selected.  This category is enabled by default.
 
 @item ig
 @itemx 262144
@@ -15846,10 +15845,10 @@ when it occurs in non-ignored input.
 
 @item color
 @itemx 524288
-An undefined color was dereferenced, 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 the
-default color.
+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.
 
 @item file
 @itemx 1048576
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index ce853dbd..a99dc504 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -508,9 +508,8 @@ _
 .
 .TP \nxu+3n
 .BR break "\t4"
-When filling is enabled,
-a line could not be broken such that its length was less than the output
-line length
+A filled output line could not be broken such that its length was less
+than the output line length
 .BR \[rs]n[.l] .
 .
 This category is enabled by default.
@@ -530,10 +529,10 @@ This category is enabled by default.
 .
 .TP
 .BR color "\t524288"
-An undefined color was dereferenced,
+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,
-or an attempt was made to redefine the default color.
+or an attempt was made to redefine a default color.
 .
 .
 .TP
@@ -576,7 +575,7 @@ This category is enabled by default.
 .
 .TP
 .BR font "\t131072"
-A non-existent font was dereferenced.
+A non-existent font was selected.
 .
 This category is enabled by default.
 .
@@ -611,7 +610,8 @@ at most one warning is given for each name.
 .
 .
 .IP
-This warning is also emitted upon an attempt to move an unplanted trap.
+This warning is also emitted upon an attempt to move an unplanted trap
+macro.
 .
 In such cases,
 the unplanted macro is
@@ -656,7 +656,7 @@ was encountered where a number was expected.
 .
 .TP
 .BR scale "\t32"
-An inappropriate scaling indicator was used in a numeric expression.
+An inappropriate scaling unit was used in a numeric expression.
 .
 .
 .TP