mirror of
https://github.com/dcarrillo/prezto.git
synced 2024-12-23 03:27:59 +00:00
509c5ca80f
Change default `HISTFILE` path from `~/.zhistory` to more conventional `~/.zsh_history`. This aligns better with Debian variants, macOS and Oh My Zsh. This would provide an easier onboarding experience to users coming to Prezto from standard (framework free) zsh or from Oh My Zsh. For existing Prezto users, we attempt to automatically rename old `HISTFILE` to new one iff the old one exists and the new one doesn't. However, if both old and new `HISTFILE` exist and the old one is more recent, we just alert the user about what changed with a suggested way to accommodate the change.
54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
History
|
|
=======
|
|
|
|
Sets [history][1] options and defines history aliases.
|
|
|
|
**Note:** Default path of `HISTFILE` has changed from `${ZDOTDIR:-$HOME}/.zhistory`
|
|
to `${ZDOTDIR:-$HOME}/.zsh_history`. The file will be automatically renamed if
|
|
possible (when the new one doesn't exist). Otherwise, if you want to preserve
|
|
previous history, you will need to move them from `${ZDOTDIR:-$HOME}/.zhistory`
|
|
to `${ZDOTDIR:-$HOME}/.zsh_history`.
|
|
|
|
Alternately, you can set `HISTFILE` manually to `${ZDOTDIR:-$HOME}/.zhistory`.
|
|
|
|
Options
|
|
-------
|
|
|
|
- `BANG_HIST` treats the **!** character specially during expansion.
|
|
- `EXTENDED_HISTORY` writes the history file in the *:start:elapsed;command* format.
|
|
- `SHARE_HISTORY` shares history between all sessions. Note that
|
|
`SHARE_HISTORY`, `INC_APPEND_HISTORY`, and `INC_APPEND_HISTORY_TIME` are
|
|
mutually exclusive.
|
|
- `HIST_EXPIRE_DUPS_FIRST` expires a duplicate event first when trimming history.
|
|
- `HIST_IGNORE_DUPS` does not record an event that was just recorded again.
|
|
- `HIST_IGNORE_ALL_DUPS` deletes an old recorded event if a new event is a duplicate.
|
|
- `HIST_FIND_NO_DUPS` does not display a previously found event.
|
|
- `HIST_IGNORE_SPACE` does not record an event starting with a space.
|
|
- `HIST_SAVE_NO_DUPS` does not write a duplicate event to the history file.
|
|
- `HIST_VERIFY` does not execute immediately upon history expansion.
|
|
- `HIST_BEEP` beeps when accessing non-existent history.
|
|
|
|
Variables
|
|
---------
|
|
|
|
- `HISTFILE` stores the path to the history file.
|
|
- `HISTSIZE` stores the maximum number of events to save in the internal history.
|
|
- `SAVEHIST` stores the maximum number of events to save in the history file.
|
|
|
|
Aliases
|
|
-------
|
|
|
|
- `history-stat` lists the ten most used commands
|
|
|
|
Authors
|
|
-------
|
|
|
|
*The authors of this module should be contacted via the [issue tracker][2].*
|
|
|
|
- [Robby Russell](https://github.com/robbyrussell)
|
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
- [Indrajit Raychaudhuri](https://github.com/indrajitr)
|
|
|
|
[1]: http://zsh.sourceforge.net/Guide/zshguide02.html#l16
|
|
[2]: https://github.com/sorin-ionescu/prezto/issues
|