1
0
mirror of https://github.com/dcarrillo/prezto.git synced 2024-12-22 20:57:59 +00:00
prezto/modules/history/README.md
Indrajit Raychaudhuri 1ff9421f7b general: Update documentation better qualifying runcom paths
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.
2021-05-21 12:31:02 -05:00

2.0 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

Authors

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