From mboxrd@z Thu Jan 1 00:00:00 1970 From: Drew Adams Subject: bug#28263: bug#28263: 24.5; Org: `C-c LETTER' keys Date: Sun, 18 Feb 2018 16:26:45 -0800 (PST) Message-ID: References: <936768a0-1a2e-4a89-8a11-8f1779f8591d@default> <87374qb21u.fsf@nicolasgoaziou.fr> <0f47b7da-82d7-4521-aaf6-f2430876ccc2@default> <87h8t59zxg.fsf@nicolasgoaziou.fr> <871shilz7h.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:49073) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1enZJN-0002xB-W8 for emacs-orgmode@gnu.org; Sun, 18 Feb 2018 19:28:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1enZJK-0000wR-Pk for emacs-orgmode@gnu.org; Sun, 18 Feb 2018 19:28:05 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:42420) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1enZJK-0000wK-Ir for emacs-orgmode@gnu.org; Sun, 18 Feb 2018 19:28:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1enZJK-0002to-7Q for emacs-orgmode@gnu.org; Sun, 18 Feb 2018 19:28:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <871shilz7h.fsf@nicolasgoaziou.fr> 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: Nicolas Goaziou Cc: Allen Li , 28263-done@debbugs.gnu.org > Drew Adams writes: >=20 > > No. I'm saying that Org should not suggest that > > users bind keys that are reserved for use by users > > to Org commands. > > > > And it should not then present those keys in the doc. > > > > And it should not say anything about the doc using > > those keys for illustrative purposes or assuming > > that users have bound those keys. > > > > Org should do _nothing_ with such reserved keys. > > It should not mention them at all in its doc. >=20 > This is your own interpretation of the two paragraphs in > the Elisp manual that treat about reserved keys, IMO. It's my opinion of what Org mode _should_ do. And it coincides with what other libraries do. And it fits what the manual suggests. Your opinion is apparently that Emacs (in the Org-mode doc) should recommend that users sacrifice those keys to Org. We disagree about that. You want Emacs to (1) tell users that these keys are reserved for them to bind, BUT also to (2) recommend that if they use Org mode (which most users probably do now) then they should bind them to Org commands. I don't want Emacs to do #2. #1 is good; #2 is bad, and it, in effect, undercuts #1. In my opinion no library should suggest that users sacrifice their reserved keys for that library. Users are free to do that, of course. But it's impolite, IMO, for a library to recommend that they do so. Users aren't stupid - they can figure out, if they end up using some commands often, that they might want to bind them to keys, including perhaps to their reserved keys. They don't need a library to pitch them that idea. And newbie users might well get the wrong idea that they really need to follow that suggestion or they could have a "bad experience". Libraries that are purely 3rd-party can of course do anything they like (not that they should, but they can). But I'd offer the same opinion for purely 3rd-party libraries: Don't recommend that users globally bind their reserved keys for your mode. Org mode is not only a 3rd-party library. It is now part of GNU Emacs. All the more reason to be nice to users. > Anyway, for the record, I modified Org manual (for Org 9.2) so it > doesn't assume anymore users followed advice and bound `C-c a', `C-c > l'... In fact, I removed every reference to user reserved keybindings, Very good. Thank you for doing the right thing there. > but one, in the following paragraphs: > > 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. >=20 > #+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 Not good, IMHO. And there is _no need_ to mention those keys. It should be fine and enough to leave off the part about ", like the ones reserved ... #+end_src." That part's not needed for users to understand that if they want global behavior then they can bind global keys - which is the only message you need to get across about those commands. And, once again, those words shamefacedly suggest that users use those keys. Same problem. Again: > > Org should not suggest that users bind keys that > > are reserved for use by users to Org commands. Org is widely used. Recommending that users use those keys for Org is nearly tantamount to no longer reserving them for users. Not quite as bad as actually binding them to Org commands on their behalf (which would clearly contravene the guideline), but almost as bad. And totally unnecessary. > I dare to think this is a good enough advice to belong to the manual, > with enough safeguards to let users know what it entails. I also think > it is fair, because the manual doesn't talk about these bindings anymore > later on. I'm on record, at least, as disagreeing with that. One opinion. Anyway, thank you for no longer having the rest of the Org manual depend on the assumption that users have sacrificed those keys to Org. Perhaps someday someone else will finish the job by removing the manual's suggestion that they should make that sacrifice, "for a better experience".