diff options
author | Paul Ackersviller <packersv@users.sourceforge.net> | 2007-10-08 15:44:35 +0000 |
---|---|---|
committer | Paul Ackersviller <packersv@users.sourceforge.net> | 2007-10-08 15:44:35 +0000 |
commit | 8458eee0577bce8c479afa0897e7cacf99d3f7d5 (patch) | |
tree | 35431881fe82ecc5c035e8184d6745b360553796 /Doc/Zsh/zle.yo | |
parent | dac875ab045888eff92b9cb672c39b77272600e9 (diff) | |
download | zsh-8458eee0577bce8c479afa0897e7cacf99d3f7d5.tar.gz zsh-8458eee0577bce8c479afa0897e7cacf99d3f7d5.tar.xz zsh-8458eee0577bce8c479afa0897e7cacf99d3f7d5.zip |
Merge of users/10172: read-command reads a key sequence as in normal zle operation but sets REPLY to the result instead of executing it.
Diffstat (limited to 'Doc/Zsh/zle.yo')
-rw-r--r-- | Doc/Zsh/zle.yo | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo index fb6f508a0..5bb76ff35 100644 --- a/Doc/Zsh/zle.yo +++ b/Doc/Zsh/zle.yo @@ -103,6 +103,12 @@ This input can itself invoke further replacement strings, but in order to detect loops the process will be stopped if there are twenty such replacements without a real command being read. +A key sequence typed by the user can be turned into a command name for use +in user-defined widgets with the tt(read-command) widget, described +ifzman(below)\ +ifnzman(in noderef(Miscellaneous) below)\ +. + texinode(Zle Builtins)(Zle Widgets)(Keymaps)(Zsh Line Editor) sect(Zle Builtins) cindex(zle, builtin commands) @@ -1763,6 +1769,16 @@ At a secondary (tt(PS2)) prompt, move the entire current multiline construct into the editor buffer. The latter is equivalent to tt(push-input) followed by tt(get-line). ) +tindex(read-command) +item(tt(read-command))( +Only useful from a user-defined widget. A keystroke is read just as in +normal operation, but instead of the command being executed the name +of the command that would be executed is stored in the shell parameter +tt(REPLY). This can be used as the argument of a future tt(zle) +command. If the key sequence is not bound, status 1 is returned; +typically, however, tt(REPLY) is set to tt(undefined-key) to indicate +a useless key sequence. +) tindex(recursive-edit) item(tt(recursive-edit))( Only useful from a user-defined widget. At this point in the function, |