[O] Binding org-insert-todo-heading to M-S-RET

[Kévin Le Gouguec]

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 "⏎"
function key, while using "RET" makes any key chord that sends the
"carriage return" character ("⏎" 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 "⏎" into the "RET"
    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".