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

[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?)

Of course, you want to argue...

Clearly, based on the Subject line, I meant:

What is touted ... in the `Antinews' NODE OF THE EMACS MANUAL
as ... is not mentioned anywhere else IN THE EMACS MANUAL.

(And I specifically stated that it is mentioned in the NEWS.
This bug report is about the Emacs manual.)

> > 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.

Too bad.

> 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.

Clearly.

If Emacs can suddenly start supporting it then Emacs can
provide a way to turn it off (it was, in effect, off before).

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

Yes, thank you.