fish-shell/doc_src/history.txt

\section history history - Show and manipulate command history

\subsection history-synopsis Synopsis
\fish{synopsis}
history ( -m | --merge )
history ( -s | --save )
history ( -l | --clear )
history ( -s | --search ) [ -t | --with-time ] [ -p "prefix string" | --prefix "prefix string" | -c "search string | --contains "search string" ]
history ( -d | --delete ) [ -t | --with-time ] [ -p "prefix string" | --prefix "prefix string" | -c "search string | --contains "search string" ]
history ( -t | --with-time )
history ( -h | --help )
\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. Without either, `--contains` will be assumed.

- `--delete` deletes history items. Without the `--prefix` or `--contains` options, the exact match will be deleted. With either of these options, a prompt will be displayed before any items are deleted.

- `--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.

- `--with-time` prefixes the output of each displayed history entry with the time it was recorded in the format "%Y-%m-%d %H:%M:%S" in your local timezone.

\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
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 07:56:01 +00:00			`\section history history - Show and manipulate command history`
Adding history builtin 2012-06-05 04:24:42 +00:00
			`\subsection history-synopsis Synopsis`
Simplify styling 2014-08-01 12:25:41 +00:00			`\fish{synopsis}`
fix the history function and man page The previous commit to add a `--with-timestamp` flag to the `history` command caused me to notice the history function didn't recognize the new long option. Neither did it recognize the short options for the builtin command. This change fixes both of those issues. 2016-06-29 05:22:40 +00:00			`history ( -m \| --merge )`
			`history ( -s \| --save )`
			`history ( -l \| --clear )`
			`history ( -s \| --search ) [ -t \| --with-time ] [ -p "prefix string" \| --prefix "prefix string" \| -c "search string \| --contains "search string" ]`
			`history ( -d \| --delete ) [ -t \| --with-time ] [ -p "prefix string" \| --prefix "prefix string" \| -c "search string \| --contains "search string" ]`
			`history ( -t \| --with-time )`
			`history ( -h \| --help )`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`\endfish`
Adding history builtin 2012-06-05 04:24:42 +00:00
			`\subsection history-description Description`

Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`history` is used to list, search and delete the history of commands used.
Adding history builtin 2012-06-05 04:24:42 +00: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 07:56:01 +00:00			`The following options are available:`
fix the history function and man page The previous commit to add a `--with-timestamp` flag to the `history` command caused me to notice the history function didn't recognize the new long option. Neither did it recognize the short options for the builtin command. This change fixes both of those issues. 2016-06-29 05:22:40 +00:00
Tutorial auto colouring, Man page and Make fixes Completely fixes #1557 and the underlying Doxygen changes that caused it. Should make fish docs simpler and more robust, more consistent and generally prettier. todo: - trap unmarked text as arguments in context - test & fix sed portability - see in particular. (so far tested on BSD (Mac) and GNU sed). - test Makefile changes - last round of aesthetic changes and getting that ascii fish in there… 2014-08-08 02:44:37 +00: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.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
Merge branch 'master' into documentation-update Conflicts: doc_src/history.txt doc_src/test.txt 2014-08-01 04:16:02 +00:00			- `--save` saves all changes in the history file. The shell automatically saves the history file; this option is provided for internal use.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
Merge branch 'master' into documentation-update Conflicts: doc_src/history.txt doc_src/test.txt 2014-08-01 04:16:02 +00:00			- `--clear` clears the history file. A prompt is displayed before the history is erased.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
History docs: Move descriptions to the corresponding options This should clarify `--delete`s behavior without `--prefix` or `--contains` a bit. Fixes #3054. 2016-05-28 12:22:16 +00:00			- `--search` returns history items in keeping with the `--prefix` or `--contains` options. Without either, `--contains` will be assumed.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
History docs: Move descriptions to the corresponding options This should clarify `--delete`s behavior without `--prefix` or `--contains` a bit. Fixes #3054. 2016-05-28 12:22:16 +00:00			- `--delete` deletes history items. Without the `--prefix` or `--contains` options, the exact match will be deleted. With either of these options, a prompt will be displayed before any items are deleted.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
Merge branch 'master' into documentation-update Conflicts: doc_src/history.txt doc_src/test.txt 2014-08-01 04:16:02 +00:00			- `--prefix` searches or deletes items in the history that begin with the specified text string.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
Merge branch 'master' into documentation-update Conflicts: doc_src/history.txt doc_src/test.txt 2014-08-01 04:16:02 +00:00			- `--contains` searches or deletes items in the history that contain the specified text string.
Adding history builtin 2012-06-05 04:24:42 +00:00
fix the history function and man page The previous commit to add a `--with-timestamp` flag to the `history` command caused me to notice the history function didn't recognize the new long option. Neither did it recognize the short options for the builtin command. This change fixes both of those issues. 2016-06-29 05:22:40 +00:00			- `--with-time` prefixes the output of each displayed history entry with the time it was recorded in the format "%Y-%m-%d %H:%M:%S" in your local timezone.

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 07:56:01 +00:00			`\subsection history-examples Example`
Adding history builtin 2012-06-05 04:24:42 +00:00
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00			`\fish`
			`history --clear`
			`# Deletes all history items`
Adding history builtin 2012-06-05 04:24:42 +00:00
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00			`history --search --contains "foo"`
			`# Outputs a list of all previous commands containing the string "foo".`
Adding history builtin 2012-06-05 04:24:42 +00:00
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00			`history --delete --prefix "foo"`
			`# Interactively deletes the record of previous commands which start with "foo".`
			`\endfish`