Doc for bracketed-paste

Doc for bracketed-paste

[Bart Schaefer]

Shouldn't it say there are default bindings?

Maybe it should also recommend against changing the default, since the
sequence to end the paste is hardwired in C, but I haven't attempted
to address that.

diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 9694a1f74..6d517b81b 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -2222,7 +2222,7 @@ item(tt(beep))(
 Beep, unless the tt(BEEP) option is unset.
 )
 tindex(bracketed-paste)
-item(tt(bracketed-paste))(
+item(tt(bracketed-paste) (tt(^[[200~)) (tt(^[[200~)) (tt(^[[200~)))(
 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.

Re: Doc for bracketed-paste

[Oliver Kiddle]

Bart Schaefer wrote:
> Shouldn't it say there are default bindings?

Leaving them out was intentional but I don't especially object if you
want to add them. I think my rationale for omitting them was that
nobody is going to want to learn them. It is an escape sequence not
a keystroke. At some point in the future certain terminals may pick
a different sequence or terminfo could evolve so that they would be
programmatically selected. So the form of the existing keybinding is not
a fixed thing that can be relied upon for the future.

In practice new terminals are more likely to try to be compatible and if
it changes it'll be to a different form such as dispensing with the end
tag but returning the size in bytes first.

Oliver

Re: Doc for bracketed-paste

[Bart Schaefer]

On Wed, Sep 8, 2021 at 5:49 AM Oliver Kiddle <opk@zsh.org> wrote:
>
> Bart Schaefer wrote:
> > Shouldn't it say there are default bindings?
>
> Leaving them out was intentional but I don't especially object if you
> want to add them. I think my rationale for omitting them was that
> nobody is going to want to learn them.

I guessed it was something like that.  The only reason to add them is
to give some hint of what might be happening if ZLE and the terminal
somehow get into disagreement about whether bracketed paste mode is
enabled.