comparison readme.txt @ 2619:4d5467e57115

Update the readme with the important info about the button press/release changes.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Fri, 23 Jul 2021 21:02:36 +0000
parents dbb189c5d398
children 3245d79fa75f
comparison
equal deleted inserted replaced
2618:156ad91481eb 2619:4d5467e57115
54 APIs are not yet supported on OS/2. May implement our own system 54 APIs are not yet supported on OS/2. May implement our own system
55 if a popular notification system is not already in existance. 55 if a popular notification system is not already in existance.
56 Ports to iOS and Android are underway. 56 Ports to iOS and Android are underway.
57 57
58 Changes from version 3.1: 58 Changes from version 3.1:
59 Changed handling of button 3 press and release events.
60 WARNING: This could be a breaking change for apps handling
61 mouse button 3. Windows, Mac and GTK now pass button 3 as
62 the mask (value 4) instead of the button number (value 3).
63 OS/2 and the related motion event passed buttons as a mask.
64 In these value 3 is buttons 1 and 2 together. Button
65 press and release events are only for a single button...
66 so this would never happen allowing value 3 for button 3.
67 To allow the same code to work for button presses and motion
68 events, I am standardizing on using the masks for both.
69 If you use button 3 press/release, please audit code for 3.2.
59 Added initial support for GTK4. --with-gtk4 is now available. 70 Added initial support for GTK4. --with-gtk4 is now available.
60 GTK4 support is less complete than GTK3, a number of features 71 GTK4 support is less complete than GTK3, a number of features
61 of the GTK3 version are no longer possible in GTK4 like: 72 of the GTK3 version are no longer possible in GTK4 like:
62 Taskbar icon support, MDI, gravity and non-callback drawing. 73 Taskbar icon support, MDI, gravity and non-callback drawing.
74 Also at the time of this writing, WebKitGTK does not officially
75 support GTK4, so HTML is also unsupported.
63 Added initial support for Wayland on GTK3 and GTK4. 76 Added initial support for Wayland on GTK3 and GTK4.
64 Wayland is not in my opinion ready for prime time, many features, 77 Wayland is not in my opinion ready for prime time, many features,
65 possibly a half a dozen functions, dealing with coordinates, 78 possibly a half a dozen functions, dealing with coordinates,
66 mouse pointer grabbing and such are unable to function. 79 mouse pointer grabbing and such are unable to function.
67 I recommend sticking with X11 for now, but built with GTK3 or 80 I recommend sticking with X11 for now, but built with GTK3 or