From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: defcustom :type to use for a key sequence? Date: Tue, 20 Dec 2005 09:32:25 -0800 Message-ID: References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1135105806 21477 80.91.229.2 (20 Dec 2005 19:10:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 20 Dec 2005 19:10:06 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 20 20:10:06 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Eomqe-0007ff-3I for ged-emacs-devel@m.gmane.org; Tue, 20 Dec 2005 20:08:32 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EomrY-0006hb-5S for ged-emacs-devel@m.gmane.org; Tue, 20 Dec 2005 14:09:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EolMf-0005fQ-6R for emacs-devel@gnu.org; Tue, 20 Dec 2005 12:33:29 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EolMc-0005eJ-Oq for emacs-devel@gnu.org; Tue, 20 Dec 2005 12:33:28 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EolMc-0005e7-BP for emacs-devel@gnu.org; Tue, 20 Dec 2005 12:33:26 -0500 Original-Received: from [148.87.122.30] (helo=rgminet01.oracle.com) by monty-python.gnu.org with esmtp (TLS-1.0:DHE_RSA_3DES_EDE_CBC_SHA:24) (Exim 4.34) id 1EolPl-0004lB-UN for emacs-devel@gnu.org; Tue, 20 Dec 2005 12:36:42 -0500 Original-Received: from rgmsgw301.us.oracle.com (rgmsgw301.us.oracle.com [138.1.186.50]) by rgminet01.oracle.com (Switch-3.1.6/Switch-3.1.6) with ESMTP id jBKHWQLl009966 for ; Tue, 20 Dec 2005 10:32:26 -0700 Original-Received: from rgmsgw301.us.oracle.com (localhost [127.0.0.1]) by rgmsgw301.us.oracle.com (Switch-3.1.7/Switch-3.1.7) with ESMTP id jBKHWPOE020291 for ; Tue, 20 Dec 2005 10:32:25 -0700 Original-Received: from dradamslap (dradams-lap.us.oracle.com [130.35.177.126]) by rgmsgw301.us.oracle.com (Switch-3.1.7/Switch-3.1.7) with SMTP id jBKHWPZL020283 (version=TLSv1/SSLv3 cipher=RC4-MD5 bits=128 verify=NO) for ; Tue, 20 Dec 2005 10:32:25 -0700 Original-To: "Emacs-Devel" X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1506 In-Reply-To: Importance: Normal X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:48104 Archived-At: > Obviously, I'm not real clear on `kbd'. I don't find the > Elisp manual too helpful on that either. True. > If the external string (print) representation were used, as I > think you suggest, then users would need to know the various > string representations. That sounds like a good way to go. > However, IMO, the presentation in the Elisp manual would need > to be a bit better, if we start expecting users to > use things like "" vs "S-TAB" to define bindings. With the patch I just sent, you can customize the-key by pressing C-q followed by the actual key chord. So if you press shift+tab, it inserts "the right thing" whether or "S-TAB" is needed. That would be very good (natural). This should be mentioned in the manual and in the Customize UI somehow. > Also, would the Emacs (not just Elisp) manual then also need > to describe the string (print) representations? Maybe it's > normal that only the Elisp manual describes key-binding > syntax, but if we expect Customize users to specify > key sequences using string (print) representations, then they > will need to know the syntax. They just need to know about C-q ... > I'd like to see a good, clear description of how to specify > any and all bindings with `kbd'. Me too... Let's hope someone volounteers to write it! Thanks for working on this, Kim. I haven't tried it yet, but it sounds great.