Help cleanup
Large list of changes, including formatting and typos for most commands.
More substantive changes have been made to alias, bind, block, break,
builtin, case, cd, commandline, count, else, emit, fish_config, funced,
function, functions, history, math, mimedb, nextd, not, popd, prevd,
pushd, pwd, random, read, set, set_color, switch, test, trap, type,
ulimit, umask, and while.
2013-05-12 15:56:01 +08:00
\section history history - Show and manipulate command history
2012-06-05 12:24:42 +08:00
\subsection history-synopsis Synopsis
2014-08-01 20:25:41 +08:00
\fish{synopsis}
2014-08-27 02:19:24 +08:00
history ( --merge | --save | --clear )
history ( --search | --delete ) [ --prefix "prefix string" | --contains "search string" ]
2014-08-01 10:37:32 +08:00
\endfish
2012-06-05 12:24:42 +08:00
\subsection history-description Description
2014-08-01 10:37:32 +08:00
`history` is used to list, search and delete the history of commands used.
2012-06-05 12:24:42 +08:00
Help cleanup
Large list of changes, including formatting and typos for most commands.
More substantive changes have been made to alias, bind, block, break,
builtin, case, cd, commandline, count, else, emit, fish_config, funced,
function, functions, history, math, mimedb, nextd, not, popd, prevd,
pushd, pwd, random, read, set, set_color, switch, test, trap, type,
ulimit, umask, and while.
2013-05-12 15:56:01 +08:00
The following options are available:
2014-08-08 10:44:37 +08:00
- `--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.
2014-08-19 20:41:23 +08:00
2014-08-01 12:16:02 +08:00
- `--save` saves all changes in the history file. The shell automatically saves the history file; this option is provided for internal use.
2014-08-19 20:41:23 +08:00
2014-08-01 12:16:02 +08:00
- `--clear` clears the history file. A prompt is displayed before the history is erased.
2014-08-19 20:41:23 +08:00
2014-08-01 12:16:02 +08:00
- `--search` returns history items in keeping with the `--prefix` or `--contains` options.
2014-08-19 20:41:23 +08:00
2014-08-01 10:37:32 +08:00
- `--delete` deletes history items.
2014-08-19 20:41:23 +08:00
2014-08-01 12:16:02 +08:00
- `--prefix` searches or deletes items in the history that begin with the specified text string.
2014-08-19 20:41:23 +08:00
2014-08-01 12:16:02 +08:00
- `--contains` searches or deletes items in the history that contain the specified text string.
2012-06-05 12:24:42 +08:00
2014-08-01 12:16:02 +08:00
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.
2012-06-05 12:24:42 +08:00
2014-08-19 20:41:23 +08:00
Help cleanup
Large list of changes, including formatting and typos for most commands.
More substantive changes have been made to alias, bind, block, break,
builtin, case, cd, commandline, count, else, emit, fish_config, funced,
function, functions, history, math, mimedb, nextd, not, popd, prevd,
pushd, pwd, random, read, set, set_color, switch, test, trap, type,
ulimit, umask, and while.
2013-05-12 15:56:01 +08:00
\subsection history-examples Example
2012-06-05 12:24:42 +08:00
2014-08-19 20:41:23 +08:00
\fish
history --clear
# Deletes all history items
2012-06-05 12:24:42 +08:00
2014-08-19 20:41:23 +08:00
history --search --contains "foo"
# Outputs a list of all previous commands containing the string "foo".
2012-06-05 12:24:42 +08:00
2014-08-19 20:41:23 +08:00
history --delete --prefix "foo"
# Interactively deletes the record of previous commands which start with "foo".
\endfish
