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 [+@var{N} | -@var{N}] [-clpv] +dirs [-clpv] [+@var{N} | -@var{N}] @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 -@item +@var{N} -Displays the @var{N}th directory (counting from the left of the -list printed by @code{dirs} when invoked without options), starting -with zero. -@item -@var{N} -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. +@item +@var{N} +Displays the @var{N}th directory (counting from the left of the +list printed by @code{dirs} when invoked without options), starting +with zero. +@item -@var{N} +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 [+@var{N} | -@var{N}] [-n] +popd [-n] [+@var{N} | -@var{N}] @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 -@code{dirs}; i.e., @code{popd} is equivalent to @code{popd +0}. +@code{dirs}; this means that @code{popd} is equivalent to @code{popd +0}. + @table @code +@item -n +Suppresses the normal change of directory when removing directories +from the stack, so that only the stack is manipulated. @item +@var{N} Removes the @var{N}th directory (counting from the left of the list printed by @code{dirs}), starting with zero. @item -@var{N} Removes the @var{N}th directory (counting from the right of the list printed by @code{dirs}), starting with zero. -@item -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] [@var{+N} | @var{-N} | @var{dir} ] +pushd [-n] [@var{+N} | @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 `@code{cd} @var{dir}'. -@code{cd}s to @var{dir}. +executes the equivalent of @code{cd @var{dir}}. @end table @end table