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: \\[...] for a mouse-event command - should never show `M-x' Date: Sat, 23 May 2009 08:39:54 -0700 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1243093221 12987 80.91.229.12 (23 May 2009 15:40:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 23 May 2009 15:40:21 +0000 (UTC) To: Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 23 17:40:14 2009 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 1M7tKX-0000I4-IN for ged-emacs-devel@m.gmane.org; Sat, 23 May 2009 17:40:13 +0200 Original-Received: from localhost ([127.0.0.1]:54589 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M7tKX-0005ds-2n for ged-emacs-devel@m.gmane.org; Sat, 23 May 2009 11:40:13 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1M7tKG-0005Uv-Q5 for emacs-devel@gnu.org; Sat, 23 May 2009 11:39:56 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1M7tKC-0005RC-2B for emacs-devel@gnu.org; Sat, 23 May 2009 11:39:56 -0400 Original-Received: from [199.232.76.173] (port=53108 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M7tKB-0005Qo-R3 for emacs-devel@gnu.org; Sat, 23 May 2009 11:39:51 -0400 Original-Received: from acsinet12.oracle.com ([141.146.126.234]:59450) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M7tKB-00025x-B8 for emacs-devel@gnu.org; Sat, 23 May 2009 11:39:51 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n4NFdVaf001190 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 23 May 2009 15:39:32 GMT Original-Received: from abhmt001.oracle.com (abhmt001.oracle.com [141.146.116.10]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n4NFeSXJ012630 for ; Sat, 23 May 2009 15:40:28 GMT Original-Received: from dradamslap1 (/98.210.250.59) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 23 May 2009 08:39:44 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcnbvLfDo4eIN2aLQbWgnEA9Y393mQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt001.oracle.com [141.146.116.10] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010203.4A1818C0.01E2:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) 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:111035 Archived-At: `C-h v mouse-buffer-menu-mode-mult': ,---- | *Group the buffers by the major mode groups on ? | This number which determines (in a hairy way) whether | will split the buffer menu by the major modes (see | `mouse-buffer-menu-mode-groups') or just by menu length. | Set to 1 (or even 0!) if you want to group by major mode always, and to | a large number if you prefer a mixed multitude. The default is 4. `---- 1. Why the `?' in the first line? Typo? 2. "Mixed multitude"? "This number which determines whether..." - No verb: what does this number (which determines...) do or mean? This doesn't seem to be explained very well. 3. General comment - Suppose a mouse-event command such as `mouse-buffer-menu' is not currently bound (e.g., some code binds `C-mouse-1' to a different mouse command). Then the doc string above shows the binding as "M-x mouse-buffer-menu", which is inaccurate and misleading. The user doc that explains `M-x' clearly doesn't anticipate its use to introduce a command, such as `mouse-buffer-menu', that won't work with `M-x'. See `(emacs)M-x'. When the command passed (via \\[...]) to `substitute-command-keys' is known, is there an easy way for `substitute-command-keys' to know whether the `interactive' spec uses `e'? That wouldn't be failsafe, but it might catch most such commands. We could then use some other indication, instead of `M-x' - perhaps (Mouse): `(Mouse) mouse-buffer-menu'. Or perhaps just use the command name alone: `mouse-buffer-menu'? In any case, `M-x' is inappropriate for mouse-event commands.