From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Newsgroups: gmane.emacs.bugs Subject: bug#7803: 23.1; Need better definition of vector notation in define-key Date: Fri, 07 Jan 2011 15:12:23 -0600 Message-ID: <871v4o1kqw.fsf@pop.suddenlink.net> NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1294435534 20073 80.91.229.12 (7 Jan 2011 21:25:34 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 7 Jan 2011 21:25:34 +0000 (UTC) To: 7803@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jan 07 22:25:30 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PbJoO-0002Rr-P0 for geb-bug-gnu-emacs@m.gmane.org; Fri, 07 Jan 2011 22:25:29 +0100 Original-Received: from localhost ([127.0.0.1]:35715 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PbJoN-0006n0-D7 for geb-bug-gnu-emacs@m.gmane.org; Fri, 07 Jan 2011 16:25:27 -0500 Original-Received: from [140.186.70.92] (port=59183 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PbJn0-0006XW-Ad for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:24:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PbJmy-0005Mw-VR for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:24:02 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54065) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PbJmy-0005Mp-OO for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:24:00 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PbJbO-0004MF-8U; Fri, 07 Jan 2011 16:12:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 07 Jan 2011 21:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7803 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.129443470816720 (code B ref -1); Fri, 07 Jan 2011 21:12:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Jan 2011 21:11:48 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PbJb9-0004Lc-EH for submit@debbugs.gnu.org; Fri, 07 Jan 2011 16:11:48 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PbJUn-0004D9-VO for submit@debbugs.gnu.org; Fri, 07 Jan 2011 16:05:15 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PbJbq-0003Qf-Ed for submit@debbugs.gnu.org; Fri, 07 Jan 2011 16:12:31 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:42215) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PbJbq-0003Qa-An for submit@debbugs.gnu.org; Fri, 07 Jan 2011 16:12:30 -0500 Original-Received: from [140.186.70.92] (port=41615 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PbJbo-0001dW-MY for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:12:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PbJbn-0003Q9-C5 for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:12:28 -0500 Original-Received: from omta02-pub.suddenlink.net ([208.180.40.74]:53313 helo=omta02.suddenlink.net) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PbJbn-0003Px-6m for bug-gnu-emacs@gnu.org; Fri, 07 Jan 2011 16:12:27 -0500 Original-Received: from evansl-desktop ([74.192.28.166]) by omta02.suddenlink.net (InterMail vM.7.09.02.06 201-2219-117-110-20091224) with ESMTP id <20110107211223.MVJJ14137.omta02.suddenlink.net@evansl-desktop> for ; Fri, 7 Jan 2011 15:12:23 -0600 X-Cloudmark-Analysis: v=1.1 cv=1ySWNNja79c/jgOHmXRKbmV/BjW144TMdFddqTN+fW0= c=1 sm=0 a=lklJgEX9kLIA:10 a=QAYzQTy68j8A:10 a=aR16PxjQAAAA:8 a=tjUEH51kz3XLGAhYdI4A:9 a=Z7gFFjccUrZBWWnPPPQA:7 a=vqqD9AsOlfKQ4pHa4Bz7b-jk2BEA:4 a=CiSHi91Bn78A:10 a=e8b8xb1BFzkcv4KU:21 a=lzPrAEvrtQv9u6K9:21 a=HpAAvcLHHh0Zw7uRqdWCyQ==:117 X-detected-operating-system: by eggs.gnu.org: Solaris 10 (1203?) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Mailman-Approved-At: Fri, 07 Jan 2011 16:11:45 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 07 Jan 2011 16:12:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Mailman-Approved-At: Fri, 07 Jan 2011 16:25:23 -0500 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:43197 Archived-At: This is a documentation bug only. I was trying to figure out how to specify either tab and shift-tab as the KEY argument to define-key. While in emacs, I entered commands: C-h i m Elisp i define-key this got me to an info node where the mode line contained: *info* (elisp) Changing Key Bindings 25% (48,0) (Info Narrow) which contained: -- Function: define-key keymap key binding This function sets the binding for KEY in KEYMAP. (If KEY is more than one event long, the change is actually made in another keymap reached from KEYMAP.) The argument BINDING can be any Lisp object, but only certain types are meaningful. (For a list of meaningful types, see *note Key Lookup::.) The value returned by `define-key' is BINDING. 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. however, there's no explanation of what t in `[t]' can be. Also, the phrase, 'default binding', implies there's a non-default binding. IOW, there's more than one binding for a KEY, which is confusing to me because that implies a KEY is ambiguous, i.e. pressing KEY could mean either execute the default or non-default binding. A link to some explanation of 'default binding' would clarify. Elsewhere in the 'Changing Key Bindings' info node, there's this: In writing the key sequence to rebind, it is good to use the special escape sequences for control and meta characters (*note String Type::). The syntax `\C-' means that the following character is a control character and `\M-' means that the following character is a meta character. Thus, the string `"\M-x"' is read as containing a single `M-x', `"\C-f"' is read as containing a single `C-f', and `"\M-\C-x"' and `"\C-\M-x"' are both read as containing a single `C-M-x'. You can also use this escape syntax in vectors, as well as others that aren't allowed in strings; one example is `[?\C-\H-x home]'. *Note Character Type::. However, there's no indication of what the code for shift is. I could guess \S; however, that should be explicitly shown or a link provided which does show it. Only by browsing around info could I find this: The Lisp syntax for the shift bit is `\S-'; thus, `?\C-\S-o' or `?\C-\S-O' represents the shifted-control-o character. in the 'Other Char Bits' info node. In GNU Emacs 23.1.1 (x86_64-pc-linux-gnu, GTK+ Version 2.20.0) of 2010-03-29 on yellow, modified by Debian Windowing system distributor `The X.Org Foundation', version 11.0.10706000 configured using `configure '--build=x86_64-linux-gnu' '--host=x86_64-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs23:/etc/emacs:/usr/local/share/emacs/23.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/23.1/site-lisp:/usr/share/emacs/site-lisp:/usr/share/emacs/23.1/leim' '--with-x=yes' '--with-x-toolkit=gtk' '--with-toolkit-scroll-bars' 'build_alias=x86_64-linux-gnu' 'host_alias=x86_64-linux-gnu' 'CFLAGS=-DDEBIAN -g -O2' 'LDFLAGS=-g' 'CPPFLAGS='' Important settings: value of $LC_ALL: C value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: en_US.utf8 value of $XMODIFIERS: nil locale-coding-system: nil default-enable-multibyte-characters: t Major mode: Dired by name Minor modes in effect: desktop-save-mode: t global-auto-revert-mode: t recentf-mode: t tooltip-mode: t tool-bar-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t transient-mark-mode: t Recent input: C-x 2 C-a e C-@ > C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-p C-n C-n C-n C-n C-n C-n C-n C-n C-n C-n x r e p o r t - e m Recent messages: uncompressing emacs-7.gz...done uncompressing emacs-8.gz...done Wrote /home/evansl/.emacs.desktop.lock Desktop: 10 buffers restored, 1 failed to restore. c-tab-stop-my-list message For information about GNU Emacs and the GNU system, type C-h C-a. Startup with window [1] c-tab-stop-my-list message Mark set [3 times] Auto-saving...done