Subject: bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys

From: Eli Zaretskii <[email-masked]>
Date: Thu, 01 Mar 2018 17:44:29 +0200

> From: Nicolas Goaziou <[email-masked]>
> Cc: Drew Adams <[email-masked]>,  [email-masked]
> Date: Sat, 24 Feb 2018 22:27:48 +0100
> 
> For good measure, could you also add a @cindex about it? E.g,
> 
>   @cindex user reserved key bindings

Starting an index entry with "user" is not a good idea, as it's too
general a word.  I added "reserved key bindings" instead.

>     For a better experience, the three Org commands ~org-store-link~,
>     ~org-capture~ and ~org-agenda~ ought to be accessible anywhere in
>     Emacs, not just in Org buffers.  To that effect, you need to bind them
>     to globally available keys, like the ones reserved for users (see
>     [[info:elisp::Key%20Binding%20Conventions]]).  Here are suggested
>     bindings, please modify the keys to your own liking.
> 
>     #+begin_src emacs-lisp
>       (global-set-key "\C-cl" 'org-store-link)
>       (global-set-key "\C-ca" 'org-agenda)
>       (global-set-key "\C-cc" 'org-capture)
>     #+end_src
> 
> Drew pointed out that suggesting to bind user reserved keys was almost
> as if we were binding them. 

I disagree with Drew.  By that logic, no one can ever say anything
about binding these keys, and they must always remain unbound, which
of course would defeat the reason for reserving them.