diff options
Diffstat (limited to 'Doc/Zsh/zle.yo')
| -rw-r--r-- | Doc/Zsh/zle.yo | 47 |
1 files changed, 45 insertions, 2 deletions
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo index 16d661f06..c06e2260e 100644 --- a/Doc/Zsh/zle.yo +++ b/Doc/Zsh/zle.yo @@ -29,6 +29,7 @@ line editor. See ifzman(em(Parameters Used By The Shell) in zmanref(zshparam))\ ifnzman(noderef(Parameters Used By The Shell)). +vindex(zle_highlight, use of) The parameter tt(zle_highlight) is also used by the line editor; see ifzman(em(Character Highlighting) below)\ ifnzman(noderef(Character Highlighting)). Highlighting @@ -960,6 +961,24 @@ A number representing the state of the undo history. The only use of this is passing as an argument to the tt(undo) widget in order to undo back to the recorded point. Read-only. ) +vindex(UNDO_LIMIT_NO) +item(tt(UNDO_LIMIT_NO) (integer))( +A number corresponding to an existing change in the undo history; +compare tt(UNDO_CHANGE_NO). If this is set to a value greater +than zero, the tt(undo) command will not allow the line to +be undone beyond the given change number. It is still possible +to use `tt(zle undo) var(change)' in a widget to undo beyond +that point; in that case, it will not be possible to undo at +all until tt(UNDO_LIMIT_NO) is reduced. Set to 0 to disable the limit. + +A typical use of this variable in a widget function is as follows (note +the additional function scope is required): + +example(LPAR()RPAR() { + local UNDO_LIMIT_NO=$UNDO_CHANGE_NO + # Perform some form of recursive edit. +}) +) vindex(WIDGET) item(tt(WIDGET) (scalar))( The name of the widget currently being executed; read-only. @@ -1360,7 +1379,9 @@ item(tt(clear-screen))( Clear the screen, remaining in incremental search mode. ) item(tt(history-incremental-search-backward))( -Find the next occurrence of the contents of the mini-buffer. +Find the next occurrence of the contents of the mini-buffer. If the +mini-buffer is empty, the most recent previously used search string is +reinstated. ) item(tt(history-incremental-search-forward))( Invert the sense of the search. @@ -2057,6 +2078,18 @@ tindex(beep) item(tt(beep))( Beep, unless the tt(BEEP) option is unset. ) +tindex(bracketed-paste) +item(tt(bracketed-paste))( +This widget is invoked when text is pasted to the terminal emulator. It +is not intended to be bound to actual keys but instead to the special +sequence generated by the terminal emulator when text is pasted. +If a numeric argument is given, shell quoting will be applied to the +pasted text before it is inserted. When called from a widget function, +an argument can be given to specify a variable to which pasted text is +assigned. + +See also the tt(zle_bracketed_paste) parameter. +) tindex(vi-cmd-mode) item(tt(vi-cmd-mode) (tt(^X^V)) (unbound) (tt(^[)))( Enter command mode; that is, select the `tt(vicmd)' keymap. @@ -2072,6 +2105,11 @@ tindex(clear-screen) item(tt(clear-screen) (tt(^L ESC-^L)) (tt(^L)) (tt(^L)))( Clear the screen and redraw the prompt. ) +tindex(deactivate-region) +item(tt(deactivate-region))( +Make the current region inactive. This disables vim-style visual +selection mode if it is active. +) tindex(describe-key-briefly) item(tt(describe-key-briefly))( Reads a key sequence, then prints the function bound to that sequence. @@ -2319,7 +2357,8 @@ item(tt(undo) (tt(^_ ^Xu ^X^U)) (tt(u)) (unbound))( Incrementally undo the last text modification. When called from a user-defined widget, takes an optional argument indicating a previous state of the undo history as returned by the tt(UNDO_CHANGE_NO) variable; -modifications are undone until that state is reached. +modifications are undone until that state is reached, subject to +any limit imposed by the tt(UNDO_LIMIT_NO) variable. Note that when invoked from vi command mode, the full prior change made in insert mode is reverted, the changes having been merged when command mode was @@ -2422,6 +2461,7 @@ enditem() texinode(Character Highlighting)()(Zle Widgets)(Zsh Line Editor) sect(Character Highlighting) +vindex(zle_highlight, setting) The line editor has the ability to highlight characters or regions of the line that have a particular significance. This is controlled by the array parameter tt(zle_highlight), if it has been set by the user. @@ -2475,6 +2515,9 @@ a directory name. Note that suffix removal is configurable; the circumstances under which the suffix will be removed may differ for different completions. ) +item(tt(paste))( +Following a command to paste text, the characters that were inserted. +) enditem() tt(zle_highlight) may contain additional fields for controlling how |