mirror of
https://github.com/fish-shell/fish-shell
synced 2024-11-15 01:17:45 +00:00
44 lines
1.8 KiB
Text
44 lines
1.8 KiB
Text
\section history history - Show and manipulate command history
|
|
|
|
\subsection history-synopsis Synopsis
|
|
\fish{synopsis}
|
|
history ( --merge | --save | --clear )
|
|
history ( --search | --delete ) [ --prefix "prefix string" | --contains "search string" ]
|
|
\endfish
|
|
|
|
\subsection history-description Description
|
|
|
|
`history` is used to list, search and delete the history of commands used.
|
|
|
|
The following options are available:
|
|
- `--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.
|
|
|
|
- `--save` saves all changes in the history file. The shell automatically saves the history file; this option is provided for internal use.
|
|
|
|
- `--clear` clears the history file. A prompt is displayed before the history is erased.
|
|
|
|
- `--search` returns history items in keeping with the `--prefix` or `--contains` options.
|
|
|
|
- `--delete` deletes history items.
|
|
|
|
- `--prefix` searches or deletes items in the history that begin with the specified text string.
|
|
|
|
- `--contains` searches or deletes items in the history that contain the specified text string.
|
|
|
|
If `--search` is specified without `--contains` or `--prefix`, `--contains` will be assumed.
|
|
|
|
If `--delete` is specified without `--contains` or `--prefix`, only a history item which exactly matches the parameter will be erased. No prompt will be given. If `--delete` is specified with either of these parameters, an interactive prompt will be displayed before any items are deleted.
|
|
|
|
|
|
\subsection history-examples Example
|
|
|
|
\fish
|
|
history --clear
|
|
# Deletes all history items
|
|
|
|
history --search --contains "foo"
|
|
# Outputs a list of all previous commands containing the string "foo".
|
|
|
|
history --delete --prefix "foo"
|
|
# Interactively deletes the record of previous commands which start with "foo".
|
|
\endfish
|