Variable: eshell-last-dir-ring-size

eshell-last-dir-ring-size is a customizable variable defined in em-dirs.el.gz.

Value

32

Documentation

If non-nil, the size of the directory history ring.

This ring is added to every time cd or pushd is used. It simply stores the most recent directory locations Eshell has been in. To return to the most recent entry, use cd - (equivalent to cd -0). To return to an older entry, use cd -N, where N is an integer less than eshell-last-dir-ring-size. To return to the last directory matching a particular regexp, use cd =REGEXP. To display the directory history list, use cd =.

This mechanism is very similar to that provided by pushd, except it's far more automatic. pushd allows the user to decide which directories gets pushed, and its size is unlimited.

eshell-last-dir-ring is meant for users who don't use pushd explicitly very much, but every once in a while would like to return to a previously visited directory without having to type in the whole thing again.

Source Code

;; Defined in /usr/src/emacs/lisp/eshell/em-dirs.el.gz
(defcustom eshell-last-dir-ring-size 32
  "If non-nil, the size of the directory history ring.
This ring is added to every time `cd' or `pushd' is used.  It simply
stores the most recent directory locations Eshell has been in.  To
return to the most recent entry, use `cd -' (equivalent to `cd -0').
To return to an older entry, use `cd -N', where N is an integer less
than `eshell-last-dir-ring-size'.  To return to the last directory
matching a particular regexp, use `cd =REGEXP'.  To display the
directory history list, use `cd ='.

This mechanism is very similar to that provided by `pushd', except
it's far more automatic.  `pushd' allows the user to decide which
directories gets pushed, and its size is unlimited.

`eshell-last-dir-ring' is meant for users who don't use `pushd'
explicitly very much, but every once in a while would like to return to
a previously visited directory without having to type in the whole
thing again."
  :type 'integer)