Re: Shift-Insert overwrites ZLE CUTBUFFER

[Daniel Shahaf <d.s@daniel.shahaf.name>]

Daniel Shahaf wrote on Thu, Oct 27, 2016 at 00:45:00 +0000:
> Bart Schaefer wrote on Wed, Oct 26, 2016 at 16:51:38 -0700:
> > On Oct 27, 12:12am, lolilolicon wrote:
> > } This doesn't seem to be documented, so I think it's OK to change it.
> > 
> > Good point that it should be documented.
> >
> 
> The following documents the incumbent killring behaviour, and rearranges
> text to clarify that a numeric argument is ignored when a positional
> argument is present.

Alternative patch after feedback by Bart.

diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 726e973..e82c12d 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -2176,10 +2176,13 @@ 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.
+The pasted text is inserted to the buffer and placed in the cutbuffer.
 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.
+pasted text before it is inserted.
+
+When called from a widget function as `tt(bracketed-paste) var(name)`, the
+pasted text is assigned to the variable var(name) and no other processing is
+done.
 
 See also the tt(zle_bracketed_paste) parameter.
 )