Re: Shift-Insert overwrites ZLE CUTBUFFER

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

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.

diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 726e973..3fb7f42 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -2176,10 +2176,12 @@ 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 called from a widget function and a positional argument is given,
+it is interpreted as a variable name to which the pasted text is assigned.
+Otherwise, the pasted text is inserted to the buffer and added to the kill ring.
 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.
 
 See also the tt(zle_bracketed_paste) parameter.
 )