dcarrillo/prezto
1
0
Fork 0
mirror of https://github.com/dcarrillo/prezto.git synced 2024-12-22 04:38:01 +00:00
Code Issues Releases Wiki Activity
5ac930d96b
prezto/modules/history
History
Indrajit Raychaudhuri 8ee9d1bbfe general: Documentation update for zstyle based alias skipping support 
Add documentation to surface the `zstyle` based alias skipping.
2023-05-17 02:39:09 -05:00
..
init.zsh history: Reformat inline comments 2023-05-17 02:38:50 -05:00
README.md general: Documentation update for zstyle based alias skipping support 2023-05-17 02:39:09 -05:00

README.md

History

Sets history 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

Aliases are enabled by default. To disable them, add the following to ${ZDOTDIR:-$HOME}/.zpreztorc.

zstyle ':prezto:module:history:alias' skip 'yes'
  • history-stat lists the ten most used commands

Settings

histfile

Can be configured either by setting HISTFILE manually before loading this module or by using zstyle:

zstyle ':prezto:module:history' histfile "<file_name>"

defaults to "${ZDOTDIR:-$HOME}/.zsh_history".

histsize

zstyle ':prezto:module:history' histsize <number>

defaults to 10000.

savehist

zstyle ':prezto:module:history' savehist <number>

defaults to histsize

Authors

The authors of this module should be contacted via the issue tracker.