summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorwl <wl>2011-11-14 14:37:00 +0000
committerwl <wl>2011-11-14 14:37:00 +0000
commit563ba6352566b49418f4bd2967647f9eabe36777 (patch)
treeb15c6d361445329b2134a4d168dac5daa944344a
parent2530cbd884cc91c5644150394899873380ac1e40 (diff)
downloadgroff-563ba6352566b49418f4bd2967647f9eabe36777.tar.gz
* doc/groff.texinfo: Improve doc for calling undefined identifiers.
-rw-r--r--ChangeLog4
-rw-r--r--doc/groff.texinfo16
2 files changed, 20 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index a4f95496..91150cc0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
2011-11-14 Werner LEMBERG <wl@gnu.org>
+ * doc/groff.texinfo: Improve doc for calling undefined identifiers.
+
+2011-11-14 Werner LEMBERG <wl@gnu.org>
+
* src/preproc/tbl/tbl.man: Improve documentation of `_' and friends.
2011-10-31 Werner LEMBERG <wl@gnu.org>
diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index 1add8b5a..d6428961 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -6018,6 +6018,10 @@ details of formatting parameters.
Define or set registers using the @code{nr} request or the @code{\R}
escape.
+Although the following requests and escapes can be used to create
+registers, simply using an undefined register will cause it to be
+set to zero.
+
@DefreqList {nr, ident value}
@DefescListEnd {\\R, ', ident value, '}
Set number register @var{ident} to @var{value}. If @var{ident} doesn't
@@ -10521,6 +10525,10 @@ with a default scale indicator of @samp{z}.
convenience (i.e.@: there are no built-in strings exept @code{.T}, but
even this is a read-write string variable).
+Although the following requests can be used to create strings,
+simply using an undefined string will cause it to be defined as empty.
+@xref{Identifiers}.
+
@DefreqList {ds, name [@Var{string}]}
@DefreqItem {ds1, name [@Var{string}]}
@DefescItem {\\*, , n, }
@@ -11243,6 +11251,10 @@ A @dfn{macro} is a collection of text and embedded commands which can be
invoked multiple times. Use macros to define common operations.
@xref{Strings}, for a (limited) alternative syntax to call macros.
+Although the following requests can be used to create macros,
+simply using an undefined macro will cause it to be defined as empty.
+@xref{Identifiers}.
+
@DefreqList {de, name [@Var{end}]}
@DefreqItem {de1, name [@Var{end}]}
@DefreqItem {dei, name [@Var{end}]}
@@ -12728,6 +12740,10 @@ For orthogonality it is said that @code{gtroff} is in the @dfn{top-level
diversion} if no diversion is active (i.e., the data is diverted to the
output device).
+Although the following requests can be used to create diversions,
+simply using an undefined diversion will cause it to be defined as empty.
+@xref{Identifiers}.
+
@DefreqList {di, macro}
@DefreqListEnd {da, macro}
@cindex beginning diversion (@code{di})