commit bash-20090609 snapshot

2026-07-13 07:00:49 +02:00 · 2011-12-08 20:10:49 -05:00
parent 4301bca7e9
commit 4a8bb13f3c
28 changed files with 6606 additions and 6278 deletions
@@ -3,7 +3,7 @@
 </HEAD>
 <BODY><TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2009 March 4<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2009 May 26<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <BR><A HREF="#index">Index</A>
@@ -984,7 +984,7 @@ operators do not evaluate <I>expression2</I> if the value of
 the entire conditional expression.
 </DL>

-<DT><B>for</B> <I>name</I> [ <B>in</B> <I>word</I> ] ; <B>do</B> <I>list</I> ; <B>done</B><DD>
+<DT><B>for</B> <I>name</I> [ [ <B>in</B> [ <I>word ...</I> ] ] ; ] <B>do</B> <I>list</I> ; <B>done</B><DD>
 The list of words following <B>in</B> is expanded, generating a list
 of items.
 The variable <I>name</I> is set to each element of this list
@@ -2576,8 +2576,8 @@ prompt.

 <DD>
 If set to a number greater than zero, the value is used as the number of
-trailing directory components to retain when expanding the <B>\w and
-\W</B> prompt string escapes (see
+trailing directory components to retain when expanding the <B>\w</B> and
+<B>\W</B> prompt string escapes (see
 <FONT SIZE=-1><B>PROMPTING</B>

 </FONT>
@@ -2866,13 +2866,17 @@ Referencing an array variable without a subscript is equivalent to
 referencing the array with a subscript of 0.
 <P>

+An array variable is considered set if a subscript has been assigned a
+value.  The null string is a valid value.
+<P>
+
 The
 <B>unset</B>

 builtin is used to destroy arrays.  <B>unset</B> <I>name</I>[<I>subscript</I>]
 destroys the array element at index <I>subscript</I>.
-Care must be taken to avoid unwanted side effects caused by filename
-generation.
+Care must be taken to avoid unwanted side effects caused by pathname
+expansion.
 <B>unset</B> <I>name</I>, where <I>name</I> is an array, or
 <B>unset</B> <I>name</I>[<I>subscript</I>], where
 <I>subscript</I> is <B>*</B> or <B>@</B>, removes the entire array.
@@ -3858,7 +3862,7 @@ The special pattern characters have the following meanings:
 <DD>
 Matches any string, including the null string.
 When the <B>globstar</B> shell option is enabled, and <B>*</B> is used in
-a filename expansion context, two adjacent <B>*</B>s used as a single
+a pathname expansion context, two adjacent <B>*</B>s used as a single
 pattern will match all files and zero or more directories and
 subdirectories.
 If followed by a <B>/</B>, two adjacent <B>*</B>s will match only directories
@@ -4625,9 +4629,11 @@ The first element of the
 </FONT>
 variable is set to the name of the function while the function
 is executing.
+<P>
+
 All other aspects of the shell execution
 environment are identical between a function and its caller
-with the exception that the
+with these exceptions:  the
 <FONT SIZE=-1><B>DEBUG</B>

 </FONT>
@@ -4649,7 +4655,13 @@ below) are not inherited unless the function has been given the
 builtin below) or the
 <B>-o functrace</B> shell option has been enabled with
 the <B>set</B> builtin
-(in which case all functions inherit the <B>DEBUG</B> and <B>RETURN</B> traps).
+(in which case all functions inherit the <B>DEBUG</B> and <B>RETURN</B> traps),
+and the
+<FONT SIZE=-1><B>ERR</B>
+
+</FONT>
+trap is not inherited unless the <B>-o errtrace</B> shell option has
+been enabled.
 <P>

 Variables local to the function may be declared with the
@@ -4989,11 +5001,9 @@ True if the strings are equal.  <B>=</B> may be used in place of
 <DT><I>string1</I> <B>!=</B> <I>string2</I><DD>
 True if the strings are not equal.
 <DT><I>string1</I> <B>&lt;</B> <I>string2</I><DD>
-True if <I>string1</I> sorts before <I>string2</I> lexicographically
-in the current locale.
+True if <I>string1</I> sorts before <I>string2</I> lexicographically.
 <DT><I>string1</I> <B>&gt;</B> <I>string2</I><DD>
