bug#23247: 25.0.92: Documentation bug about Control modified key bindings

bug#23247: 25.0.92: Documentation bug about Control modified key bindings

[Kaushal Modi]

[-- Attachment #1: Type: text/plain, Size: 646 bytes --]

This discussion recently came up on emacs.stackexchange..
http://emacs.stackexchange.com/a/21524/115

The emacs manual (C-h i g (emacs) Modifier Keys) says the below:

"A <Control>-modified alphabetical character is always considered
case-insensitive: Emacs always treats ‘C-A’ as ‘C-a’, ‘C-B’ as ‘C-b’,
and so forth. The reason for this is historical."

But I am able to bind something like

(global-set-key (kbd "C-S-n") #'previous-line)

and have C-n and "C-N" call different commands.

Does that piece of information about Control-modified alphabetical
characters need correction or clarification?

Thanks.

[-- Attachment #2: Type: text/html, Size: 838 bytes --]

bug#23247: 25.0.92: Documentation bug about Control modified key bindings

[Eli Zaretskii]

> From: Kaushal Modi <kaushal.modi@gmail.com>
> Date: Fri, 08 Apr 2016 21:54:56 +0000
> 
> This discussion recently came up on emacs.stackexchange.. http://emacs.stackexchange.com/a/21524/115
> 
> The emacs manual (C-h i g (emacs) Modifier Keys) says the below: 
> 
> "A <Control>-modified alphabetical character is always considered
> case-insensitive: Emacs always treats ‘C-A’ as ‘C-a’, ‘C-B’ as ‘C-b’,
> and so forth. The reason for this is historical."
> 
> But I am able to bind something like
> 
> (global-set-key (kbd "C-S-n") #'previous-line)
> 
> and have C-n and "C-N" call different commands.

Did you try that on a text terminal as well?

> Does that piece of information about Control-modified alphabetical characters need correction or clarification?

Not sure we want to enter these details in a user manual.  Also, "C-N"
and "C-S-n" are not the same thing in this context.

bug#23247: 25.0.92: Documentation bug about Control modified key bindings

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

>> The emacs manual (C-h i g (emacs) Modifier Keys) says the below: 
>> 
>> "A <Control>-modified alphabetical character is always considered
>> case-insensitive: Emacs always treats ‘C-A’ as ‘C-a’, ‘C-B’ as ‘C-b’,
>> and so forth. The reason for this is historical."
>> 
>> But I am able to bind something like
>> 
>> (global-set-key (kbd "C-S-n") #'previous-line)
>> 
>> and have C-n and "C-N" call different commands.
>
> Did you try that on a text terminal as well?
>
>> Does that piece of information about Control-modified alphabetical
>> characters need correction or clarification?
>
> Not sure we want to enter these details in a user manual.  Also, "C-N"
> and "C-S-n" are not the same thing in this context.

I think it would make sense to at least mention these wrinkles in the
user manual -- many people don't care about running Emacs in a terminal,
and being able to bind shifted alphabetical characters opens up a whole
new range of user-definable keystrokes.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#23247: 25.0.92: Documentation bug about Control modified key bindings

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: Kaushal Modi <kaushal.modi@gmail.com>,  23247@debbugs.gnu.org
> Date: Sat, 12 Oct 2019 21:41:40 +0200
> 
> >> But I am able to bind something like
> >> 
> >> (global-set-key (kbd "C-S-n") #'previous-line)
> >> 
> >> and have C-n and "C-N" call different commands.
> >
> > Did you try that on a text terminal as well?
> >
> >> Does that piece of information about Control-modified alphabetical
> >> characters need correction or clarification?
> >
> > Not sure we want to enter these details in a user manual.  Also, "C-N"
> > and "C-S-n" are not the same thing in this context.
> 
> I think it would make sense to at least mention these wrinkles in the
> user manual -- many people don't care about running Emacs in a terminal,
> and being able to bind shifted alphabetical characters opens up a whole
> new range of user-definable keystrokes.

It's OK to mention that, but please also add a note that this only
works on GUI frames.

bug#23247: 25.0.92: Documentation bug about Control modified key bindings

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

> It's OK to mention that, but please also add a note that this only
> works on GUI frames.

OK; done.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no