[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 09/10: doc/groff.texi (Copy Mode): Fix omissions.
From: |
G. Branden Robinson |
Subject: |
[groff] 09/10: doc/groff.texi (Copy Mode): Fix omissions. |
Date: |
Fri, 21 May 2021 03:28:46 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 09/10: doc/groff.texi (Copy Mode): Fix omissions.,
G. Branden Robinson <=