From mboxrd@z Thu Jan 1 00:00:00 1970 From: Allen Li Subject: bug#28263: bug#28263: bug#28263: 24.5; Org: `C-c LETTER' keys Date: Wed, 6 Dec 2017 12:09:08 -0800 Message-ID: References: <936768a0-1a2e-4a89-8a11-8f1779f8591d@default> <87374qb21u.fsf@nicolasgoaziou.fr> <0f47b7da-82d7-4521-aaf6-f2430876ccc2@default> <87h8t59zxg.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:54542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eMg19-0004f0-HQ for emacs-orgmode@gnu.org; Wed, 06 Dec 2017 15:10:08 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eMg14-000768-Rl for emacs-orgmode@gnu.org; Wed, 06 Dec 2017 15:10:07 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:40886) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eMg14-00075O-Np for emacs-orgmode@gnu.org; Wed, 06 Dec 2017 15:10:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eMg14-0005cc-40 for emacs-orgmode@gnu.org; Wed, 06 Dec 2017 15:10:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Drew Adams Cc: Nicolas Goaziou , 28263-done@debbugs.gnu.org On Wed, Dec 6, 2017 at 7:23 AM, Drew Adams wrote: > [paraphrased] Org should not suggest user reserved key bindings I agree with you in general. However, when I first started using Emacs for Org mode years ago, I found the documentation very helpful. Furthermore, I did not find the documentation misleading about the fact that these keys are not standard. For users that are not accustomed to Emacs, the ability to bind keys freely is paralyzing. I had no idea what keys would be okay or not okay to bind. This could be solved by instead linking to the Emacs key binding guidelines and pointing out ranges of keys or example keys that would be safe to bind. I interpret the current documentation as suggesting such example keys. For comparison, calendar.el et al do not suggest global key bindings for their commands. However, Org mode is different because it is one of Emacs=E2=80=99s "killer apps". It is something that a non-Emacs user wo= uld start using Emacs for. No one is going to switch to Emacs to use calendar.el, but there are many people that switch to Emacs to use Org mode. Therefore, there is a benefit in adding some tips for very new users. As a matter of practicality, I suspect many users are just blindly copying Emacs Lisp code from various guides online, so there is no good way to fight de facto standards from emerging. Projectile is a particularly blatant offender, a popular package that reserves the C-c p key for its minor mode. However, the Emacs documentation is quite clear about key binding rules. All built in libraries follow it, including Org mode. I do not interpret the Org documentation as implying otherwise.