mirror of
https://github.com/dcarrillo/prezto.git
synced 2024-09-07 11:22:38 +00:00
Zsh and Prezto files don't always reside in `~/`. Instead, they have a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them unambiguous in the documentation. Likewise, for `$GNUPGHOME`. Further, add instruction for optionally setting up Prezto in `$XDG_CONFIG_HOME`. While at this, also add clarification on relative ordering of some of the modules, apply more formatting tweaks and doc improvements.
51 lines
2.0 KiB
Markdown
51 lines
2.0 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]: https://zsh.sourceforge.net/Guide/zshguide02.html#l16
|
|
[2]: https://github.com/sorin-ionescu/prezto/issues
|