[Groff-commit] groff ChangeLog tmac/groff_trace.man

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     06/10/24 08:04:14

Modified files:
        .              : ChangeLog 
        tmac           : groff_trace.man 

Log message:
        * tmac/groff_trace.man: Mention problem with `\\\\'.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.994&r2=1.995
http://cvs.savannah.gnu.org/viewcvs/groff/tmac/groff_trace.man?cvsroot=groff&r1=1.2&r2=1.3

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.994
retrieving revision 1.995
diff -u -b -r1.994 -r1.995
--- ChangeLog   23 Oct 2006 07:59:54 -0000      1.994
+++ ChangeLog   24 Oct 2006 08:04:14 -0000      1.995
@@ -1,3 +1,7 @@
+2006-10-24  Werner LEMBERG  <address@hidden>
+
+       * tmac/groff_trace.man: Mention problem with `\\\\'.
+
 2006-10-23  Werner LEMBERG  <address@hidden>
 
        * doc/groff.texinfo (Expressions): Improve documentation of `!'.

Index: tmac/groff_trace.man
===================================================================
RCS file: /cvsroot/groff/groff/tmac/groff_trace.man,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- tmac/groff_trace.man        18 Jul 2003 08:16:48 -0000      1.2
+++ tmac/groff_trace.man        24 Oct 2006 08:04:14 -0000      1.3
@@ -15,11 +15,11 @@
 
 File position: <groff-source>/tmac/groff_trace.man
 
-Last update: 14 July 2002
+Last update: 23 Oct 2006
 
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2002 Free Software Foundation, Inc.
+Copyright (C) 2002, 2006 Free Software Foundation, Inc.
 written by Bernd Warken <address@hidden>
 
 Permission is granted to copy, distribute and/or modify this document
@@ -458,6 +458,42 @@
 .
 .
 .\" --------------------------------------------------------------------
+.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
+.
+.P
+.Example
+\&.foo \e\e\e\en[bar]
+./Example
+.
+.P
+normally passes `\e\en[bar]' to macro `.foo', but with the redefined
+.B .de
+request it passes `\en[bar]' 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
+.
+.P
+.Example
+\&.foo \eEn[bar]
+./Example
+.
+.
+.\" --------------------------------------------------------------------
 .SH FILES
 .\" --------------------------------------------------------------------
 .