From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#14088: 24.3.50; Document or replace it in `substitute-command-keys' Date: Fri, 29 Mar 2013 08:52:59 -0700 Message-ID: <9642A640E98A4154A8F1AB3C372DB6C3@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1364572411 27258 80.91.229.3 (29 Mar 2013 15:53:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 29 Mar 2013 15:53:31 +0000 (UTC) To: 14088@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 29 16:53:58 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ULbcr-0002S3-5u for geb-bug-gnu-emacs@m.gmane.org; Fri, 29 Mar 2013 16:53:57 +0100 Original-Received: from localhost ([::1]:50878 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbcS-0001A2-Um for geb-bug-gnu-emacs@m.gmane.org; Fri, 29 Mar 2013 11:53:32 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:41091) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbcO-00019v-Fq for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ULbcM-0001xN-KG for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:28 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47008) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbcM-0001xE-H7 for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:26 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1ULber-0000Kx-U6 for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:56:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 29 Mar 2013 15:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 14088 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13645725591281 (code B ref -1); Fri, 29 Mar 2013 15:56:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Mar 2013 15:55:59 +0000 Original-Received: from localhost ([127.0.0.1]:51117 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1ULbem-0000KW-4n for submit@debbugs.gnu.org; Fri, 29 Mar 2013 11:55:57 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:57893) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1ULbeg-0000KH-DM for submit@debbugs.gnu.org; Fri, 29 Mar 2013 11:55:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ULbc8-0001rf-3Q for submit@debbugs.gnu.org; Fri, 29 Mar 2013 11:53:13 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:60454) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbc8-0001rb-12 for submit@debbugs.gnu.org; Fri, 29 Mar 2013 11:53:12 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40995) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbc5-00017y-5W for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ULbc3-0001qQ-DE for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:09 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:37623) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ULbc3-0001qC-6d for bug-gnu-emacs@gnu.org; Fri, 29 Mar 2013 11:53:07 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r2TFr5X2031747 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 29 Mar 2013 15:53:06 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r2TFr4KW015749 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 29 Mar 2013 15:53:05 GMT Original-Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r2TFr4tN018818 for ; Fri, 29 Mar 2013 10:53:04 -0500 Original-Received: from dradamslap1 (/10.159.148.114) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 29 Mar 2013 08:53:04 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac4slXyg+qq5dHe0QLKgyy+2paCXlw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] 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.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:72979 Archived-At: emacs -Q Type in *scratch*: (substitute-command-keys "\\{isearch-mode-map}") C-u C-x C-e Search for "isearch-other-control-char". It is shown bound to the key C-h . This is technically correct, as corresponds to (define-key isearch-mode-map [t] 'isearch-other-control-char) But users will not understand the notation . It is mentioned nowhere in any Emacs manual. And there certainly is no function key `t'. If a user searches well enough and reads a bit, s?he might understand that here corresponds to this text about `define-key' in (elisp) `Changing Key Bindings': If KEY is `[t]', this sets the default binding in KEYMAP. When an event has no binding of its own, the Emacs command loop uses the keymap's default binding, if there is one. But users cannot be expected to do all that and make the necessary connections. User-friendly output here would use a simple description in place of . Something like "Default key binding". But such a user-friendly description should really be moved out of the list, putting it either before or after the list, since this is not a single binding of a specific key. This is a bit like our treatment of `Prefix command', but in reverse: in this case it is the key column that needs the general description. But the case of `C-h ' shows that we need some descriptive text that can be placed after a prefix key. So perhaps instead of "Default key binding" we could use "OTHER", making it a link to a sentence that says it stands for any key not otherwise defined. E.g., C-h OTHER with OTHER linked to "footnote" text like this: OTHER indicates any key not otherwise defined. An alternative would be to have the manuals introduce as meaning what we are currently using it for. That could be OK too, since one cannot define a function key `t' in any case. The manuals tell Lisp programmers what [t] means for `define-key', but they don't tell users what means as a key description. This alternative is perhaps not as helpful for a newbie as using something like C-h OTHER with an explanation. But it would be useful anyway, not just as an alternative here, but for completion of the doc. Something like (kbd "") might become less puzzling etc. One way or another, the current undocumented and unclear use of needs to be taken care of. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-03-23 on VBOX Bzr revision: 112115 eliz@gnu.org-20130323093300-rjs0dgskxm9u0ya4 Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/emacs/libs/libXpm-3.5.10/include -IC:/emacs/libs/libXpm-3.5.10/src -IC:/emacs/libs/libpng-dev_1.4.3-1_win32/include -IC:/emacs/libs/zlib-dev_1.2.5-2_win32/include -IC:/emacs/libs/giflib-4.1.4-1-lib/include -IC:/emacs/libs/jpeg-6b-4-lib/include -IC:/emacs/libs/tiff-3.8.2-1-lib/include -IC:/emacs/libs/libxml2-2.7.8-w32-bin/include/libxml2 -IC:/emacs/libs/gnutls-3.1.10-w32/include -IC:/emacs/libs/libiconv-1.14-2-mingw32-dev/include'