[groff] 09/10: doc/groff.texi (Copy Mode): Fix omissions.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e493d922014649931a216923e7b9ae797d0410f5
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri May 21 17:04:24 2021 +1000

    doc/groff.texi (Copy Mode): Fix omissions.
    
    * doc/groff.texi (Copy Mode): Fix omissions from list of escape
      sequences interpreted even in copy mode.  Add \g, \V, "\.", '\"', \#,
      \a, \e and \E (with caveat), and \t.  Parallels groff(7) now.  Add
      cross reference to "Character Translations" node.
    
    Also bracket node with Texinfo @codequote* commands, marking it as
    reviewed for ` and ' usage issues.
---
 ChangeLog      |  8 ++++++++
 doc/groff.texi | 23 +++++++++++++++++------
 2 files changed, 25 insertions(+), 6 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7b51fe3..0d95349 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * doc/groff.texi (Copy Mode): Fix omissions from list of escape
+       sequences interpreted even in copy mode.  Add \g, \V, "\.",
+       '\"', \#, \a, \e and \E (with caveat), and \t.  Parallels
+       groff(7) now.  Add cross reference to "Character Translations"
+       node.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * man/groff.7.man (Escape Sequences): Fix omission; an
        the escape character in an unrecognized escape sequence is not
        merely ignored; the sequence produces a warning diagnostic,
diff --git a/doc/groff.texi b/doc/groff.texi
index a064712..7a762bb 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12159,6 +12159,9 @@ macro one level higher.  This is used to define a 
wrapper macro for
 
 @c ---------------------------------------------------------------------
 
+@codequotebacktick on
+@codequoteundirected on
+
 @node Copy Mode, Parameters, Writing Macros, Writing Macros
 @subsection Copy Mode
 @cindex copy mode
@@ -12174,15 +12177,20 @@ macro one level higher.  This is used to define a 
wrapper macro for
 When GNU @code{troff} processes certain requests, most importantly those
 which define a macro, string, or diversion, it does so in @dfn{copy
 mode}: it copies the characters of the definition into a dedicated
-storage region, interpolating the escape sequences @code{\n}, @code{\$},
-and @code{\*}, intepreting @code{\\} and @code{\@key{RET}} immediately,
-and storing all other escape sequences in an encoded form.
+storage region, interpolating the escape sequences @code{\n}, @code{\g},
+@code{\$}, @code{\*}, and @code{\V} normally; interpreting @code{\.} and
+@code{\@key{RET}} immediately; discarding comments @code{\"} and
+@code{\#}; interpolating the current leader, escape, or tab character
+with @code{\a}, @code{\e} or @code{\E}, and @code{\t}, respectively; and
+storing all other escape sequences in an encoded form.  @xref{Character
+Translations} for more on the use of @code{\e} and @code{\E}, and the
+distinction between them.
 
 Since the escape character escapes itself, you can control whether
 any escape sequence is interpreted at macro definition time or when it
-is later interpolated by selectively insulating the escapes with an
-extra backslash.@footnote{Compare this to the @code{\def} and
-@code{\edef} commands in @TeX{}.}
+is later interpolated by selectively insulating the escapes with another
+instace of the escape character.@footnote{Compare this to the
+@code{\def} and @code{\edef} commands in @TeX{}.}
 
 @Example
 .nr x 20
@@ -12202,6 +12210,9 @@ not defining or appending to a macro, string, or 
diversion---where all
 escapes and macros are interpolated and requests invoked immediately
 upon recognition, can be termed @dfn{interpretation mode}.
 
+@codequotebacktick off
+@codequoteundirected off
+
 @c ---------------------------------------------------------------------
 
 @node Parameters,  , Copy Mode, Writing Macros