bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"

[Eli Zaretskii]

> Date: Tue, 22 Nov 2016 18:50:24 -0800 (PST)
> From: Drew Adams <drew.adams@oracle.com>
> 
> What is touted as a "nifty new feature" and an "advanced capability"
> in the Antinews is not mentioned anywhere else.

That's inaccurate: it is mentioned in NEWS.  (How do you think
Antinews is being prepared?)

> If it's so nifty and advanced, say something about it, somewhere.
> What is it?  What can I do with it?

The bracketed paste mode is not an Emacs feature, it's a feature of
the terminal.  Emacs just uses it when it thinks it's available.  If
you want to learn about this, you should look in the terminal-related
documentation, or on the net.  I don't think Emacs should describe
features of terminals it runs on.

> In particular, how do you turn it off?
> http://emacs.stackexchange.com/q/28851/105
> 
> `C-h f brack TAB' didn't help.
> `C-h v brack TAB' didn't help.
> 
> As the OP for that question said, googling didn't help.

That's fine, because there's no way to turn it off, so there's nothing
to document.

IOW, I don't think there's any documentation problem here.

I do think it would be nice to let users disable use of this feature,
even if the terminal supports it.  Since we do that with other xterm
extensions (see xterm-extra-capabilities), we should probably offer
the same level of control for this capability, either as part of
getSelection, or as a separate feature.

Philipp, would you like to add this on the emacs-25 branch?

TIA