@key{Mouse-1}

[Eli Zaretskii]

This fragment of a change for the Emacs manual:

    @findex mouse-secondary-save-then-kill
    @kindex M-Mouse-3
   address@hidden 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
   address@hidden address@hidden
   +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 @address@hidden 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 address@hidden' 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?