about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorPeter Stephenson <pws@users.sourceforge.net>2006-07-28 09:52:34 +0000
committerPeter Stephenson <pws@users.sourceforge.net>2006-07-28 09:52:34 +0000
commitd88220042dc8edfca90b37ffd8c46ef5a817433b (patch)
treee3f534900e1f7a36848e7c0932dc568d57bba1f3 /Doc/Zsh
parent44e2e5979c53b42702efb5b044b55e2b0ec7d8b2 (diff)
downloadzsh-d88220042dc8edfca90b37ffd8c46ef5a817433b.tar.gz
zsh-d88220042dc8edfca90b37ffd8c46ef5a817433b.tar.xz
zsh-d88220042dc8edfca90b37ffd8c46ef5a817433b.zip
22559: add history-beginning-search-menu
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/contrib.yo23
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index 28fc7eed7..e86e28584 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -605,6 +605,29 @@ zle -N history-beginning-search-forward-end \
 bindkey '\e^P' history-beginning-search-backward-end
 bindkey '\e^N' history-beginning-search-forward-end)
 )
+tindex(history-beginning-search-menu)
+item(tt(history-beginning-search-menu))(
+This function implements yet another form of history searching.  The
+text before the cursor is used to select lines from the history,
+as for tt(history-beginning-search-backward) except that all matches are
+shown in a numbered menu.  Typing the appropriate digits inserts the
+full history line.  Note that leading zeroes must be typed (they are only
+shown when necessary for removing ambiguity).  The entire history is
+searched; there is no distinction between forwards and backwards.
+
+With a prefix argument, the search is not anchored to the start of
+the line; the string typed by the use may appear anywhere in the line
+in the history.
+
+If the widget name contains `tt(-end)' the cursor is moved to the end of
+the line inserted.  If the widget name contains `tt(-space)' any space
+in the text typed is treated as a wildcard and can match anything (hence
+a leading space is equivalent to giving a prefix argument).  Both
+forms can be combined, for example:
+
+example(zle -N history-beginning-search-menu-space-end \ 
+       history-beginning-search-menu)
+)
 tindex(history-pattern-search)
 tindex(history-pattern-search-backward)
 tindex(history-pattern-search-forward)