* \\[...] for a mouse-event command - should never show `M-x'
@ 2009-05-23 15:39 Drew Adams
2009-05-23 17:29 ` Tassilo Horn
0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2009-05-23 15:39 UTC (permalink / raw)
To: emacs-devel
`C-h v mouse-buffer-menu-mode-mult':
,----
| *Group the buffers by the major mode groups on <C-down-mouse-1>?
| This number which determines (in a hairy way) whether <C-down-mouse-1>
| 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.
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: \\[...] for a mouse-event command - should never show `M-x'
2009-05-23 15:39 \\[...] for a mouse-event command - should never show `M-x' Drew Adams
@ 2009-05-23 17:29 ` Tassilo Horn
2009-05-24 10:21 ` Deniz Dogan
0 siblings, 1 reply; 3+ messages in thread
From: Tassilo Horn @ 2009-05-23 17:29 UTC (permalink / raw)
To: Drew Adams; +Cc: emacs-devel
"Drew Adams" <drew.adams@oracle.com> writes:
Hi,
> `C-h v mouse-buffer-menu-mode-mult':
>
> ,----
> | *Group the buffers by the major mode groups on <C-down-mouse-1>?
> | This number which determines (in a hairy way) whether <C-down-mouse-1>
> | 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
^^^^^^^^^^^^^^
To a mathematician this is "one or even one", so I'd strip the
exclamation mark. ;-)
Bye,
Tassilo
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: \\[...] for a mouse-event command - should never show `M-x'
2009-05-23 17:29 ` Tassilo Horn
@ 2009-05-24 10:21 ` Deniz Dogan
0 siblings, 0 replies; 3+ messages in thread
From: Deniz Dogan @ 2009-05-24 10:21 UTC (permalink / raw)
To: Tassilo Horn; +Cc: Drew Adams, emacs-devel
2009/5/23 Tassilo Horn <tassilo@member.fsf.org>:
> "Drew Adams" <drew.adams@oracle.com> writes:
>> `C-h v mouse-buffer-menu-mode-mult':
>>
>> ,----
>> | *Group the buffers by the major mode groups on <C-down-mouse-1>?
>> | This number which determines (in a hairy way) whether <C-down-mouse-1>
>> | 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
> ^^^^^^^^^^^^^^
> To a mathematician this is "one or even one", so I'd strip the
> exclamation mark. ;-)
And it's not even even!
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2009-05-24 10:21 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-05-23 15:39 \\[...] for a mouse-event command - should never show `M-x' Drew Adams
2009-05-23 17:29 ` Tassilo Horn
2009-05-24 10:21 ` Deniz Dogan
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.