-True if <I>string1</I> sorts after <I>string2</I> lexicographically
-in the current locale.
+True if <I>string1</I> sorts after <I>string2</I> lexicographically.
 <DT><I>arg1</I> <B>OP</B> <I>arg2</I>

 <DD>
@@ -7393,7 +7403,7 @@ variable
 is used to filter the matches.
 <P>

-Any completions specified by a filename expansion pattern to the
+Any completions specified by a pathname expansion pattern to the
 <B>-G</B> option are generated next.
 The words generated by the pattern need not match the word
 being completed.
@@ -8644,7 +8654,7 @@ Names of all shell variables.  May also be specified as <B>-v</B>.
 </DL></DL>

 <DT><B>-G</B> <I>globpat</I><DD>
-The filename expansion pattern <I>globpat</I> is expanded to generate
+The pathname expansion pattern <I>globpat</I> is expanded to generate
 the possible completions.
 <DT><B>-W</B> <I>wordlist</I><DD>
 The <I>wordlist</I> is split using the characters in the
@@ -8667,7 +8677,7 @@ of the
 </FONT>
 array variable.
 <DT><B>-X</B> <I>filterpat</I><DD>
-<I>filterpat</I> is a pattern as used for filename expansion.
+<I>filterpat</I> is a pattern as used for pathname expansion.
 It is applied to the list of possible completions generated by the
 preceding options and arguments, and each completion matching
 <I>filterpat</I> is removed from the list.
@@ -10988,7 +10998,7 @@ This option is enabled by default.
 <DT><B>globstar</B>

 <DD>
-If set, the pattern <B>**</B> used in a filename expansion context will
+If set, the pattern <B>**</B> used in a pathname expansion context will
 match a files and zero or more directories and subdirectories.
 If the pattern is followed by a <B>/</B>, only directories and
 subdirectories match.
@@ -11349,6 +11359,9 @@ Each
 is either
 a signal name defined in &lt;<I>signal.h</I>&gt;, or a signal number.
 Signal names are case insensitive and the SIG prefix is optional.
+<P>
+
+
 If a
 <I>sigspec</I>

@@ -11382,6 +11395,21 @@ Refer to the description of the <B>extdebug</B> option to the
 If a
 <I>sigspec</I>

+is
+<FONT SIZE=-1><B>RETURN</B>,
+
+</FONT>
+the command
+<I>arg</I>
+
+is executed each time a shell function or a script executed with the
+<B>.</B> or <B>source</B> builtins finishes executing.
+<P>
+
+
+If a
+<I>sigspec</I>
+
 is
 <FONT SIZE=-1><B>ERR</B>,

@@ -11417,21 +11445,12 @@ being inverted via
 <B>!</B>.

 These are the same conditions obeyed by the <B>errexit</B> option.
-If a
-<I>sigspec</I>
+<P>

-is
-<FONT SIZE=-1><B>RETURN</B>,

-</FONT>
-the command
-<I>arg</I>
-
-is executed each time a shell function or a script executed with the
-<B>.</B> or <B>source</B> builtins finishes executing.
 Signals ignored upon entry to the shell cannot be trapped or reset.
 Trapped signals that are not being ignored are reset to their original
-values in a child process when it is created.
+values in a subshell or subshell environment when one is created.
 The return status is false if any
 <I>sigspec</I>

@@ -12073,7 +12092,7 @@ There may be only one active coprocess at a time.
 <HR>
 <TABLE WIDTH=100%>
 <TR>
-<TH ALIGN=LEFT width=33%>GNU Bash-4.0<TH ALIGN=CENTER width=33%>2009 March 4<TH ALIGN=RIGHT width=33%>BASH(1)
+<TH ALIGN=LEFT width=33%>GNU Bash-4.0<TH ALIGN=CENTER width=33%>2009 May 26<TH ALIGN=RIGHT width=33%>BASH(1)
 </TR>
 </TABLE>
 <HR>
@@ -12179,6 +12198,6 @@ There may be only one active coprocess at a time.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 05 March 2009 07:55:02 EST
+Time: 08 June 2009 08:33:25 EDT
 </BODY>
 </HTML>