File: em-dirs.el.html

The only special feature that Eshell offers in the last-dir-ring.

To view the ring, enter:

  cd =

Changing to an index within the ring is done using:

  cd - ; same as cd -0
  cd -4

Or, it is possible to change the first member in the ring which matches a regexp:

  cd =bcc ; change to the last directory visited containing "bcc"

This ring is maintained automatically, and is persisted across Eshell sessions. It is a separate mechanism from pushd and popd, and the two may be used at the same time.

Defined variables (16)

eshell-ask-to-save-last-dirDetermine if the last-dir-ring should be automatically saved.
eshell-cd-on-directoryIf non-nil, do a cd if a directory is in command position.
eshell-cd-shows-directoryIf non-nil, using ‘cd’ will report the directory it changes to.
eshell-directory-change-hookA hook to run when the current directory changes.
eshell-dirs-load-hookA hook that gets run when ‘eshell-dirs’ is loaded.
eshell-dirstackList of directories saved by pushd in the Eshell buffer.
eshell-dirtrack-verboseIf non-nil, show the directory stack following directory change.
eshell-last-dir-ringThe last directory that Eshell was in.
eshell-last-dir-ring-file-nameIf non-nil, name of the file to read/write the last-dir-ring.
eshell-last-dir-ring-sizeIf non-nil, the size of the directory history ring.
eshell-last-dir-uniqueIf non-nil, ‘eshell-last-dir-ring’ contains only unique entries.
eshell-list-files-after-cdIf non-nil, call "ls" with any remaining args after doing a cd.
eshell-pushd-dextractIf non-nil, make "pushd +n" pop the nth dir to the stack top.
eshell-pushd-duniqueIf non-nil, make pushd only add unique directories to the stack.
eshell-pushd-tohomeIf non-nil, make pushd with no arg behave as ‘pushd ~’ (like ‘cd’).
eshell-pwd-convert-functionThe function used to normalize the value of Eshell’s ‘pwd’.

Defined functions (17)

eshell-add-to-dir-ring(PATH)
eshell-complete-user-reference()
eshell-dirs-initialize()
eshell-dirs-substitute-cd(&rest ARGS)
eshell-expand-multiple-dots(FILENAME)
eshell-find-previous-directory(REGEXP)
eshell-lone-directory-p(FILE)
eshell-parse-drive-letter()
eshell-parse-user-reference()
eshell-read-last-dir-ring()
eshell-save-some-last-dir()
eshell-write-last-dir-ring()
eshell/cd(&rest ARGS)
eshell/dirs(&optional IF-VERBOSE)
eshell/popd(&rest ARGS)
eshell/pushd(&rest ARGS)
eshell/pwd(&rest ARGS)

Defined faces (0)