[Groff-commit] groff ./ChangeLog doc/groff.texinfo

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 06/03/26 08:55:38

Modified files:
        .              : ChangeLog 
        doc            : groff.texinfo 

Log message:
        * doc/groff.texinfo: More documentation on end-of-macro symbol of
        `.de'.
        Minor addition ot `.di' description.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/groff/ChangeLog.diff?tr1=1.940&tr2=1.941&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/groff/groff/doc/groff.texinfo.diff?tr1=1.233&tr2=1.234&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.940 groff/ChangeLog:1.941
--- groff/ChangeLog:1.940       Sat Mar 25 05:30:40 2006
+++ groff/ChangeLog     Sun Mar 26 08:55:37 2006
@@ -1,3 +1,9 @@
+2006-03-26  Werner LEMBERG  <address@hidden>
+
+       * doc/groff.texinfo: More documentation on end-of-macro symbol of
+       `.de'.
+       Minor addition ot `.di' description.
+
 2006-03-25  Michail Vidiassov  <address@hidden>
 
        Add rules to generate `symbolsl.afm'.
Index: groff/doc/groff.texinfo
diff -u groff/doc/groff.texinfo:1.233 groff/doc/groff.texinfo:1.234
--- groff/doc/groff.texinfo:1.233       Sun Mar 19 09:13:43 2006
+++ groff/doc/groff.texinfo     Sun Mar 26 08:55:38 2006
@@ -5448,6 +5448,9 @@
 @cindex macro arguments
 @cindex arguments to requests and macros
 
address@hidden tabs, and macro arguments
address@hidden macro arguments, and tabs
address@hidden arguments to macros, and tabs
 Arguments to requests and macros are processed much like the shell:
 The line is split into arguments according to
 address@hidden@tie{}9's @code{troff} implementation also allows
@@ -10841,7 +10844,23 @@
 argument to @code{de} changes this to a macro to @address@hidden
 
 There can be whitespace after the first dot in the line containing the
-ending token (either @samp{.} or macro @address@hidden).
+ending token (either @samp{.} or macro @address@hidden).  Don't insert
+a tab character immediately after the @samp{..}, otherwise it isn't
+recognized as the end-of-macro address@hidden it is possible to
+define and call a macro @samp{.} with
+
address@hidden
+.de .
+.  tm foo
+..
+.
+..    \" This calls macro `.'!
address@hidden
+
address@hidden
+you can't use this as the end-of-macro macro: during a macro definition,
address@hidden is never handled as a call to @samp{.}, even if you say
address@hidden foo .} explicitly.}
 
 Here a small example macro called @samp{P} which causes a break and
 inserts some vertical space.  It could be used to separate paragraphs.
@@ -12109,6 +12128,11 @@
 into.  The @code{da} macro appends to an existing diversion.
 
 @code{di} or @code{da} without an argument ends the diversion.
+
+The current partially-filled line is included into the diversion.  See
+the @code{box} request below for an example.  Note that switching to
+another (empty) environment (with the @code{ev} request) avoids the
+inclusion of the current partially-filled line.
 @endDefreq
 
 @DefreqList {box, macro}