groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 09/23: groff_trace(7): Relocate material.


From: G. Branden Robinson
Subject: [groff] 09/23: groff_trace(7): Relocate material.
Date: Mon, 21 Mar 2022 03:44:55 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 22b985afb5abdf22f8d37370b06e7572b4ae2667
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Mar 20 14:10:23 2022 +1100

    groff_trace(7): Relocate material.
    
    ...in preparation for further revision.
---
 tmac/groff_trace.7.man | 80 +++++++++++++++++++++++++-------------------------
 1 file changed, 40 insertions(+), 40 deletions(-)

diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index dad2e2be..5f74a700 100644
--- a/tmac/groff_trace.7.man
+++ b/tmac/groff_trace.7.man
@@ -93,6 +93,46 @@ modified such that they display diagnostic messages.
 .
 .
 .\" ====================================================================
+.SH Problems
+.\" ====================================================================
+.
+Because
+.B trace.tmac
+wraps the
+.B .de
+request (and its cousins), macro arguments are expanded one level more.
+.
+This causes problems if an argument contains four backslashes or more
+to prevent too early expansion of the backslash.
+.
+For example, this macro call
+.
+.IP
+.EX
+\&.foo \e\e\e\en[bar]
+.EE
+.
+.
+.P
+normally passes \[oq]\e\en[bar]\[cq] to macro \[oq].foo\[cq], but with
+the redefined
+.B .de
+request it passes \[oq]\en[bar]\[cq] instead.
+.
+.
+.P
+The solution to this problem is to use groff's
+.B \eE
+escape which is an escape character not interpreted in copy mode, for
+example
+.
+.IP
+.EX
+\&.foo \eEn[bar]
+.EE
+.
+.
+.\" ====================================================================
 .SH Example
 .\" ====================================================================
 .
@@ -208,46 +248,6 @@ is fully protocolled.
 .
 .
 .\" ====================================================================
-.SH Problems
-.\" ====================================================================
-.
-Because
-.B trace.tmac
-wraps the
-.B .de
-request (and its cousins), macro arguments are expanded one level more.
-.
-This causes problems if an argument contains four backslashes or more
-to prevent too early expansion of the backslash.
-.
-For example, this macro call
-.
-.IP
-.EX
-\&.foo \e\e\e\en[bar]
-.EE
-.
-.
-.P
-normally passes \[oq]\e\en[bar]\[cq] to macro \[oq].foo\[cq], but with
-the redefined
-.B .de
-request it passes \[oq]\en[bar]\[cq] instead.
-.
-.
-.P
-The solution to this problem is to use groff's
-.B \eE
-escape which is an escape character not interpreted in copy mode, for
-example
-.
-.IP
-.EX
-\&.foo \eEn[bar]
-.EE
-.
-.
-.\" ====================================================================
 .SH Files
 .\" ====================================================================
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]