aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/history.txt
blob: 8545361dafc5e4dd5c3aa532de5ee459df5ad8ed (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
\section history history - Show and manipulate command history

\subsection history-synopsis Synopsis
<pre>
history (--save | --clear | --merge)
history (--search | --delete ) (--prefix "prefix string" | --contains "search string")
</pre>

\subsection history-description Description

\c history is used to list, search and delete the history of commands used.

The following options are available:

- \c --save saves all changes in the history file. The shell automatically
saves the history file; this option is provided for internal use.
- \c --clear clears the history file. A prompt is displayed before the history
is erased.
- \c --merge immediately incorporates history changes from other sessions. Ordinarily
fish ignores history changes from sessions started after the current one. This command
applies those changes immediately.
- \c --search returns history items in keeping with the \c --prefix or
\c --contains options.
- \c --delete deletes history items.
- \c --prefix searches or deletes items in the history that begin with the
specified text string.
- \c --contains searches or deletes items in the history that contain the
specified text string.

If \c --search is specified without \c --contains or <code>--prefix</code>,
\c --contains will be assumed.

If \c --delete is specified without \c --contains or <code>--prefix</code>,
only a history item which exactly matches the parameter will be erased. No
prompt will be given. If \c --delete is specified with either of these
parameters, an interactive prompt will be displayed before any items are
deleted.

\subsection history-examples Example

<code>history --clear</code> deletes all history items

<code>history --search --contains "foo"</code> outputs a list of all previous
commands containing the string "foo".

<code>history --delete --prefix "foo"</code> interactively deletes the record
of previous commands which start with "foo".