From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Lennart Borgman (gmail)" Newsgroups: gmane.emacs.devel Subject: Why does the key binding list say "Prefix Command"? Date: Wed, 28 Nov 2007 17:41:13 +0100 Message-ID: <474D9A29.1090202@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1196268202 31717 80.91.229.12 (28 Nov 2007 16:43:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 28 Nov 2007 16:43:22 +0000 (UTC) To: Emacs Devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 28 17:43:31 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IxQ0W-0000nk-2R for ged-emacs-devel@m.gmane.org; Wed, 28 Nov 2007 17:43:28 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IxQ0G-00032z-Kw for ged-emacs-devel@m.gmane.org; Wed, 28 Nov 2007 11:43:12 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IxPyR-00022A-Oc for emacs-devel@gnu.org; Wed, 28 Nov 2007 11:41:19 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IxPyP-00020o-Sm for emacs-devel@gnu.org; Wed, 28 Nov 2007 11:41:19 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IxPyP-00020d-9y for emacs-devel@gnu.org; Wed, 28 Nov 2007 11:41:17 -0500 Original-Received: from ch-smtp01.sth.basefarm.net ([80.76.149.212]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IxPyP-0005le-Ak for emacs-devel@gnu.org; Wed, 28 Nov 2007 11:41:17 -0500 Original-Received: from c83-254-148-228.bredband.comhem.se ([83.254.148.228]:64353 helo=[127.0.0.1]) by ch-smtp01.sth.basefarm.net with esmtp (Exim 4.68) (envelope-from ) id 1IxPyN-0005U7-3m for emacs-devel@gnu.org; Wed, 28 Nov 2007 17:41:15 +0100 User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.9) Gecko/20071031 Thunderbird/2.0.0.9 Mnenhy/0.7.5.666 X-Antivirus: avast! (VPS 071127-0, 2007-11-27), Outbound message X-Antivirus-Status: Clean X-Originating-IP: 83.254.148.228 X-Scan-Result: No virus found in message 1IxPyN-0005U7-3m. X-Scan-Signature: ch-smtp01.sth.basefarm.net 1IxPyN-0005U7-3m b689954f650dbd6f06b73343c9177b90 X-detected-kernel: by monty-python.gnu.org: Linux 2.6? (barebone, rare!) 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:84245 Archived-At: If you add something like this to a doc string \\{my-keymap} the listing may contain several entries where the key binding is "Prefix Command". In what way is it useful to tell this in the list? Does not that just confuse users? PS: Some time ago I asked if not commands in key binding listings should be surrounded with apostrophes (ie `the-command') so that they were made into clickabe links. I think I got no respons. What do you think? In addition to that I wonder if it would not be useful with an optional long form of the key binding listing where the first line of the doc string where put on the line below (indented with some spaces).