prezto/modules/history
Indrajit Raychaudhuri 509c5ca80f history: Move HISTFILE path to more conventional one
Change default `HISTFILE` path from `~/.zhistory` to more conventional
`~/.zsh_history`. This aligns better with Debian variants, macOS and
Oh My Zsh.

This would provide an easier onboarding experience to users coming to
Prezto from standard (framework free) zsh or from Oh My Zsh.

For existing Prezto users, we attempt to automatically rename old
`HISTFILE` to new one iff the old one exists and the new one doesn't.
However, if both old and new `HISTFILE` exist and the old one is more
recent, we just alert the user about what changed with a suggested way
to accommodate the change.
2021-05-02 03:35:12 -05:00
..
init.zsh history: Move HISTFILE path to more conventional one 2021-05-02 03:35:12 -05:00
README.md history: Move HISTFILE path to more conventional one 2021-05-02 03:35:12 -05:00

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.