CVSROOT: /sources/m4
Module name: m4
Branch: branch-1_4
Changes by: Eric Blake <ericb> 07/03/02 03:22:58
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.119
retrieving revision 1.1.1.1.2.120
diff -u -b -r1.1.1.1.2.119 -r1.1.1.1.2.120
--- doc/m4.texinfo 1 Mar 2007 21:46:05 -0000 1.1.1.1.2.119
+++ doc/m4.texinfo 2 Mar 2007 03:22:58 -0000 1.1.1.1.2.120
@@ -2,15 +2,14 @@
@comment ========================================================
@comment %**start of header
@setfilename m4.info
[EMAIL PROTECTED] GNU M4 macro processor
[EMAIL PROTECTED] version.texi
[EMAIL PROTECTED] GNU M4 @value{VERSION} macro processor
@setchapternewpage odd
@ifnothtml
@setcontentsaftertitlepage
@end ifnothtml
@finalout
[EMAIL PROTECTED] version.texi
-
@c @tabchar{}
@c ----------
@c The testsuite expects literal tab output in some examples, but
@@ -476,6 +475,7 @@
after @var{argument}, rather than ignoring them.
@end deffn
[EMAIL PROTECTED] numbers
All macro arguments in @code{m4} are strings, but some are given
special interpretation, e.g., as numbers, file names, regular
expressions, etc. The documentation for each macro will state how the
@@ -645,7 +645,7 @@
@item -s
@itemx --synclines
[EMAIL PROTECTED] syncronization lines
[EMAIL PROTECTED] synchronization lines
@cindex location, input
@cindex input location
Generate synchronization lines, for use by the C preprocessor or other
@@ -2786,6 +2786,7 @@
@cindex displaying macro definitions
@cindex macros, displaying definitions
@cindex definitions, displaying macro
[EMAIL PROTECTED] standard error, output to
If you want to see what a name expands into, you can use the builtin
@code{dumpdef}:
@@ -2835,6 +2836,7 @@
@cindex tracing macro expansion
@cindex macro expansion, tracing
@cindex expansion, tracing macro
[EMAIL PROTECTED] standard error, output to
It is possible to trace macro calls and expansions through the builtins
@code{traceon} and @code{traceoff}:
@@ -3822,7 +3824,6 @@
@cindex file inclusion
@cindex inclusion, of files
-
@code{m4} allows you to include named files at any point in the input.
@menu
@@ -3929,6 +3930,7 @@
@acronym{GNU} @code{m4} allows included files to be found in other directories
than the current working directory.
[EMAIL PROTECTED] @env{M4PATH}
If the @option{--prepend-include} or @option{-B} command-line option was
provided (@pxref{Preprocessor features, , Invoking m4}), those
directories are searched first, in reverse order that those options were
@@ -3951,6 +3953,7 @@
reinserted into the output stream, @dfn{undiverted}, again at a later
time.
[EMAIL PROTECTED] @env{TMPDIR}
Numbered diversions are counted from 0 upwards, diversion number 0
being the normal output stream. The number of simultaneous diversions
is limited mainly by the memory used to describe them, because @acronym{GNU}
@@ -4155,6 +4158,7 @@
@cindex file inclusion
@cindex inclusion, of files
[EMAIL PROTECTED] @acronym{GNU} extensions
As a @acronym{GNU} extension, @var{diversions} may contain non-numeric
strings, which are treated as the names of files to copy into the output
without expansion. A warning is issued if a file could not be opened.
@@ -5249,6 +5253,8 @@
@end deffn
@example
+sysval
[EMAIL PROTECTED]
syscmd(`false')
@result{}
ifelse(sysval, `0', `zero', `non-zero')
@@ -5306,6 +5312,10 @@
@result{}
sysval
@result{}2304
+syscmd()
[EMAIL PROTECTED]
+sysval
[EMAIL PROTECTED]
esyscmd(`kill -9 $$')
@result{}
sysval
@@ -5414,6 +5424,7 @@
@cindex printing error messages
@cindex error messages, printing
@cindex messages, printing error
[EMAIL PROTECTED] standard error, output to
You can print error messages using @code{errprint}:
@deffn Builtin errprint (@var{message}, @dots{})
@@ -5617,9 +5628,10 @@
@node Using frozen files
@section Using frozen files
+
@cindex fast loading of frozen files
@cindex frozen files for fast loading
[EMAIL PROTECTED] initialization, frozen states
[EMAIL PROTECTED] initialization, frozen state
@cindex dumping into frozen file
@cindex reloading a frozen file
@cindex @acronym{GNU} extensions
@@ -5717,6 +5729,7 @@
@node Frozen file format
@section Frozen file format
+
@cindex frozen file format
@cindex file format, frozen file
Frozen files are sharable across architectures. It is safe to write
@@ -5804,6 +5817,7 @@
@section Extensions in @acronym{GNU} @code{m4}
@cindex @acronym{GNU} extensions
[EMAIL PROTECTED] @acronym{POSIX}
This version of @code{m4} contains a few facilities that do not exist
in System V @code{m4}. These extra facilities are all suppressed by
using the @option{-G} command line option (@pxref{Limits control, ,
