allow assignment to array keys @ and *; minor completion fix

2 files changed, 12 insertions, 7 deletions

diff --git a/doc/bash.1 b/doc/bash.1
index 0c57056f..4dd91545 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -9160,9 +9160,11 @@ is empty, or a non-existent directory stack entry is specified.
 .PP
 If the
 .B popd
-command is successful, a
+command is successful,
+bash runs
 .B dirs
-is performed as well, and the return status is 0.
+to show the final contents of the directory stack,
+and the return status is 0.
 .RE
 .TP
 \fBprintf\fP [\fB\-v\fP \fIvar\fP] \fIformat\fP [\fIarguments\fP]
@@ -9271,9 +9273,10 @@ a non-existent directory stack element is specified.
 .PP
 If the
 .B pushd
-command is successful, a
+command is successful,
+bash runs
 .B dirs
-is performed as well.
+to show the final contents of the directory stack.
 .RE
 .TP
 \fBpwd\fP [\fB\-LP\fP]
diff --git a/doc/bashref.texi b/doc/bashref.texi
index 7dbdb29a..3e408c0a 100644
--- a/doc/bashref.texi
+++ b/doc/bashref.texi
@@ -7720,8 +7720,9 @@ Otherwise, @code{popd} returns an unsuccessful status if
 an invalid option is encountered, the directory stack
 is empty, or a non-existent directory stack entry is specified.
 
-If the @code{popd} command is successful, a @code{dirs}
-is performed as well, and the return status is 0.
+If the @code{popd} command is successful,
+Bash runs @code{dirs} to show the final contents of the directory stack,
+and the return status is 0.
 
 @btindex pushd
 @item pushd
@@ -7764,7 +7765,8 @@ When rotating the directory stack, @code{pushd} returns 0 unless
 the directory stack is empty or a non-existent directory stack element
 is specified.
 
-If the @code{pushd} command is successful, a @code{dirs} is performed as well.
+If the @code{pushd} command is successful,
+Bash runs @code{dirs} to show the final contents of the directory stack.
 
 @end table