bracketed paste - FAQ update

bracketed paste - FAQ update

[Daniel Shahaf]

Question 3.24 "3.24. What's wrong with cut and paste on my xterm?" has:

  myeit() When the shell is waiting for input, and you paste in a chunk of
     text consisting of more than one complete set of commands.
     Unfortunately, this is a much harder problem: the line editor is
     already active, and needs to be turned off when the first command is
     executed.  The shell doesn't even know if the remaining text is input
     to a command or for the shell, so there's simply nothing it can do.
     However, if you have problems you can trick it: type `tt({)' on a line
     by itself, then paste the input, then type `tt(})' on a line by
     itself.  The shell will not execute anything until the final brace is
     read; all input is read as continuation lines (this may require the
     fixes referred to above in order to be reliable).

Maybe update this to reflect the new 5.0.9 behaviour?

Re: bracketed paste - FAQ update

[Daniel Shahaf]

Daniel Shahaf wrote on Thu, Jul 16, 2015 at 23:42:05 +0000:
> Question 3.24 "3.24. What's wrong with cut and paste on my xterm?" has:
> 
>   myeit() When the shell is waiting for input, and you paste in a chunk of
>      text consisting of more than one complete set of commands.
> [...]
> Maybe update this to reflect the new 5.0.9 behaviour?

Haven't caught up with my inbox yet, but in the meantime:

diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo
index a9cc0a6..e6d5094 100644
--- a/Etc/FAQ.yo
+++ b/Etc/FAQ.yo
@@ -1702,11 +1702,17 @@ sect(What's wrong with cut and paste on my xterm?)
      already active, and needs to be turned off when the first command is
      executed.  The shell doesn't even know if the remaining text is input
      to a command or for the shell, so there's simply nothing it can do.
+
      However, if you have problems you can trick it: type `tt({)' on a line
      by itself, then paste the input, then type `tt(})' on a line by
      itself.  The shell will not execute anything until the final brace is
      read; all input is read as continuation lines (this may require the
      fixes referred to above in order to be reliable).
+
+     As of 5.0.9, this trick is not necessary on terminal emulators that
+     support the em(bracketed paste) feature (this includes most modern
+     terminal emulators).  See the description of tt($zle_bracketed_paste)
+     in the tt(zshparam) manual page for details.
   )