diff options
Diffstat (limited to 'source/blog/2015-09-21-zsh-51-and-bracketed-paste.md')
| -rw-r--r-- | source/blog/2015-09-21-zsh-51-and-bracketed-paste.md | 68 |
1 files changed, 0 insertions, 68 deletions
diff --git a/source/blog/2015-09-21-zsh-51-and-bracketed-paste.md b/source/blog/2015-09-21-zsh-51-and-bracketed-paste.md deleted file mode 100644 index 29180b20..00000000 --- a/source/blog/2015-09-21-zsh-51-and-bracketed-paste.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: "Zsh 5.1 and bracketed paste" -date: 2015-09-21T14:40:36-07:00 -date_display: September 21, 2015 ---- - -**TL;DR.** Jump to [code](#code). - ---- - -In short, Zsh 5.1 introduced bracketed paste mode[^1] and turned it on by default (as it seems to me[^update]). It is nice in certain ways — I appreciate the change, yet I was bitten nevertheless. In at least two ways: - -1. Most annoyingly, `url-quote-magic` doesn't work anymore when pasting URLs, so for example if I paste - - https://www.google.com/search?q=zsh - - without typing in a single or double quote first, the `?` and `=` won't be backslash-quoted by default, which causes an error when passed unnoticed (out of habit). - -2. The Emacs shell[^2] is littered with `^[[?2004h` and `^[[?2004l` around every prompt. - -The solution? Zsh now also ships with [`bracketed-paste-magic`](https://github.com/zsh-users/zsh/blob/master/Functions/Zle/bracketed-paste-magic) that resolves exactly breakage #1 (and a bit more); to quote comments from the linked source file: - -> Starting with zsh-5.1, ZLE began to recognize the "bracketed paste" -capability of terminal emulators, that is, the sequences `$'\e[200~'` to -start a paste and `$'\e[201~'` to indicate the end of the pasted text. -Pastes are handled by the bracketed-paste widget and insert literally -into the editor buffer rather than being interpreted as keystrokes. -> -> This disables some common usages where the self-insert widget has been -replaced in order to accomplish some extra processing. An example is -the contributed url-quote-magic widget. The bracketed-paste-magic -widget replaces bracketed-paste with a wrapper that re-enables these -self-insert actions, and other actions as selected by the zstyles -described below. - -And to resolve breakage #2, just disable bracketed paste altogether for dumb terms. - -<p id="code">Putting it together:</p> - -```zsh -# turn off ZLE bracketed paste in dumb term -# otherwise turn on ZLE bracketed-paste-magic -if [[ $TERM == dumb ]]; then - unset zle_bracketed_paste -else - autoload -Uz bracketed-paste-magic - zle -N bracketed-paste bracketed-paste-magic -fi -``` - ---- - -<span id="update">**09/22/2015 update.**</span> I only read `NEWS` and not `README`, so I missed out on a very clear announcement of the [bracketed paste incompatibitilies (between 5.0.8 and 5.1)](https://github.com/zsh-users/zsh/blob/68405f31a043bdd5bf338eb06688ed3e1f740937/README#L38-L45): - -> The default behaviour when text is pasted into an X Windows terminal has -changed significantly (unless you are using a very old terminal emulator -that doesn't support this mode). Now, the new "bracketed paste mode" -treats all the pasted text as literal characters. This means, in -particular, that a newline is simply inserted as a visible newline; you -need to hit Return on the keyboard to execute the pasted text in one go. -See the description of `zle_bracketed_paste` in the `zshparams` manual for -more. "`unset zle_bracketed_paste`" restores the previous behaviour. - -[^1]: Bracketed paste mode is a safeguard against inadvertent interpretation of pasted text, e.g., newline being treated at `accept-line` in Zsh. You may read more about it [in this blog post](https://cirw.in/blog/bracketed-paste), which is somewhat outdated yet still informational. - -[^2]: I seldom use this dumb (literally) thing, but when I do I expect it to work ungarbled, naturally. - -[^update]: Indeed it is. See [update](#update) with more accurate info from official source. |