diff options
| author | Marc Cornellà <marc.cornella@live.com> | 2020-03-11 19:57:46 +0100 |
|---|---|---|
| committer | Marc Cornellà <marc.cornella@live.com> | 2020-03-11 19:57:46 +0100 |
| commit | 610b2529d2213a70e3d1153a9baf046c22f298b9 (patch) | |
| tree | 75278ef17f12844d6810a40250b4f93abd5dd86c /plugins/dirhistory/README.md | |
| parent | ff6d111d793970fc522dd3743367a4c3c46f5fc2 (diff) | |
| download | zsh-610b2529d2213a70e3d1153a9baf046c22f298b9.tar.gz zsh-610b2529d2213a70e3d1153a9baf046c22f298b9.tar.bz2 zsh-610b2529d2213a70e3d1153a9baf046c22f298b9.zip | |
Clean up plugin READMEs and a few plugins
- fasd
- history
- mercurial
- pylint
- repo
- yii2
Diffstat (limited to 'plugins/dirhistory/README.md')
| -rw-r--r-- | plugins/dirhistory/README.md | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/plugins/dirhistory/README.md b/plugins/dirhistory/README.md index 511f2be17..223650727 100644 --- a/plugins/dirhistory/README.md +++ b/plugins/dirhistory/README.md @@ -7,6 +7,7 @@ To use it, add `dirhistory` to the plugins array in your zshrc file: ```zsh plugins=(... dirhistory) ``` + ## Keyboard Shortcuts | Shortcut | Description | @@ -15,3 +16,24 @@ plugins=(... dirhistory) | <kbd>alt</kbd> + <kbd>right</kbd> | Undo <kbd>alt</kbd> + <kbd>left</kbd> | | <kbd>alt</kbd> + <kbd>up</kbd> | Move into the parent directory | | <kbd>alt</kbd> + <kbd>down</kbd> | Move into the first child directory by alphabetical order | + +## Usage + +This plugin allows you to navigate the history of previous current-working-directories using ALT-LEFT and ALT-RIGHT. ALT-LEFT moves back to directories that the user has changed to in the past, and ALT-RIGHT undoes ALT-LEFT. MAC users may alternately use OPT-LEFT and OPT-RIGHT. + +Also, navigate directory **hierarchy** using ALT-UP and ALT-DOWN. (mac keybindings not yet implemented). ALT-UP moves to higher hierarchy (shortcut for 'cd ..'). ALT-DOWN moves into the first directory found in alphabetical order (useful to navigate long empty directories e.g. java packages) + +For example, if the shell was started, and the following commands were entered: + +```shell +cd ~ +cd /usr +cd share +cd doc +``` + +Then entering ALT-LEFT at the prompt would change directory from /usr/share/doc to /usr/share, then if pressed again to /usr/, then ~. If ALT-RIGHT were pressed the directory would be changed to /usr/ again. + +After that, ALT-DOWN will probably go to /usr/bin (depends on your /usr structure), ALT-UP will return to /usr, then ALT-UP will get you to / + +**Currently the max history size is 30**. The navigation should work for xterm, PuTTY xterm mode, GNU screen, and on MAC with alternate keys as mentioned above. |