|
|
CVSROOT: /sources/m4
Module name: m4
Branch: branch-1_4
Changes by: Eric Blake <ericb> 06/09/20 03:59:42
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.76
retrieving revision 1.1.1.1.2.77
diff -u -b -r1.1.1.1.2.76 -r1.1.1.1.2.77
--- doc/m4.texinfo 14 Sep 2006 14:55:54 -0000 1.1.1.1.2.76
+++ doc/m4.texinfo 20 Sep 2006 03:59:42 -0000 1.1.1.1.2.77
@@ -561,19 +561,24 @@
functions. @xref{Debug Levels}, for more details on the format and
meaning of @var{FLAGS}. If omitted, @var{FLAGS} defaults to @samp{aeq}.
-@item -l @var{NUM}
-@itemx --arglength=@var{NUM}
-Restrict the size of the output generated by macro tracing to @var{NUM}
-characters per trace line. If unspecified or zero, output is
-unlimited. @xref{Debug Levels}, for more details.
-
-@item -o @var{FILE}
+@item --debugfile=@var{FILE}
+@itemx -o @var{FILE}
@itemx --error-output=@var{FILE}
Redirect @code{dumpdef} output, debug messages, and trace output to the
named @var{FILE}. Warnings, error messages, and @code{errprint} output
are still printed to standard error. If unspecified, debug output goes
to standard error; if empty, debug output is discarded. @xref{Debug
-Output}, for more details.
+Output}, for more details. The spellings @option{-o} and
+@option{--error-output} are misleading and inconsistent with other
+@acronym{GNU} tools; for now they are silently accepted as synonyms of
+@option{--debugfile}, but in a future version of M4, using them will
+cause a warning to be issued.
+
+@item -l @var{NUM}
+@itemx --arglength=@var{NUM}
+Restrict the size of the output generated by macro tracing to @var{NUM}
+characters per trace line. If unspecified or zero, output is
+unlimited. @xref{Debug Levels}, for more details.
@item -t @var{NAME}
@itemx --trace=@var{NAME}
@@ -2337,7 +2342,7 @@
@cindex output, saving debugging
@cindex @acronym{GNU} extensions
Debug and tracing output can be redirected to files using either the
-@option{-o} option to @code{m4} (@pxref{Invoking m4}), or with the
+@option{--debugfile} option to @code{m4} (@pxref{Invoking m4}), or with the
builtin macro @code{debugfile}:
@deffn Builtin debugfile (@ovar{file})
@@ -4761,7 +4766,7 @@
In addition to the above extensions, @acronym{GNU} @code{m4} implements the
following command line options: @option{-F}, @option{-G}, @option{-I},
@option{-L}, @option{-R}, @option{-V}, @option{-W}, @option{-d},
-@option{-l}, @option{-o} and @option{-t}. @xref{Invoking m4}, for a
+@option{-l}, @option{--debugfile} and @option{-t}. @xref{Invoking m4}, for a
description of these options.
Also, the debugging and tracing facilities in @acronym{GNU} @code{m4} are much
|
|