[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/12: groff_tmac(5): Revise copy mode discussion.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/12: groff_tmac(5): Revise copy mode discussion. |
Date: |
Thu, 6 May 2021 05:02:24 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 283eca091c26a0ef41bf2837be79095fe6e8d9ab
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu May 6 10:05:28 2021 +1000
groff_tmac(5): Revise copy mode discussion.
Migrate from "copy-in mode" to "copy mode" terminology; see 2a63d94e.
Replace explanatory paragraph with the one from our Texinfo manual.
Lightly recast a subsequent one.
---
man/groff_tmac.5.man | 37 +++++++++++++++++++++++++------------
1 file changed, 25 insertions(+), 12 deletions(-)
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 2358b0d..72f9efa 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -930,17 +930,30 @@ see
.
.
.\" ====================================================================
-.SS "Copy-in mode"
+.SS "Copy mode"
.\" ====================================================================
.
-The phase when groff reads a macro is called
-.I "copy-in mode"
-or
-.I "copy mode"
-in roff-talk.
-.
-This is comparable to the C\~preprocessing phase during the development
-of a program written in the C\~language.
+When
+.I groff
+processes certain requests,
+most importantly those which define a macro,
+string,
+or diversion,
+it does so in
+.IR "copy mode" :
+it copies the characters of the definition into a dedicated storage
+region,
+interpolating the escape sequences
+.BR \[rs]n ,
+.BR \[rs]$ ,
+and
+.BR \[rs]* ,
+intepreting
+.B \[rs]\[rs]
+and
+.BI \[rs] newline
+immediately,
+and storing all other escape sequences in an encoded form.
.
.
.P
@@ -1093,9 +1106,9 @@ with a leading dot.
.RE
.
.IP \(bu
-Write a comment macro that works both for copy-in and draft mode; for
-as escaping is off in draft mode, trouble might occur when normal
-comments are used.
+Write a comment macro that works both for copy and draft modes;
+since the escape character is off in draft mode,
+trouble might occur when comment escapes are used.
.
For example, the following macro just ignores its arguments, so it
acts like a comment line:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/12: groff_tmac(5): Revise copy mode discussion.,
G. Branden Robinson <=