From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: bug#28263: bug#28263: 24.5; Org: `C-c LETTER' keys Date: Mon, 19 Feb 2018 10:24:18 +0100 Message-ID: <87fu5xl4cd.fsf@nicolasgoaziou.fr> 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 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55220) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1enhh3-0007YP-TO for emacs-orgmode@gnu.org; Mon, 19 Feb 2018 04:25:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1enhh0-0000B3-Oi for emacs-orgmode@gnu.org; Mon, 19 Feb 2018 04:25:05 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:42707) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1enhh0-0000Af-JV for emacs-orgmode@gnu.org; Mon, 19 Feb 2018 04:25:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1enhh0-000857-8N for emacs-orgmode@gnu.org; Mon, 19 Feb 2018 04:25:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: (Drew Adams's message of "Sun, 18 Feb 2018 16:26:45 -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: Allen Li , 28263@debbugs.gnu.org Hello, Drew Adams writes: > It's my opinion of what Org mode _should_ do. That's what I meant. > And it coincides with what other libraries do. This doesn't prove the model is right. > And it fits what the manual suggests. Unfortunately, the manual suggests nothing. I think that's the main issue here. > Your opinion is apparently that Emacs (in the Org-mode > doc) should recommend that users sacrifice those keys > to Org. We disagree about that. Not at all. I want _Emacs_ (not the Elisp manual) to tell users about so-called user reserved keys and what are their benefits. Since this isn't the case, Org manual takes care of this. > 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. Not at all. We recommend to bind globally available keys, but only give an example on what the binding should look like. We even invite users to modify them to their own liking. > 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. Note that we are really disagreeing about the definition of being nice to the users. I'm convinced we both want to be nice to them. > 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. I searched the Emacs manual about "global keys" (menu, concept index, regexp). I miserably failed. As a user, what can I do now? > Perhaps someday someone else will finish the job by > removing the manual's suggestion that they should > make that sacrifice, "for a better experience". I will happily remove the part you consider to be offending -- whereas I consider it to be helpful -- once we can point users towards appropriate information within the Emacs manual. Would you like to report a bug about it? Regards, -- Nicolas Goaziou 0x80A93738