From ee6270301b441f29ba8e62a6551ccae79cc17ce7 Mon Sep 17 00:00:00 2001 From: Fabian Boehm Date: Sat, 10 Sep 2022 20:41:24 +0200 Subject: [PATCH] docs: Moar history pager --- doc_src/interactive.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc_src/interactive.rst b/doc_src/interactive.rst index 52acbf0cf..97ccde97e 100644 --- a/doc_src/interactive.rst +++ b/doc_src/interactive.rst @@ -555,6 +555,8 @@ After a command has been executed, it is remembered in the history list. Any dup By pressing :kbd:`Alt`\ +\ :kbd:`↑` and :kbd:`Alt`\ +\ :kbd:`↓`, a history search is also performed, but instead of searching for a complete commandline, each commandline is broken into separate elements just like it would be before execution, and the history is searched for an element matching that under the cursor. +For more complicated searches, you can press :kbd:`Ctrl`\ +\ :kbd:`R` to open a pager that allows you to search the history. It shows a limited number of entries in one page, press :kbd:`Ctrl`\ +\ :kbd:`R` [#]_ again to move to the next page and :kbd:`Ctrl`\ +\ :kbd:`S` [#]_ to move to the previous page. You can change the text to refine your search. + History searches are case-insensitive unless the search string contains an uppercase character. You can stop a search to edit your search string by pressing :kbd:`Esc` or :kbd:`Page Down`. Prefixing the commandline with a space will prevent the entire line from being stored in the history. It will still be available for recall until the next command is executed, but will not be stored on disk. This is to allow you to fix misspellings and such. @@ -572,6 +574,9 @@ To search for previous entries containing the word 'make', type ``make`` in the If the commandline reads ``cd m``, place the cursor over the ``m`` character and press :kbd:`Alt`\ +\ :kbd:`↑` to search for previously typed words containing 'm'. +.. [#] Or another binding that triggers the ``history-pager`` input function. See :ref:`bind ` for a list. +.. [#] Or another binding that triggers the ``pager-toggle-search`` input function. + Navigating directories ----------------------