GNU bug report logs - #50948
Emacs manual explains mouse-1, mouse-2, mouse-3 after they are used

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 50948 in the body.
You can then email your comments to 50948 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: bug-gnu-emacs <at> gnu.org
Subject: Emacs manual explains mouse-1, mouse-2, mouse-3 after they are used
Date: Fri, 1 Oct 2021 21:20:44 +0200

Severity: wishlist

Maybe we should explain mouse-1, mouse-2, etc. in "(emacs) Keys"?
It's an unusual notation that isn't introduced before its used.  The
same goes for Drag-mouse-1 and probably related keys.

You can see what we have, and in what section it appears, by searching
for "mouse-1" from the start of the manual.  AFAICT, an explanation
only shows up later, in "(emacs) Mouse Commands".

Message #8 received at 50948 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 50948 <at> debbugs.gnu.org
Subject: Re: bug#50948: Emacs manual explains mouse-1, mouse-2,
 mouse-3 after they are used
Date: Fri, 01 Oct 2021 22:34:37 +0300

> From: Stefan Kangas <stefan <at> marxist.se>
> Date: Fri, 1 Oct 2021 21:20:44 +0200
> 
> Severity: wishlist
> 
> Maybe we should explain mouse-1, mouse-2, etc. in "(emacs) Keys"?
> It's an unusual notation that isn't introduced before its used.  The
> same goes for Drag-mouse-1 and probably related keys.

This doesn't belong to keys, IMO.  I think we should mention it more
prominently in "User Input", and then have a separate chapter right
after "Keys" dedicated to mouse clicks.

Message #11 received at 50948 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Stefan Kangas <stefan <at> marxist.se>, 50948 <at> debbugs.gnu.org
Subject: Re: bug#50948: Emacs manual explains mouse-1, mouse-2, mouse-3
 after they are used
Date: Sat, 03 Sep 2022 15:12:41 +0200

Eli Zaretskii <eliz <at> gnu.org> writes:

> This doesn't belong to keys, IMO.  I think we should mention it more
> prominently in "User Input", and then have a separate chapter right
> after "Keys" dedicated to mouse clicks.

I've now taken a stab at this, but I was unsure how much detail to go in
here.  Feel free to shorten/expand.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.