diff options
| author | Marc Cornellà <marc@mcornella.com> | 2025-03-20 20:28:39 +0100 |
|---|---|---|
| committer | Marc Cornellà <marc@mcornella.com> | 2025-03-20 20:29:47 +0100 |
| commit | 407be8f0368379892f7c0d5a3994bfca74e06969 (patch) | |
| tree | 57ae5b12983214e514774d4c70da2107f484f368 /plugins/dirhistory | |
| parent | 22ec00d1f62ffe9c5e04d6eefc49be40e082407d (diff) | |
| download | zsh-407be8f0368379892f7c0d5a3994bfca74e06969.tar.gz zsh-407be8f0368379892f7c0d5a3994bfca74e06969.tar.bz2 zsh-407be8f0368379892f7c0d5a3994bfca74e06969.zip | |
feat(dirhistory): preserve forward directories with `cde` alias (#9328)
Closes #11954
Co-authored-by: Jeff Williams <jeffsmessages@gmail.com>
Diffstat (limited to 'plugins/dirhistory')
| -rw-r--r-- | plugins/dirhistory/README.md | 43 | ||||
| -rw-r--r-- | plugins/dirhistory/dirhistory.plugin.zsh | 3 |
2 files changed, 45 insertions, 1 deletions
diff --git a/plugins/dirhistory/README.md b/plugins/dirhistory/README.md index ede9b5410..66e3e0469 100644 --- a/plugins/dirhistory/README.md +++ b/plugins/dirhistory/README.md @@ -60,3 +60,46 @@ to `/usr` again. After that, <kbd>Alt</kbd> + <kbd>Down</kbd> will probably go to `/usr/bin` if `bin` is the first directory in alphabetical order (depends on your `/usr` folder structure). <kbd>Alt</kbd> + <kbd>Up</kbd> will return to `/usr`, and once more will get you to the root folder (`/`). + +### cde + +This plugin also provides a `cde` alias that allows you to change to a directory without clearing the next directory stack. +This changes the default behavior of `dirhistory`, which is to clear the next directory stack when changing directories. + +For example, if the shell was started, and the following commands were entered: + +```shell +cd ~ +cd /usr +cd share +cd doc + +# <Alt + Left> +# <Alt + Left> +``` + +The directory stack would look like this: + +```sh +➜ /usr typeset -pm dirhistory_\* +typeset -ax dirhistory_past=( /home/user /usr ) +typeset -ax dirhistory_future=( /usr/share/doc /usr/share ) +``` + +This means that pressing <kbd>Alt</kbd> + <kbd>Right</kbd>, you'd go to `/usr/share` and `/usr/share/doc` (the "future" directories). + +If you run `cd /usr/bin`, the "future" directories will be removed, and you won't be able to access them with <kbd>Alt</kbd> + <kbd>Right</kbd>: + +```sh +➜ /u/bin typeset -pm dirhistory_\* +typeset -ax dirhistory_past=( /home/user /usr ) +typeset -ax dirhistory_future=( /usr/bin ) +``` + +If you instead run `cde /usr/bin`, the "future" directories will be preserved: + +```sh +➜ /u/bin typeset -pm dirhistory_\* +typeset -ax dirhistory_past=( /home/user /usr /usr/bin ) +typeset -ax dirhistory_future=( /usr/share/doc /usr/share ) +``` diff --git a/plugins/dirhistory/dirhistory.plugin.zsh b/plugins/dirhistory/dirhistory.plugin.zsh index 4650666be..706bb6fb2 100644 --- a/plugins/dirhistory/dirhistory.plugin.zsh +++ b/plugins/dirhistory/dirhistory.plugin.zsh @@ -11,9 +11,10 @@ dirhistory_past=($PWD) dirhistory_future=() export dirhistory_past export dirhistory_future - export DIRHISTORY_SIZE=30 +alias cde='dirhistory_cd' + # Pop the last element of dirhistory_past. # Pass the name of the variable to return the result in. # Returns the element if the array was not empty, |