[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to m4/doc/m4.texinfo,v [branch-1_4]
From: |
Eric Blake |
Subject: |
Changes to m4/doc/m4.texinfo,v [branch-1_4] |
Date: |
Mon, 14 Aug 2006 13:07:15 +0000 |
CVSROOT: /sources/m4
Module name: m4
Branch: branch-1_4
Changes by: Eric Blake <ericb> 06/08/14 13:07:14
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.64
retrieving revision 1.1.1.1.2.65
diff -u -b -r1.1.1.1.2.64 -r1.1.1.1.2.65
--- doc/m4.texinfo 12 Aug 2006 20:02:30 -0000 1.1.1.1.2.64
+++ doc/m4.texinfo 14 Aug 2006 13:07:14 -0000 1.1.1.1.2.65
@@ -288,8 +288,8 @@
Besides just doing macro expansion, @code{m4} has builtin functions
for including named files, running shell commands, doing integer
arithmetic, manipulating text in various ways, performing recursion,
address@hidden @code{m4} can be used either as a front-end to a compiler, or
-as a macro processor in its own right.
address@hidden @code{m4} can be used either as a front-end to a compiler,
+or as a macro processor in its own right.
The @code{m4} macro processor is widely available on all UNIXes, and has
been standardized by @acronym{POSIX}.
@@ -352,7 +352,8 @@
1992, until 1994 when he released @acronym{GNU} @code{m4} 1.4, which was
the stable release for 10 years. It was at this time that @acronym{GNU}
Autoconf decided to require @acronym{GNU} @code{m4} as its underlying
-engine, since all other implementations of @code{m4} had too many limitations.
+engine, since all other implementations of @code{m4} had too many
+limitations.
More recently, in 2004, Paul Eggert released 1.4.1 and 1.4.2 which
addressed some long standing bugs in the venerable 1.4 release.
@@ -372,7 +373,7 @@
@comment ignore
@example
address@hidden address@hidden@dots{}] address@hidden@dots{}]
address@hidden @address@hidden@address@hidden @address@hidden@address@hidden
@end example
@cindex command line, options
@@ -409,8 +410,8 @@
Internally modify @emph{all} builtin macro names so they all start with
the prefix @samp{m4_}. For example, using this option, one should write
@samp{m4_define} instead of @samp{define}, and @samp{m4___file__}
-instead of @samp{__file__}. This option has no effect if @option{-R} is
-also specified.
+instead of @samp{__file__}. This option has no effect if @option{-R}
+is also specified.
@item -Q
@itemx --quiet
@@ -433,8 +434,8 @@
input came from. These features occur with the following options:
@table @code
address@hidden -D @address@hidden
address@hidden address@hidden@var{VALUE}]
address@hidden -D @address@hidden@address@hidden
address@hidden address@hidden@address@hidden@r{]}
This enters @var{NAME} into the symbol table, before any input files are
read. If @address@hidden is missing, the value is taken to be the
empty string. The @var{VALUE} can be any string, and the macro can be
@@ -442,11 +443,11 @@
input. This option may be given more than once; order is significant,
and redefining the same @var{NAME} loses the previous value.
address@hidden -I @var{DIR}
address@hidden address@hidden
-Make @code{m4} search @var{DIR} for included files that are not found in
-the current working directory. @xref{Search Path}, for more details.
-This option may be given more than once.
address@hidden -I @var{DIRECTORY}
address@hidden address@hidden
+Make @code{m4} search @var{DIRECTORY} for included files that are not
+found in the current working directory. @xref{Search Path}, for more
+details. This option may be given more than once.
@item -s
@itemx --synclines
@@ -504,9 +505,9 @@
this option (which is still experimental) might well disappear.
This option does @emph{not} have the ability to break endless
-rescanning loops, while these do not necessarily consume much memory
+rescanning loops, since these do not necessarily consume much memory
or stack space. Through clever usage of rescanning loops, one can
-request complex, time-consuming computations to @code{m4} with useful
+request complex, time-consuming computations from @code{m4} with useful
results. Putting limitations in this area would break @code{m4} power.
There are many pathological cases: @address@hidden(`a', `a')a}} is
only the simplest example (but @pxref{Compatibility}). Expecting @acronym{GNU}
@@ -534,13 +535,13 @@
@table @code
@item -F @var{FILE}
address@hidden --freeze-state @var{FILE}
address@hidden address@hidden
Once execution is finished, write out the frozen state on the specified
@var{FILE}. It is conventional, but not required, for @var{FILE} to end
in @samp{.m4f}.
@item -R @var{FILE}
address@hidden --reload-state @var{FILE}
address@hidden address@hidden
Before execution starts, recover the internal state from the specified
frozen @var{FILE}. The options @option{-D}, @option{-U}, and
@option{-t} take effect after state is reloaded, but before the input
@@ -551,8 +552,8 @@
scripts.
@table @code
address@hidden address@hidden
address@hidden address@hidden
address@hidden address@hidden@address@hidden
address@hidden address@hidden@address@hidden
Set the debug-level according to the flags @var{FLAGS}. The debug-level
controls the format and amount of information presented by the debugging
functions. @xref{Debug Levels}, for more details on the format and
@@ -561,13 +562,15 @@
@item -l @var{NUM}
@itemx address@hidden
Restrict the size of the output generated by macro tracing to @var{NUM}
-characters per trace line. @xref{Debug Levels}, for more details.
+characters per trace line. If unspecified or zero, output is
+unlimited. @xref{Debug Levels}, for more details.
@item -o @var{FILE}
@itemx address@hidden
-Redirect debug and trace output to the named @var{FILE}. Error messages
-are still printed on the standard error output. @xref{Debug Output},
-for more details.
+Redirect debug and trace output to the named @var{FILE}. Warnings,
+error messages, and the output of @code{errprint} and @code{dumpdef},
+are still printed to standard error. @xref{Debug Output}, for more
+details.
@item -t @var{NAME}
@itemx address@hidden
@@ -586,7 +589,7 @@
The input files are read in the sequence given. The standard input can
only be read once, so the file name @file{-} should only appear once on
the command line. It is an error if an input file ends in the middle of
-argument collection or a quoted string.
+argument collection, a comment, or a quoted string.
If none of the input files invoked @code{m4exit} (@pxref{M4exit}), the
exit status of @code{m4} will be 0 for success, 1 for general failure
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/01
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/03
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/04
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/08
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/09
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/12
- Changes to m4/doc/m4.texinfo,v [branch-1_4],
Eric Blake <=
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/15
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/16
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/17
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/22
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/08/24