@key{Mouse-1}

@key{Mouse-1}

[Eli Zaretskii]

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?

Re: @key{Mouse-1}

[Stefan Monnier]

> 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

Re: @key{Mouse-1}

[Chong Yidong]

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.