diff -ur bash-3.2.orig/doc/bashref.texi bash-3.2.new/doc/bashref.texi --- bash-3.2.orig/doc/bashref.texi 2006-09-28 16:25:28.000000000 +0200 +++ bash-3.2.new/doc/bashref.texi 2006-11-25 19:44:35.000000000 +0100 @@ -5679,20 +5679,13 @@ @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 @@ -5704,12 +5697,20 @@ @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} @@ -5719,22 +5720,23 @@ 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}. + @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 [@var{dir} | @var{+N} | @var{-N}] [-n] +pushd [-n] [@var{dir} | @var{+N} | @var{-N}] @end example Save the current directory on the top of the directory stack @@ -5742,6 +5744,12 @@ With no arguments, @code{pushd} exchanges the top two directories. @table @code +@item -n +Suppresses the normal change of directory when adding directories +to the stack, so that only the stack is manipulated. +@item @var{dir} +Makes the current working directory be the top of the stack, and then +executes the equivalent of @code{cd @var{dir}}. @item +@var{N} Brings the @var{N}th directory (counting from the left of the list printed by @code{dirs}, starting with zero) to the top of @@ -5750,13 +5758,6 @@ Brings the @var{N}th directory (counting from the right of the list printed by @code{dirs}, starting with zero) to the top of the list by rotating the stack. -@item -n -Suppresses the normal change of directory when adding directories -to the stack, so that only the stack is manipulated. -@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}. @end table @end table