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

doc/bashref.texi

@@ -1381,6 +1381,9 @@ Assignment statements may also appear as arguments to the
 @code{alias}, 
 @code{declare}, @code{typeset}, @code{export}, @code{readonly},
 and @code{local} builtin commands.
+When in @sc{posix} mode (@pxref{Bash POSIX Mode}), these builtins may appear
+in a command after one or more instances of the @code{command} builtin
+and retain these assignment statement properties.
 
 In the context where an assignment statement is assigning a value  
 to a shell variable or array index (@pxref{Arrays}), the @samp{+=}
@@ -2965,7 +2968,8 @@ If the @option{-e} option is supplied with @option{-P}
 and the current working directory cannot be successfully determined
 after a successful directory change, @code{cd} will return an unsuccessful
 status.
-If @var{directory} is @samp{-}, it is equivalent to @env{$OLDPWD}.
+If @var{directory} is @samp{-}, it is converted to @env{$OLDPWD}
+before the directory change is attempted.
 
 If a non-empty directory name from @env{CDPATH} is used, or if
 @samp{-} is the first argument, and the directory change is
@@ -6676,6 +6680,12 @@ the normal Bash files.
 Tilde expansion is only performed on assignments preceding a command
 name, rather than on all assignment statements on the line.
 
+@item
+The @code{command} builtin does not prevent builtins that take assignment
+statements as arguments from expanding them as assignment statements;
+when not in POSIX mode, assignment builtins lose their assignment
+statement expansion properties when preceded by @code{command}.
+
 @item
 The default history file is @file{~/.sh_history} (this is the
 default value of @env{$HISTFILE}).

doc/version.texi

@@ -2,9 +2,9 @@
 Copyright (C) 1988-2011 Free Software Foundation, Inc.
 @end ignore
 
-@set LASTCHANGE Thu Jul  7 07:34:57 EDT 2011
+@set LASTCHANGE Thu Jul 28 18:11:38 EDT 2011
 
 @set EDITION 4.2
 @set VERSION 4.2
-@set UPDATED 7 July 2011
+@set UPDATED 28 July 2011
 @set UPDATED-MONTH July 2011

doc/version.texi~

@@ -0,0 +1,10 @@
+@ignore
+Copyright (C) 1988-2011 Free Software Foundation, Inc.
+@end ignore
+
+@set LASTCHANGE Sun Jul 24 16:17:58 EDT 2011
+
+@set EDITION 4.2
+@set VERSION 4.2
+@set UPDATED 24 July 2011
+@set UPDATED-MONTH July 2011