[groff] 03/34: [docs]: Tighten discussion of warning categories.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f73b8ec0a2cf2a2ff4e626e635a5fdc38a8fa927
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 23 15:27:32 2021 +1000

    [docs]: Tighten discussion of warning categories.
    
    * `escape`: Drop sentence already covered in our Texinfo manual and in
      groff(7).
    * `mac`: Drop call-out of "box" object type; see commit 62274f0d.
---
 doc/groff.texi             |  8 +++-----
 src/roff/troff/troff.1.man | 16 ++++------------
 2 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f77bcbf..6d502c1 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15554,8 +15554,8 @@ without an argument when there was no current diversion.
 @cindex @code{da} request, and warnings
 @cindex @code{box}, @code{boxa} requests, and warnings
 @cindex @code{\*}, and warnings
-An undefined string, macro, diversion, or box was used.  When such an
-object is dereferenced, an empty object of that name is automatically
+An undefined string, macro, or diversion was used.  When such an object
+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
@@ -15593,9 +15593,7 @@ An invalid character occurred on the input stream.
 
 @item escape
 @itemx 32768
-An unsupported escape sequence was encountered.  In such a sequence
-@code{\@var{X}}, the escape character is ignored and @var{X}@tie{}is
-output.
+An unsupported escape sequence was encountered.
 
 @item space
 @itemx 65536
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 46b4832..764e081 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -518,7 +518,7 @@ a line could not be broken such that its length was less 
than the output
 line length
 .BR \[rs]n[.l] .
 .
-This is enabled by default.
+This category is enabled by default.
 .
 .
 .TP
@@ -530,7 +530,7 @@ is a misnomer since it reports missing glyphs\[em]there are 
no
 \[lq]missing\[rq] input characters,
 only invalid ones.)
 .
-This cateogry is enabled by default.
+This category is enabled by default.
 .
 .
 .TP
@@ -571,13 +571,6 @@ request.
 .BR escape "\t32768"
 An unsupported escape sequence was encountered.
 .
-In such a sequence
-.BI \[rs] X\c
-,
-the escape character is ignored and
-.IR X \~is
-output.
-.
 .
 .TP
 .BR file "\t1048576"
@@ -612,11 +605,10 @@ An invalid character occurred on the input stream.
 .BR mac "\t512"
 An undefined string,
 macro,
-diversion,
-or box was used.
+or diversion was used.
 .
 When such an object is dereferenced,
-an empty object of that name is automatically created.
+an empty one of that name and type is automatically created.
 .
 So,
 in most cases,