From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?utf-8?Q?K=C3=A9vin_Le_Gouguec?= <kevin.legouguec@gmail.com>
Subject: Binding org-insert-todo-heading to M-S-RET
Date: Fri, 11 Jan 2019 19:32:29 +0100
Message-ID: <877efbgi4i.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:51462)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <kevin.legouguec@gmail.com>) id 1gi1bg-0002F0-Uu
	for emacs-orgmode@gnu.org; Fri, 11 Jan 2019 13:32:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <kevin.legouguec@gmail.com>) id 1gi1bf-0003O4-W7
	for emacs-orgmode@gnu.org; Fri, 11 Jan 2019 13:32:36 -0500
Received: from mail-wm1-x334.google.com ([2a00:1450:4864:20::334]:34505)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <kevin.legouguec@gmail.com>)
	id 1gi1bf-0003NA-Ps
	for emacs-orgmode@gnu.org; Fri, 11 Jan 2019 13:32:35 -0500
Received: by mail-wm1-x334.google.com with SMTP id y185so2611870wmd.1
	for <emacs-orgmode@gnu.org>; Fri, 11 Jan 2019 10:32:35 -0800 (PST)
Received: from nc10-laptop ([109.190.253.11]) by smtp.gmail.com with ESMTPSA id
	s16sm51752845wrt.77.2019.01.11.10.32.31 for <emacs-orgmode@gnu.org>
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Fri, 11 Jan 2019 10:32:32 -0800 (PST)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: emacs-orgmode@gnu.org

Hello!

Here is a very minor gripe I have with org-mode: is there a reason why
org-insert-todo-heading should be bound to (kbd "M-S-<return>"), rather
than (kbd "M-S-RET")?

AFAIU, using "<return>" limits the key binding to the actual "=E2=8F=8E"
function key, while using "RET" makes any key chord that sends the
"carriage return" character ("=E2=8F=8E" and "C-m") work transparently.

I admit that Alt-Shift-Control-M sounds unwieldy, but my muscle memory
has become so accustomed to using "C-m" instead of "<return>" that I
would welcome a change allowing this alternative.

(
    From my understanding of (emacs)Keymaps and (emacs)Named ASCII
    Chars, using "RET" also has the advantage that bindings can work in
    terminals; IIUC terminals translate presses to "=E2=8F=8E" into the "RE=
T"
    control character, so Emacs never knows that "<return>" was pressed.

    However in this particular case I don't believe that the argument
    applies, since AFAIK terminals cannot transmit "S-RET" to Emacs.
    "M-RET" works though, precisely because it uses "RET" and not
    "<return>".
)

Thank you for your time.


PS: I found a relatively recent thread discussing this issue:

http://lists.gnu.org/archive/html/emacs-orgmode/2017-06/msg00580.html

I am happy that there exist alternative key bindings for terminal
environments; however, I don't think this thread explains why org-mode
uses "<return>" rather than "RET".