bash/bash-3.2-manpage.patch
2008-07-17 08:45:32 +00:00

65 lines
2.2 KiB
Diff

diff -up bash-3.2/doc/bash.1.manpage bash-3.2/doc/bash.1
--- bash-3.2/doc/bash.1.manpage 2008-07-15 13:11:39.000000000 +0200
+++ bash-3.2/doc/bash.1 2008-07-15 13:37:39.000000000 +0200
@@ -4139,6 +4139,9 @@ The
.I "previous job"
may be referenced using
.BR %\- .
+When there is the current job only,
+.BR %\-
+refers to the shell's notion of the current job.
In output pertaining to jobs (e.g., the output of the
.B jobs
command), the current job is always flagged with a
@@ -6105,10 +6108,9 @@ loop. If \fIn\fP is specified, break \f
must be \(>= 1. If
.I n
is greater than the number of enclosing loops, all enclosing loops
-are exited. The return value is 0 unless the shell is not executing
-a loop when
-.B break
-is executed.
+are exited. The return value is non-zero when
+.I n
+is \(<= 0; Otherwise, break returns 0 value.
.TP
\fBbuiltin\fP \fIshell\-builtin\fP [\fIarguments\fP]
Execute the specified shell builtin, passing it
@@ -6448,10 +6450,11 @@ is specified, resume at the \fIn\fPth en
must be \(>= 1. If
.I n
is greater than the number of enclosing loops, the last enclosing loop
-(the ``top-level'' loop) is resumed. The return value is 0 unless the
-shell is not executing a loop when
-.B continue
-is executed.
+(the ``top-level'' loop) is resumed. When continue is executed inside
+of loop, the return value is non-zero when
+.I n
+is \(<= 0; Otherwise, continue returns 0 value.
+When continue is executed outside of loop, the return value is 0.
.TP
\fBdeclare\fP [\fB\-afFirtx\fP] [\fB\-p\fP] [\fIname\fP[=\fIvalue\fP] ...]
.PD 0
@@ -8217,7 +8220,9 @@ by default.
Suspend the execution of this shell until it receives a
.SM
.B SIGCONT
-signal. The
+signal. When the suspended shell is a background process, it can be restarted by the fg command. For more information, read the
+.B JOB CONTROL
+section. The
.B \-f
option says not to complain if this is
a login shell; just suspend anyway. The return status is 0 unless
@@ -8901,5 +8907,9 @@ unmatched parentheses, even inside shell
error messages while the construct is being read.
.PP
Array variables may not (yet) be exported.
+.PP
+When breaking out of multiple loops, if the outermost loop
+consists of more than one command, the exit status of break and continue
+is lost.
.zZ
.zY