diff options
Diffstat (limited to 'doc_src/history.txt')
-rw-r--r-- | doc_src/history.txt | 45 |
1 files changed, 18 insertions, 27 deletions
diff --git a/doc_src/history.txt b/doc_src/history.txt index b6e15340..f7b873a0 100644 --- a/doc_src/history.txt +++ b/doc_src/history.txt @@ -1,40 +1,31 @@ \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> +\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: +- `--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. + +- `--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.- `--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. -- `--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. -- \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. -- `--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. +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 |