diff options
author | wl <wl> | 2006-03-26 08:55:37 +0000 |
---|---|---|
committer | wl <wl> | 2006-03-26 08:55:37 +0000 |
commit | 71b1dc9f97ede68f8bc75a04d282b79988cb03b0 (patch) | |
tree | f82686e4d18c4eb2f6cfd2dc74c0651a27e17c6a /doc/groff.texinfo | |
parent | 9c1a0c4bd3d740059b547fc916613614de2384fa (diff) | |
download | groff-71b1dc9f97ede68f8bc75a04d282b79988cb03b0.tar.gz |
* doc/groff.texinfo: More documentation on end-of-macro symbol of
`.de'.
Minor addition ot `.di' description.
Diffstat (limited to 'doc/groff.texinfo')
-rw-r--r-- | doc/groff.texinfo | 26 |
1 files changed, 25 insertions, 1 deletions
diff --git a/doc/groff.texinfo b/doc/groff.texinfo index 41fffcec..8322c0a2 100644 --- a/doc/groff.texinfo +++ b/doc/groff.texinfo @@ -5448,6 +5448,9 @@ character prevents this. @cindex macro arguments @cindex arguments to requests and macros +@cindex tabs, and macro arguments +@cindex macro arguments, and tabs +@cindex arguments to macros, and tabs Arguments to requests and macros are processed much like the shell: The line is split into arguments according to spaces.@footnote{Plan@tie{}9's @code{troff} implementation also allows @@ -10841,7 +10844,23 @@ encounters the line @samp{..} (two dots). The optional second argument to @code{de} changes this to a macro to @samp{.@var{end}}. There can be whitespace after the first dot in the line containing the -ending token (either @samp{.} or macro @samp{@var{end}}). +ending token (either @samp{.} or macro @samp{@var{end}}). Don't insert +a tab character immediately after the @samp{..}, otherwise it isn't +recognized as the end-of-macro symbol.@footnote{While it is possible to +define and call a macro @samp{.} with + +@Example +.de . +. tm foo +.. +. +.. \" This calls macro `.'! +@endExample + +@noindent +you can't use this as the end-of-macro macro: during a macro definition, +@samp{..} is never handled as a call to @samp{.}, even if you say +@samp{.de 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 @@ request, it takes an argument of a macro name to divert subsequent text 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} |