From 53d894e7a368c782abbab56dc7f5048851a69138 Mon Sep 17 00:00:00 2001 From: Paul Ackersviller Date: Mon, 26 Nov 2007 03:41:21 +0000 Subject: Merge of Mikael Magnusson: 24076, 24081, 24082: need to cancel option processing with -- after widget calls with arguments. --- Doc/Zsh/zle.yo | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'Doc') diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo index 5bb76ff35..d45c71ab3 100644 --- a/Doc/Zsh/zle.yo +++ b/Doc/Zsh/zle.yo @@ -544,7 +544,19 @@ saved and then restored after the call to tt(widget); `tt(-n) var(num)' sets the numerical argument temporarily to var(num), while `tt(-N)' sets it to the default, i.e. as if there were none. -Any further arguments will be passed to the widget. If it is a shell +With the option tt(-K), var(keymap) will be used as the current keymap +during the execution of the widget. The previous keymap will be +restored when the widget exits. + +Normally, calling a widget in this way does not set the special +parameter tt(WIDGET) and related parameters, so that the environment +appears as if the top-level widget called by the user were still +active. With the option tt(-w), tt(WIDGET) and related parameters are set +to reflect the widget being executed by the tt(zle) call. + +Any further arguments will be passed to the widget; note that as +standard argument handling is performed, any general argument list +should be preceded by tt(-)tt(-). If it is a shell function, these are passed down as positional parameters; for builtin widgets it is up to the widget in question what it does with them. Currently arguments are only handled by the incremental-search commands, -- cgit 1.4.1