GNU bug report logs - #24995
25.1; Emacs manual: no doc on "bracketed paste mode"

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 24995 in the body.
You can then email your comments to 24995 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Tue, 22 Nov 2016 18:50:24 -0800 (PST)

What is touted as a "nifty new feature" and an "advanced capability"
in the Antinews is not mentioned anywhere else.  If it's so nifty
and advanced, say something about it, somewhere.  What is it?  What
can I do with it?  If you're going to call it out, at least consider
providing a link to the NEWS entry for it from the place that it's
mentioned in the manual.

In GNU Emacs 25.1.1 (x86_64-w64-mingw32)
 of 2016-09-17 built on LAPHROAIG
Windowing system distributor 'Microsoft Corp.', version 6.1.7601
Configured using:
 'configure --without-dbus --without-compress-install CFLAGS=-static'

Message #8 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: 24995 <at> debbugs.gnu.org
Subject: RE: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Tue, 22 Nov 2016 19:26:42 -0800 (PST)

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.

Message #11 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>,
 Philipp Stephani <p.stephani2 <at> gmail.com>
Cc: 24995 <at> debbugs.gnu.org
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Wed, 23 Nov 2016 18:30:32 +0200

> Date: Tue, 22 Nov 2016 18:50:24 -0800 (PST)
> From: Drew Adams <drew.adams <at> 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

Message #14 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>, Philipp
 Stephani <p.stephani2 <at> gmail.com>
Cc: 24995 <at> debbugs.gnu.org
Subject: RE: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Wed, 23 Nov 2016 08:42:50 -0800 (PST)

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

Message #17 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Philipp Stephani <p.stephani2 <at> gmail.com>
To: Drew Adams <drew.adams <at> oracle.com>, Eli Zaretskii <eliz <at> gnu.org>
Cc: 24995 <at> debbugs.gnu.org
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Sun, 27 Nov 2016 21:11:36 +0000

[Message part 1 (text/plain, inline)]

Drew Adams <drew.adams <at> oracle.com> schrieb am Mi., 23. Nov. 2016 um
17:43 Uhr:

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

There shouldn't be any need for turning off bracketed pasting. It's just a
separate input key sequence that is either sent or not sent by the terminal
emulator. This isn't different from e.g. the Hyper key; there's also no
option to disable the latter.
The issue here is that the terminal emulator sends various escape sequences
to the running program; such escape sequences cannot in general be used as
custom key sequences, because they are intended to have a special
predefined meaning.

[Message part 2 (text/html, inline)]

Message #20 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Philipp Stephani <p.stephani2 <at> gmail.com>
Cc: 24995 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Mon, 28 Nov 2016 05:25:34 +0200

> From: Philipp Stephani <p.stephani2 <at> gmail.com>
> Date: Sun, 27 Nov 2016 21:11:36 +0000
> Cc: 24995 <at> debbugs.gnu.org
> 
>  > 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.
> 
> There shouldn't be any need for turning off bracketed pasting. It's just a separate input key sequence that is
> either sent or not sent by the terminal emulator. This isn't different from e.g. the Hyper key; there's also no
> option to disable the latter.

That is true, but we still allow the user to control the other similar
extensions, which all fit your description.  So why should support for
bracketed paste mode be different?  It's inconsistent, and I can't
think of a reason why we would want this inconsistency.

Message #23 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Philipp Stephani <p.stephani2 <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 24995 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Wed, 28 Dec 2016 21:11:19 +0000

[Message part 1 (text/plain, inline)]

Eli Zaretskii <eliz <at> gnu.org> schrieb am Mo., 28. Nov. 2016 um 04:25 Uhr:

> > From: Philipp Stephani <p.stephani2 <at> gmail.com>
> > Date: Sun, 27 Nov 2016 21:11:36 +0000
> > Cc: 24995 <at> debbugs.gnu.org
> >
> >  > 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.
> >
> > There shouldn't be any need for turning off bracketed pasting. It's just
> a separate input key sequence that is
> > either sent or not sent by the terminal emulator. This isn't different
> from e.g. the Hyper key; there's also no
> > option to disable the latter.
>
> That is true, but we still allow the user to control the other similar
> extensions, which all fit your description.  So why should support for
> bracketed paste mode be different?  It's inconsistent, and I can't
> think of a reason why we would want this inconsistency.
>

I don't think that inconsistency is a strong enough reason to introduce a
customization option, especially for a setting that has no user-visible
behavior. There are certainly several other optimizations in the the Emacs
code base that can't be turned off.

[Message part 2 (text/html, inline)]

Message #26 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Philipp Stephani <p.stephani2 <at> gmail.com>
Cc: 24995 <at> debbugs.gnu.org, drew.adams <at> oracle.com
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Thu, 29 Dec 2016 17:51:24 +0200

> From: Philipp Stephani <p.stephani2 <at> gmail.com>
> Date: Wed, 28 Dec 2016 21:11:19 +0000
> Cc: drew.adams <at> oracle.com, 24995 <at> debbugs.gnu.org
> 
>  That is true, but we still allow the user to control the other similar
>  extensions, which all fit your description. So why should support for
>  bracketed paste mode be different? It's inconsistent, and I can't
>  think of a reason why we would want this inconsistency.
> 
> I don't think that inconsistency is a strong enough reason to introduce a customization option, especially for a
> setting that has no user-visible behavior. There are certainly several other optimizations in the the Emacs
> code base that can't be turned off. 

I disagree, but let's defer to users' complaints (or lack thereof) to
be the judge.

Message #29 received at 24995 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Philipp Stephani <p.stephani2 <at> gmail.com>, 24995 <at> debbugs.gnu.org,
 Drew Adams <drew.adams <at> oracle.com>
Subject: Re: bug#24995: 25.1; Emacs manual: no doc on "bracketed paste mode"
Date: Mon, 11 Nov 2019 04:19:07 +0100

tags 24995 + wontfix
close 24995
thanks

Eli Zaretskii <eliz <at> gnu.org> writes:

>> Date: Tue, 22 Nov 2016 18:50:24 -0800 (PST)
>> From: Drew Adams <drew.adams <at> 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.

With the above, and seeing nothing else to do here, I'll close this as
wontfix.

Best regards,
Stefan Kangas

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.