GNU bug report logs - #76812
vestigial elisp manual descriptions of obsolete variables mouse-wheel-up/down-event

Previous Next

Package: emacs;

Reported by: JD Smith <jdtsmith <at> gmail.com>

Date: Fri, 7 Mar 2025 13:50:02 UTC

Severity: minor

Full log

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

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: Stefan Kangas <stefankangas <at> gmail.com>
Cc: 76812 <at> debbugs.gnu.org, JD Smith <jdtsmith <at> gmail.com>
Subject: Re: bug#76812: vestigial elisp manual descriptions of obsolete
 variables mouse-wheel-up/down-event
Date: Fri, 07 Mar 2025 12:19:08 -0500

>> The following paragraph in the elisp manual section "Miscellaneous System
>> Events" describes blinding events based on the now obsolete variables
>> `mouse-wheel-down-event', etc.:
>>
>>>      The ‘wheel-up’ and ‘wheel-down’ events are generated only on some
>>>      kinds of systems.  On other systems, other events like ‘mouse-4’
>>>      and ‘mouse-5’ are used instead.  Portable code should handle both
>>>      ‘wheel-up’ and ‘wheel-down’ events as well as the events specified
>>>      in the variables ‘mouse-wheel-up-event’ and
>>>      ‘mouse-wheel-down-event’, defined in ‘mwheel.el’.  Beware that for
>>>      historical reasons the ‘mouse-wheel-_up_-event’ is the variable
>>>      that holds an event that should be handled similarly to
>>>      ‘wheel-_down_’ and vice versa.
>
> Stefan, WDYT?

To the extent that there are still cases where mouse-4/5 is used,
I guess we can keep that almost unchanged, except to adjust the wording
to indicate what is more normal.  E.g.:

    The ‘wheel-up’ and ‘wheel-down’ events are generated on most systems.
    But in some unusual configurations, other events like ‘mouse-4’
    and ‘mouse-5’ may still be used instead.  Portable code that wants
    to accommodate those cases should handle both
    ‘wheel-up’ and ‘wheel-down’ events as well as the events specified
    in the variables ‘mouse-wheel-up-event’ and
    ‘mouse-wheel-down-event’, defined in ‘mwheel.el’.  Beware that for
    historical reasons the ‘mouse-wheel-_up_-event’ is the variable
    that holds an event that should be handled similarly to
    ‘wheel-_down_’ and vice versa.

?


        Stefan
This bug report was last modified 97 days ago.

Previous Next

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