diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-03-20 14:10:23 +1100 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-03-21 15:10:33 +1100 |
commit | 22b985afb5abdf22f8d37370b06e7572b4ae2667 (patch) | |
tree | ab17f7077358699460fd800a9dbd7f7001f82534 /tmac/groff_trace.7.man | |
parent | d3f2556ee0c0f6b485a008a687f72e3c7c160597 (diff) | |
download | groff-git-22b985afb5abdf22f8d37370b06e7572b4ae2667.tar.gz |
groff_trace(7): Relocate material.
...in preparation for further revision.
Diffstat (limited to 'tmac/groff_trace.7.man')
-rw-r--r-- | tmac/groff_trace.7.man | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man index dad2e2be4..5f74a7004 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 .\" ==================================================================== . |