History Options

$history

Description:

Number of history entries to keep in memory per category

Type:

Number

Notes:

Not Negative

Default:

set history = 10

Control the size (in number of strings remembered) of the string history buffer per category. The buffer is cleared each time the option is set.

Note

Strings (e.g. commands) starting with a space are never recorded in the history. This is for example useful to prevent leaking sensitive information into the history file or for one off tests.

Note

A string is not added to the history if it exactly matches its immediate predecessor, e.g. executing the same command twice in a row results in only one copy being added to the history. To prevent duplicates over all entries use $history_remove_dups.

---

$history_file

Description:

File to save history in

Type:

Path (String)

Notes:

File only

Default:

set history_file = "~/.mutthistory"

The file in which NeoMutt will save its history.

See also

$save_history

---

$history_format

Description:

Format string for the History Dialog

Type:

Expando

Notes:

Pipe Support

Default:

set history_format = "%s"

Alternative:

set history_format = "%{match}"

Specify the format of the data displayed in the History Dialog.

Format Sequences

Short	Long Name	Description
%C	%{number}	Line number
%s	%{match}	History match
%*X	%{padding-soft:X}	Soft-fill with character X as padding
%>X	%{padding-hard:X}	Right justify the rest of the string and pad with character X
%|X	%{padding-eol:X}	Pad to the end of the line with character X

See also

Expandos: Tutorial Conditional, Howto Conditional, Formatting, Reference

---

$history_remove_dups

Description:

Remove duplicate entries from the history

Type:

Boolean

Default:

set history_remove_dups = no

When set, all of the string history will be scanned for duplicates when a new entry is added. Duplicate entries in the $history_file will also be removed when it is periodically compacted.

---

$save_history

Description:

Number of history entries to save per category

Type:

Number

Notes:

Not Negative

Default:

set save_history = 0

Control the size of the history (per category) saved in the $history_file file.

Setting this to a value greater than $history is possible. However, there will never be more than $history entries to select from even if more are recorded in the history file.