You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
50 lines
2.3 KiB
50 lines
2.3 KiB
# per-directory-history plugin |
|
|
|
This plugin adds per-directory history for zsh, as well as a global history, |
|
and the ability to toggle between them with a keyboard shortcut. This is a |
|
bundle of the [official plugin by @jimhester][5]. |
|
|
|
To use it, add `per-directory-history` to the plugins array in your zshrc file: |
|
|
|
```zsh |
|
plugins=(... per-directory-history) |
|
``` |
|
|
|
This is an implementation of per-directory history for zsh, some implementations |
|
of which exist in bash[1][],[2][]. It also implements a toggle-history function |
|
to change from using the directory history to using the global history. In both |
|
cases the history is always saved to both the global history and the directory |
|
history, so the toggle state will not effect the saved histories. Being able to |
|
switch between global and directory histories on the fly is a novel feature. |
|
|
|
## Usage |
|
|
|
The default mode is per directory history, interact with your history as normal. |
|
|
|
Press ^G (the <kbd>Control</kbd> and <kbd>G</kbd> keys simultaneously) to toggle |
|
between local and global histories. If you would prefer a different shortcut to |
|
toggle set the `PER_DIRECTORY_HISTORY_TOGGLE` environment variable. |
|
|
|
## Configuration |
|
|
|
* `HISTORY_BASE` is a global variable that defines the base directory in which the |
|
directory histories are stored (default `$HOME/.directory_history`). |
|
* `per-directory-history-toggle-history` is the function to toggle between local |
|
and global histories. |
|
* `PER_DIRECTORY_HISTORY_TOGGLE` is the key binding used to run the toggle-history |
|
function above (default `^G`) |
|
* `PER_DIRECTORY_HISTORY_PRINT_MODE_CHANGE` is a variable which toggles whether |
|
the current mode is printed to the screen following a mode change (default `true`) |
|
* `HISTORY_START_WITH_GLOBAL` is a global variable that defines how to start the plugin: global or local (default `false`) |
|
|
|
## History |
|
|
|
The idea/inspiration for a per directory history is from [Stewart MacArthur][1] |
|
and [Dieter][2], the implementation idea is from [Bart Schaefer][3]. The |
|
implementation is by [Jim Hester][4] in September 2012. |
|
|
|
[1]: http://www.compbiome.com/2010/07/bash-per-directory-bash-history.html |
|
[2]: http://dieter.plaetinck.be/per_directory_bash |
|
[3]: https://www.zsh.org/mla/users/1997/msg00226.html |
|
[4]: https://jimhester.com |
|
[5]: https://github.com/jimhester/per-directory-history
|
|
|