From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys Date: Thu, 01 Mar 2018 17:44:29 +0200 Message-ID: <83d10nyf4y.fsf@gnu.org> References: > <83lgfi4qw2.fsf@gnu.org>> <529ae5d2-b5e8-40d1-aaa6-87a76003b8bc@default> <83h8q62sgd.fsf@gnu.org> <87zi3y13jf.fsf@nicolasgoaziou.fr> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1519919000 5659 195.159.176.226 (1 Mar 2018 15:43:20 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 1 Mar 2018 15:43:20 +0000 (UTC) Cc: 30530@debbugs.gnu.org To: Nicolas Goaziou Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Mar 01 16:43:16 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 1erQMV-0000zp-ED for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Mar 2018 16:43:15 +0100 Original-Received: from localhost ([::1]:57688 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1erQOY-0006xA-04 for geb-bug-gnu-emacs@m.gmane.org; Thu, 01 Mar 2018 10:45:22 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54581) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1erQOK-0006oW-25 for bug-gnu-emacs@gnu.org; Thu, 01 Mar 2018 10:45:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1erQOF-0003ZK-Uc for bug-gnu-emacs@gnu.org; Thu, 01 Mar 2018 10:45:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:59818) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1erQOF-0003Z4-RE for bug-gnu-emacs@gnu.org; Thu, 01 Mar 2018 10:45:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1erQOE-0002sG-Bm for bug-gnu-emacs@gnu.org; Thu, 01 Mar 2018 10:45:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 01 Mar 2018 15:45: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-submit@debbugs.gnu.org id=B30530.151991907010996 (code B ref 30530); Thu, 01 Mar 2018 15:45:02 +0000 Original-Received: (at 30530) by debbugs.gnu.org; 1 Mar 2018 15:44:30 +0000 Original-Received: from localhost ([127.0.0.1]:39482 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1erQNi-0002rI-9l for submit@debbugs.gnu.org; Thu, 01 Mar 2018 10:44:30 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:35177) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1erQNh-0002r6-8i for 30530@debbugs.gnu.org; Thu, 01 Mar 2018 10:44:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1erQNX-0003BT-W5 for 30530@debbugs.gnu.org; Thu, 01 Mar 2018 10:44:24 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:55007) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1erQNX-0003BH-Rl; Thu, 01 Mar 2018 10:44:19 -0500 Original-Received: from [176.228.60.248] (port=4685 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1erQNW-00042e-Dm; Thu, 01 Mar 2018 10:44:19 -0500 In-reply-to: <87zi3y13jf.fsf@nicolasgoaziou.fr> (message from Nicolas Goaziou on Sat, 24 Feb 2018 22:27:48 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:143786 Archived-At: > From: Nicolas Goaziou > Cc: Drew Adams , 30530-done@debbugs.gnu.org > Date: Sat, 24 Feb 2018 22:27:48 +0100 > > For good measure, could you also add a @cindex about it? E.g, > > @cindex user reserved key bindings Starting an index entry with "user" is not a good idea, as it's too general a word. I added "reserved key bindings" instead. > 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 disagree with Drew. By that logic, no one can ever say anything about binding these keys, and they must always remain unbound, which of course would defeat the reason for reserving them.