From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#30530: 26.0; Emacs manual: mention (1) user-reserved keys, (2) users can bind any keys Date: Mon, 19 Feb 2018 08:16:09 -0800 (PST) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1519056929 25385 195.159.176.226 (19 Feb 2018 16:15:29 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 19 Feb 2018 16:15:29 +0000 (UTC) To: 30530@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Feb 19 17:15:25 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 1eno5q-0005Cb-2G for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Feb 2018 17:15:06 +0100 Original-Received: from localhost ([::1]:51044 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eno7s-0003oH-3x for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Feb 2018 11:17:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38753) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eno7l-0003ns-Ha for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:17:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eno7i-0001DV-8d for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:17:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43590) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eno7i-0001DR-3U for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:17:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eno7h-0003Ip-Tg for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:17:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 19 Feb 2018 16:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 30530 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.151905699412656 (code B ref -1); Mon, 19 Feb 2018 16:17:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Feb 2018 16:16:34 +0000 Original-Received: from localhost ([127.0.0.1]:51487 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eno7G-0003I3-Gm for submit@debbugs.gnu.org; Mon, 19 Feb 2018 11:16:34 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:47583) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eno7C-0003Hn-6R for submit@debbugs.gnu.org; Mon, 19 Feb 2018 11:16:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eno76-0000zT-2d for submit@debbugs.gnu.org; Mon, 19 Feb 2018 11:16:25 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:39848) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eno75-0000zP-Un for submit@debbugs.gnu.org; Mon, 19 Feb 2018 11:16:23 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38546) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eno74-0003gv-RN for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:16:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eno71-0000xn-H6 for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:16:22 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:43454) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eno71-0000wt-7S for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 11:16:19 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w1JGCXkQ052271 for ; Mon, 19 Feb 2018 16:16:11 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=KjkMYI53Fy75UCZng+LPi+2McvfvgMLKbqxtRFtN01Y=; b=UQiNkusZYhb0EPRar29d9I+xfDZtTPiDd4u5Ea6J3pjAidheKaiNAr3Z5bVHrfhlJxKQ 6dtBvBfPtUkw+fr+2ESNtpizgeYp58CKGDIB9xhTfyqdE4jjbx9Zi0BtPgHL6QphXQ/G Yw8wSV+eNMz3KL+Qi+XZpIJqK/u81G4A6PkUc2ufeL1PbzXTI/o0HgGGahS+VEOhtfj3 HDhqKZxW5UKOR/FSVta0uD3Gvb3swOVwWmB+MDZhF4x+3UAYobRlZ6NashhUnudFMxVs pzBDX0FxDjkB/fgLI/VYLTKFI23xk58r0jEJ4ilSDQTlEJ/brp+5nGO6MLw72X3V83qi lA== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2120.oracle.com with ESMTP id 2g818f871w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 19 Feb 2018 16:16:11 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w1JGGAZY026388 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Mon, 19 Feb 2018 16:16:10 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w1JGG9sD003406 for ; Mon, 19 Feb 2018 16:16:09 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4654.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8808 signatures=668674 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1802190201 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:143457 Archived-At: Following up on the request by Nicolas Goaziou in bug #28263, please consider adding some information about the keys that users can bind. Please: 1. Say that Emacs and 3rd-party Lisp libraries often bind keys, but that some keys are specifically reserved, by convention, for users. Point out which keys are reserved for users. 2. Make it clear that users can, in any case, bind ANY keys they want; they are not limited to binding user-reserved keys. In particular, users can rebind keys that Emacs or some 3rd-party library has already bound. 3. State that after a user has bound a key, evaluating some Emacs code (including loading a Lisp library) might rebind that key if it is not reserved for users. This is the reason some keys are reserved for users: to prevent the bother of some non-user code overriding user key bindings. The keys reserved for users are currently specified only in the Elisp manual (node `Key Binding Conventions'). Please consider adding a link to that node from wherever the user-reserved keys will be called out in the Emacs manual. A likely location in the Emacs manual for such info would be somewhere under node `Customizing Key Bindings'. In GNU Emacs 26.0.91 (build 1, x86_64-w64-mingw32) of 2018-01-22 Repository revision: 752fba992b793a74d202c9cfc3e1a92fd458e748 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''