From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: bug#28263: 24.5; Org: `C-c LETTER' keys Date: Tue, 05 Dec 2017 12:28:27 +0100 Message-ID: <87h8t59zxg.fsf@nicolasgoaziou.fr> References: <936768a0-1a2e-4a89-8a11-8f1779f8591d@default> <87374qb21u.fsf@nicolasgoaziou.fr> <0f47b7da-82d7-4521-aaf6-f2430876ccc2@default> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39819) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eMBPP-00043L-2F for emacs-orgmode@gnu.org; Tue, 05 Dec 2017 06:29:08 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eMBPK-0005wb-HH for emacs-orgmode@gnu.org; Tue, 05 Dec 2017 06:29:07 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:37786) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eMBPK-0005wI-DC for emacs-orgmode@gnu.org; Tue, 05 Dec 2017 06:29:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eMBPK-00034a-7g for emacs-orgmode@gnu.org; Tue, 05 Dec 2017 06:29:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <0f47b7da-82d7-4521-aaf6-f2430876ccc2@default> (Drew Adams's message of "Mon, 4 Dec 2017 14:42:54 -0800 (PST)") 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: 28263-done@debbugs.gnu.org Hello, Drew Adams writes: >> > Dunno whether there are actual bindings in Org that correspond to these >> > occurrences in the source code of `C-c' followed by a letter. Might be >> > worth checking. (Bindings of `C-c' followed by a letter are reserved >> > for users.) Possibly these are just vestigial doc indications, which >> > could be corrected/updated. >> >> Org's manual suggests to bind `org-agenda' to `C-c a', but doesn't bind >> it by default. > > I'm not even sure that's a great idea. I think not. > > I suppose it's "legit", as the user, not the Org code, would be > making the binding. But in my libraries I provide binding > suggestions only for keys that are not reserved for use by users. > > If a commonly used Emacs library (Org is the best example of that) > suggests to users that they bind `C-c a' to something then that > key becomes pretty much, in effect, lost as a key reserved for > user customization. > > IOW, if 90% of Emacs users follow that suggestion then there is > little difference between that situation and the situation of > Org binding `C-c a' by default. > > My vote would be that Org should not do this. Just one opinion. I understand your concern. However, Org tries to be as neutral as possible with this. Quoting the manual: The manual suggests a few global key bindings, in particular @kbd{C-c a} for @code{org-agenda} and @kbd{C-c c} for @code{org-capture}. These are only suggestions, but the rest of the manual assumes that these key bindings are in place in order to list commands by key access. As explained here, this "suggestion" is only necessary to clarify key bindings in the manual. `org-agenda' and `org-capture' bindings are really prefixes for many other commands. Having to write, e.g., "the prefix you chose for `org-agenda' then #" instead of "C-c a #" would be a lot more verbose, and ultimately, cripple documentation. I think the current state is quite fair. Regards, -- Nicolas Goaziou 0x80A93738