prezto/modules/history/README.md

2.5 KiB

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

  • 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.