dcarrillo/prezto
1
0
Fork 0
mirror of https://github.com/dcarrillo/prezto.git synced 2024-11-14 17:41:13 +00:00
Code Issues Releases Wiki Activity
master
prezto/modules/history/README.md
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

2.6 KiB
Raw Permalink Blame History

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.