commit bash-20111021 snapshot

doc/bash.1

@@ -8490,8 +8490,11 @@ that script and return either
 .I n
 or the exit status of the last command executed within the
 script as the exit status of the script.
+If \fIn\fP is supplied, the return value is its least significant
+8 bits.
 The return status is non-zero if
 .B return
+is supplied a non-numeric argument, or
 is used outside a
 function and not during execution of a script by \fB.\fP\^ or \fBsource\fP.
 Any command associated with the \fBRETURN\fP trap is executed

doc/bash.1~

@@ -3560,7 +3560,10 @@ This is semantically equivalent to
 \fB>\fP\fIword\fP 2\fB>&\fP1
 .RE
 .PP
-(see \fBDuplicating File Descriptors\fP below).
+When using the second form, \fIword\fP may not expand to a number or
+\fB\-\fP.  If it does, other redirection operators apply
+(see \fBDuplicating File Descriptors\fP below) for compatibility
+reasons.
 .SS Appending Standard Output and Standard Error
 .PP
 This construct allows both the

doc/bashref.texi

@@ -3219,9 +3219,12 @@ being executed with the @code{.} (@code{source}) builtin,
 returning either @var{n} or
 the exit status of the last command executed within the script as the exit
 status of the script.
+If @var{n} is supplied, the return value is its least significant
+8 bits.
 Any command associated with the @code{RETURN} trap is executed
 before execution resumes after the function or script.
-The return status is non-zero if @code{return} is used outside a function
+The return status is non-zero if @code{return} is supplied a non-numeric
+argument or is used outside a function
 and not during the execution of a script by @code{.} or @code{source}.
 
 @item shift

doc/bashref.texi~

@@ -2358,7 +2358,9 @@ This is semantically equivalent to
 @example
 >@var{word} 2>&1
 @end example
-(see Duplicating File Descriptors below).
+When using the second form, @var{word} may not expand to a number or
+@samp{-}.  If it does, other redirection operators apply
+(see Duplicating File Descriptors below) for compatibility reasons.
 
 @subsection Appending Standard Output and Standard Error
 This construct allows both the