commit bash-20110720 snapshot

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet@po.cwru.edu
 .\"
-.\"	Last Change: Thu Jul  7 07:26:51 EDT 2011
+.\"	Last Change: Thu Jul 28 18:11:21 EDT 2011
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2011 July 7" "GNU Bash 4.2"
+.TH BASH 1 "2011 July 28" "GNU Bash 4.2"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -1207,6 +1207,9 @@ Assignment statements may also appear as arguments to the
 and
 .B local
 builtin commands.
+When in \fIposix mode\fP, these builtins may appear in a command after
+one or more instances of the \fBcommand\fP builtin and retain these
+assignment statement properties.
 .PP
 In the context where an assignment statement is assigning a value
 to a shell variable or array index, the += operator can be used to
@@ -3376,7 +3379,8 @@ Each redirection that may be preceded by a file descriptor number
 may instead be preceded by a word of the form {\fIvarname\fP}.
 In this case, for each redirection operator except
 >&- and <&-, the shell will allocate a file descriptor greater
-than 10 and assign it to \fIvarname\fP.  If >&- or <&- is preceded
+than or equal to 10 and assign it to \fIvarname\fP.
+If >&- or <&- is preceded
 by {\fIvarname\fP}, the value of \fIvarname\fP defines the file
 descriptor to close.
 .PP
@@ -6852,9 +6856,10 @@ after a successful directory change, \fBcd\fP will return an unsuccessful
 status.
 An argument of
 .B \-
-is equivalent to
+is converted to
 .SM
-.BR $OLDPWD .
+.B $OLDPWD
+before the directory change is attempted.
 If a non-empty directory name from
 .SM
 .B CDPATH
@@ -8259,7 +8264,8 @@ starting with zero) is at the top.
 Adds
 .I dir
 to the directory stack at the top, making it the
-new current working directory.
+new current working directory as if it had been supplied as the argument
+to the \fBcd\fP builtin.
 .PD
 .PP
 If the