diff -u bash-4.2.is/doc/bashref.texi bash-4.2.new/doc/bashref.texi
--- bash-4.2.is/doc/bashref.texi	2011-09-11 11:24:50.000000000 +0200
+++ bash-4.2.new/doc/bashref.texi	2011-09-11 11:43:44.000000000 +0200
@@ -2710,7 +2710,7 @@
 not just those that precede the command name.
 
 When Bash invokes an external command, the variable @samp{$_}
-is set to the full path name of the command and passed to that
+is set to the full pathname of the command and passed to that
 command in its environment.
 
 @node Exit Status
@@ -6407,38 +6407,40 @@
 @item dirs
 @btindex dirs
 @example
-dirs address@hidden | address@hidden [-clpv]
+dirs [-clpv] address@hidden | address@hidden
 @end example
 
 Display the list of currently remembered directories.  Directories
 are added to the list with the @code{pushd} command; the
 @code{popd} command removes directories from the list.
+
 @table @code
address@hidden address@hidden
-Displays the @var{N}th directory (counting from the left of the
-list printed by @code{dirs} when invoked without options), starting
-with zero.
address@hidden address@hidden
-Displays the @var{N}th directory (counting from the right of the
-list printed by @code{dirs} when invoked without options), starting
-with zero.
 @item -c
 Clears the directory stack by deleting all of the elements.
 @item -l
-Produces a longer listing; the default listing format uses a 
-tilde to denote the home directory.
+Produces a longer listing by printing the pathnames in full; the
+default format abbreviates the names by using a tilde to denote
+the home directory.
 @item -p
 Causes @code{dirs} to print the directory stack with one entry per
 line.
 @item -v
 Causes @code{dirs} to print the directory stack with one entry per
 line, prefixing each entry with its index in the stack.
address@hidden address@hidden
+Displays the @var{N}th directory (counting from the left of the
+list printed by @code{dirs} when invoked without options), starting
+with zero.
address@hidden address@hidden
+Displays the @var{N}th directory (counting from the right of the
+list printed by @code{dirs} when invoked without options), starting
+with zero.
 @end table
 
 @item popd
 @btindex popd
 @example
-popd address@hidden | address@hidden [-n]
+popd [-n] address@hidden | address@hidden
 @end example
 
 Remove the top entry from the directory stack, and @code{cd}
@@ -6447,23 +6449,24 @@
 removes the top directory from the stack and
 performs a @code{cd} to the new top directory.  The
 elements are numbered from 0 starting at the first directory listed with
address@hidden; i.e., @code{popd} is equivalent to @code{popd +0}.
address@hidden; this means that @code{popd} is equivalent to @code{popd +0}.
+
 @table @code
address@hidden -n
+Suppresses the normal change of directory when removing directories
+from the stack, so that only the stack is manipulated.
 @item address@hidden
 Removes the @var{N}th directory (counting from the left of the
 list printed by @code{dirs}), starting with zero.
 @item address@hidden
 Removes the @var{N}th directory (counting from the right of the
 list printed by @code{dirs}), starting with zero.
address@hidden -n
-Suppresses the normal change of directory when removing directories
-from the stack, so that only the stack is manipulated.
 @end table
 
 @btindex pushd
 @item pushd
 @example
-pushd [-n] address@hidden | @var{-N} | @var{dir} ]
+pushd [-n] address@hidden | @var{-N} | @var{dir}]
 @end example
 
 Save the current directory on the top of the directory stack
@@ -6484,8 +6487,7 @@
 the list by rotating the stack.
 @item @var{dir}
 Makes the current working directory be the top of the stack, and then
-executes the equivalent of address@hidden @var{dir}'.
address@hidden to @var{dir}.
+executes the equivalent of @code{cd @var{dir}}.
 @end table
 @end table