CVSROOT: /sources/m4
Module name: m4
Branch: branch-1_4
Changes by: Eric Blake <ericb> 06/07/15 22:08:58
Index: doc/m4.texinfo
===================================================================
RCS file: /sources/m4/m4/doc/m4.texinfo,v
retrieving revision 1.1.1.1.2.45
retrieving revision 1.1.1.1.2.46
diff -u -b -r1.1.1.1.2.45 -r1.1.1.1.2.46
--- doc/m4.texinfo 15 Jul 2006 02:17:15 -0000 1.1.1.1.2.45
+++ doc/m4.texinfo 15 Jul 2006 22:08:58 -0000 1.1.1.1.2.46
@@ -234,7 +234,7 @@
* Platform macros:: Determining the platform
* Syscmd:: Executing simple commands
* Esyscmd:: Reading the output of commands
-* Sysval:: Exit codes
+* Sysval:: Exit status
* Maketemp:: Making names for temporary files
Miscellaneous builtin macros
@@ -592,6 +592,9 @@
the command line. It is an error if an input file ends in the middle of
argument collection 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, and 1 for failure.
+
If you need to read a file whose name starts with a @file{-}, you can
specify it as @samp{./-file}, or use @option{--} to mark the end of
options.
@@ -3605,7 +3608,7 @@
* Platform macros:: Determining the platform
* Syscmd:: Executing simple commands
* Esyscmd:: Reading the output of commands
-* Sysval:: Exit codes
+* Sysval:: Exit status
* Maketemp:: Making names for temporary files
@end menu
@@ -3730,14 +3733,13 @@
the command, as well as using the newline that appeared after the macro.
@node Sysval
[EMAIL PROTECTED] Exit codes
[EMAIL PROTECTED] Exit status
[EMAIL PROTECTED] exit code from UNIX commands
[EMAIL PROTECTED] UNIX commands, exit code from
[EMAIL PROTECTED] commands, exit code from UNIX
[EMAIL PROTECTED] exit code from shell commands
[EMAIL PROTECTED] shell commands, exit code from
[EMAIL PROTECTED] commands, exit code from shell
[EMAIL PROTECTED] UNIX commands, exit status from
[EMAIL PROTECTED] exit status from shell commands
[EMAIL PROTECTED] shell commands, exit status from
[EMAIL PROTECTED] commands, exit status from shell
[EMAIL PROTECTED] status of shell commands
To see whether a shell command succeeded, use @code{sysval}:
@deffn Builtin sysval
@@ -3904,12 +3906,13 @@
@section Exiting from @code{m4}
@cindex exiting from @code{m4}
[EMAIL PROTECTED] status, setting @code{m4} exit
If you need to exit from @code{m4} before the entire input has been
read, you can use @code{m4exit}:
@deffn Builtin m4exit (@dvar{code, 0})
-Causes @code{m4} to exit, with exit code @var{code}. If @var{code} is
-left out, the exit code is zero. No further input is read, and all
+Causes @code{m4} to exit, with exit status @var{code}. If @var{code} is
+left out, the exit status is zero. No further input is read, and all
wrapped and diverted text is discarded.
@end deffn
@@ -3930,7 +3933,7 @@
@error{}m4:stdin:4: fatal error: this is a BAD one, buster
@end example
-After this macro call, @code{m4} will exit with exit code 1. This macro
+After this macro call, @code{m4} will exit with exit status 1. This macro
is only intended for error exits, since the normal exit procedures are
not followed, e.g., diverted text is not undiverted, and saved text
(@pxref{M4wrap}) is not reread.
