[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: |
Sat, 15 Jul 2006 22:08:59 +0000 |
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
address@hidden Exit codes
address@hidden Exit status
address@hidden exit code from UNIX commands
address@hidden UNIX commands, exit code from
address@hidden commands, exit code from UNIX
address@hidden exit code from shell commands
address@hidden shell commands, exit code from
address@hidden commands, exit code from shell
address@hidden UNIX commands, exit status from
address@hidden exit status from shell commands
address@hidden shell commands, exit status from
address@hidden commands, exit status from shell
address@hidden 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}
address@hidden 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.
- Changes to m4/doc/m4.texinfo,v [branch-1_4], (continued)
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/11
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/12
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/12
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/13
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/13
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/13
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/14
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/14
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/14
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/14
- 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/07/17
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/17
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/19
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/19
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/19
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/24
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/26
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/27
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/27
- Changes to m4/doc/m4.texinfo,v [branch-1_4], Eric Blake, 2006/07/30