[groff] 07/40: [docs]: Tweak discussion of copy mode.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f9e183490263d76a063f40965ef2a5cc00c2a34a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Dec 7 16:17:13 2022 -0600

    [docs]: Tweak discussion of copy mode.
---
 doc/groff.texi  | 21 +++++++++++----------
 man/groff.7.man |  9 ++++++---
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 939a79fdf..8f6549acb 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -13253,10 +13253,10 @@ processed immediately upon recognition, can be termed
 @dfn{interpretation mode}.
 
 @Defesc {\\\\, , , }
-The escape character, @code{\} by default, can escape a backslash.  This
+The escape character, @code{\} by default, can escape itself.  This
 enables you to control whether a given @code{\n}, @code{\g}, @code{\$},
-@code{\*}, @code{\V}, or @code{\?} escape sequence is interpreted at
-the time the macro containing it is defined, or later when the macro is
+@code{\*}, @code{\V}, or @code{\?} escape sequence is interpreted at the
+time the macro containing it is defined, or later when the macro is
 called.@footnote{Compare this to the @code{\def} and @code{\edef}
 commands in @TeX{}.}
 
@@ -13276,8 +13276,9 @@ character followed by a backslash from which the escape 
character has
 removed its special meaning.  Consequently, @samp{\\} is not an escape
 sequence in the usual sense.  In any escape sequence @samp{\@var{X}}
 that GNU @code{troff} does not recognize, the escape character is
-ignored and @var{X} is output, with two exceptions---@samp{\\} is the
-first.
+ignored and @var{X} is output.  An unrecognized escape sequence causes
+a warning in category @samp{escape}, with two exceptions---@samp{\\} is
+the first.
 @endDefesc
 
 @cindex @code{\\}, when reading text for a macro
@@ -13335,11 +13336,11 @@ This understeer is getting
 @endExample
 
 Each escape character is interpreted twice---once in copy mode, when the
-macro is defined, and once outside of it, when the macro is called.  As
-seen above, this fact leads to exponential growth in the quantity of
-escape characters required to delay interpolation of @code{\n},
-@code{\g}, @code{\$}, @code{\*}, @code{\V}, and @code{\?} at each
-nesting level, which can be daunting.  GNU @code{troff} offers a
+macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of
+@code{\n}, @code{\g}, @code{\$}, @code{\*}, @code{\V}, and @code{\?} at
+each nesting level, which can be daunting.  GNU @code{troff} offers a
 solution.
 
 @Defesc {\\E, , , }
diff --git a/man/groff.7.man b/man/groff.7.man
index 312fc1e85..c18cb2d3c 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6339,7 +6339,7 @@ can be termed
 The escape character,
 .B \[rs]
 by default,
-can escape a backslash.
+can escape itself.
 .
 This enables you to control whether a given
 .BR \[rs]n ,
@@ -6372,7 +6372,10 @@ that
 does not recognize,
 the escape character is ignored and
 .IR X \~is
-output,
+output.
+.
+An unrecognized escape sequence causes a warning in category
+.RB \%\[lq] escape \[rq],
 with two exceptions,
 .B \[rs]\[rs]
 being one.
@@ -6418,7 +6421,7 @@ In
 .RB \[lq] \|\[rs]\[rs] \[rq],
 each escape character is interpreted twice\[em]once in copy mode,
 when the macro is defined,
-and once outside of it,
+and once in interpretation mode,
 when the macro is called.
 .
 This fact leads to exponential growth in the quantity of escape