From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Nicolas Goaziou Newsgroups: gmane.emacs.bugs Subject: bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys Date: Sat, 24 Feb 2018 22:27:48 +0100 Message-ID: <87zi3y13jf.fsf@nicolasgoaziou.fr> References: > <83lgfi4qw2.fsf@gnu.org>> <529ae5d2-b5e8-40d1-aaa6-87a76003b8bc@default> <83h8q62sgd.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1519507571 23616 195.159.176.226 (24 Feb 2018 21:26:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 24 Feb 2018 21:26:11 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux) Cc: 30530-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Feb 24 22:26:07 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ephKY-0005jW-Qy for geb-bug-gnu-emacs@m.gmane.org; Sat, 24 Feb 2018 22:26:06 +0100 Original-Received: from localhost ([::1]:51505 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ephMb-0003gq-2C for geb-bug-gnu-emacs@m.gmane.org; Sat, 24 Feb 2018 16:28:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46210) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ephMV-0003gf-CH for bug-gnu-emacs@gnu.org; Sat, 24 Feb 2018 16:28:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ephMQ-0003XI-CD for bug-gnu-emacs@gnu.org; Sat, 24 Feb 2018 16:28:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51203) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ephMQ-0003Wo-8r for bug-gnu-emacs@gnu.org; Sat, 24 Feb 2018 16:28:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ephMQ-0006pv-2a for bug-gnu-emacs@gnu.org; Sat, 24 Feb 2018 16:28:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Nicolas Goaziou Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 24 Feb 2018 21:28:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30530 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30530-done@debbugs.gnu.org id=D30530.151950767426263 (code D ref 30530); Sat, 24 Feb 2018 21:28:02 +0000 Original-Received: (at 30530-done) by debbugs.gnu.org; 24 Feb 2018 21:27:54 +0000 Original-Received: from localhost ([127.0.0.1]:59100 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ephMI-0006pX-AR for submit@debbugs.gnu.org; Sat, 24 Feb 2018 16:27:54 -0500 Original-Received: from relay3-d.mail.gandi.net ([217.70.183.195]:41063) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ephMG-0006pP-Ap for 30530-done@debbugs.gnu.org; Sat, 24 Feb 2018 16:27:52 -0500 Original-Received: from saiph (00004301584731203741b516.ipv6.commingeshautdebit.fr [IPv6:2a03:a0a0:0:4301:5847:3120:3741:b516]) (Authenticated sender: admin@nicolasgoaziou.fr) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 95677A80C8; Sat, 24 Feb 2018 22:27:50 +0100 (CET) Original-Received: from ngz by saiph with local (Exim 4.89) (envelope-from ) id 1ephMC-0002cY-8k; Sat, 24 Feb 2018 22:27:48 +0100 In-Reply-To: <83h8q62sgd.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 24 Feb 2018 19:44:18 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:143646 Archived-At: Hello, Eli Zaretskii writes: > I added some text about the latter, although I seriously doubt that it > will be discoverable enough to make any difference. Thank you. For good measure, could you also add a @cindex about it? E.g, @cindex user reserved key bindings For reference, this bug report stems from the following part of the Org manual: 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 can hear that argument, and would happily stop the paragraph at "globally available keys". However, I have the feeling this deserves a cross-reference, and an appendix in the Elisp manual doesn't sound like an appropriate location. Regards, -- Nicolas Goaziou 0x80A93738