* @key{Mouse-1}
@ 2008-10-19 8:58 Eli Zaretskii
2008-10-19 13:06 ` @key{Mouse-1} Stefan Monnier
2008-10-19 14:58 ` @key{Mouse-1} Chong Yidong
0 siblings, 2 replies; 3+ messages in thread
From: Eli Zaretskii @ 2008-10-19 8:58 UTC (permalink / raw)
To: Chong Yidong; +Cc: emacs-devel, Richard Stallman, Karl Berry
This fragment of a change for the Emacs manual:
@findex mouse-secondary-save-then-kill
@kindex M-Mouse-3
-@item M-Mouse-3
-Make a secondary selection, using the place specified with @kbd{M-Mouse-1}
-as the other end (@code{mouse-secondary-save-then-kill}). This also
-puts the selected text in the kill ring. A second click at the same
+@item M-@key{Mouse-3}
+Set the secondary selection, with one end at the position clicked and
+the other at the position specified with @kbd{M-Mouse-1}
+(@code{mouse-secondary-save-then-kill}). This also puts the selected
+text in the kill ring. A second @kbd{M-@key{Mouse-3}} at the same
place kills the secondary selection just made.
is typical of changes installed recently that use @key for mouse
buttons. Yet is this usage correct?
The Texinfo manual says:
Use the `@key' command for the conventional name for a key on a
keyboard
and proceeds to give examples that only involve keyboard keys. In a
printed manual, @key{Foo} is typeset as a graphical image of a keyboard
key, with the argument "Foo" as its label. Do we want to see a
keyboard key labeled "Mouse-1" in the printed manual?
Maybe we should add a @button command to Texinfo?
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: @key{Mouse-1}
2008-10-19 8:58 @key{Mouse-1} Eli Zaretskii
@ 2008-10-19 13:06 ` Stefan Monnier
2008-10-19 14:58 ` @key{Mouse-1} Chong Yidong
1 sibling, 0 replies; 3+ messages in thread
From: Stefan Monnier @ 2008-10-19 13:06 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: Chong Yidong, Karl Berry, Richard Stallman, emacs-devel
> and proceeds to give examples that only involve keyboard keys. In a
> printed manual, @key{Foo} is typeset as a graphical image of a keyboard
> key, with the argument "Foo" as its label. Do we want to see a
> keyboard key labeled "Mouse-1" in the printed manual?
It does look odd indeed. But I'm not sure how it /should/ look like.
> Maybe we should add a @button command to Texinfo?
Fine by me, tho Emacs won't be able to use it right away, IIUC.
Stefan
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: @key{Mouse-1}
2008-10-19 8:58 @key{Mouse-1} Eli Zaretskii
2008-10-19 13:06 ` @key{Mouse-1} Stefan Monnier
@ 2008-10-19 14:58 ` Chong Yidong
1 sibling, 0 replies; 3+ messages in thread
From: Chong Yidong @ 2008-10-19 14:58 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel, Richard Stallman, Karl Berry
Eli Zaretskii <eliz@gnu.org> writes:
> -@item M-Mouse-3
> +@item M-@key{Mouse-3}
>
> is typical of changes installed recently that use @key for mouse
> buttons. Yet is this usage correct?
I think mouse buttons should be in @key, for consistency with the output
of `C-h k' and `kbd'.
However, I made a mistake here: the entirety of M-Mouse-3 should be
enclosed in @key, not just the Mouse-3 part.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2008-10-19 14:58 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-10-19 8:58 @key{Mouse-1} Eli Zaretskii
2008-10-19 13:06 ` @key{Mouse-1} Stefan Monnier
2008-10-19 14:58 ` @key{Mouse-1} Chong Yidong
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.