XI2proto.txt: typo fix

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Remove eventtype field from xXIRawEvent.

With c455db2, raw events were split up into using multiple evtypes instead
of a sub event type. The eventtype field itself however has not been removed
and was unused by both the server and the library.

Field converted into a padding field, wire layout stays the same.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.901 (RC 1)

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Revert "XI2proto.txt: grabbing a slave does not detach it anymore."

Detaching a slave device during an explicit grab makes sense from a UI
perspective. It allows a client to get exclusive access to a device without
that device's events also feeding into the respective master device.

Thanks to Thomas Jaeger for his contribution.

This reverts commit d0b1e55b876a29a7c820ec12d7b9cb5e081e1944.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: document ClientPointer in more detail.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: don't put field names in quotes.

This was done inconsistently anyway so get rid of it alltogether.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: typo fixes and minor clarifications.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: sourceid on DeviceChanged is the device.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: passive grabs can take XIAll{Master}Devices.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: grabbing a slave does not detach it anymore.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIproto.txt: clarify that the ClientPointer is set, even if implicitly.

It is indistinguishable for the client whether the the server chooses a
ClientPointer or whether the CP was set through an XISetClientPointer
request. The only thing that matters is that a device was actually assigned
and will be used in the future.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: padding bytes must be zero.

Padding bytes zeroed out ensures that future versions of the XI2 protcol may
use these padding bytes with a defined state. The server should ignore
padding bytes depending on the client's version anyway but better safe than
sorry.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.h: Remove special doxygen tags.

The protocol header does not include enough documentation to make the use of
doxygen really worthwile. Special doxygen tags beyond the very simple use of
/** and /**< contribute too much to the noise and make it hard to actually
read the code itself.

While no extra tags are added now, a run of doxygen over XI2proto and XI.h
still produces an acceptable output.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: Add some XI1 vs. XI2 interoperability descriptions.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: update list of XI2 event types.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.15

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2: remove Keysym grabs, use Keycode grabs instead.

Keysym grabs are tricky to get right for applications that are more
complicated than demo applications. otoh, we know keycode grabs are working.
So let's go with keycode grabs for now and add keysym grabs later when we've
sorted out the details.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.14

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add the enter/leave detail defines, same as the core protocol ones.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Formatting fix, s/tabs/spaces/

Device{,Raw}Event: Add flags field.

Add a flags member to DeviceEvent and DeviceKeyEvent; the only currently
defined flag is KeyRepeat, indicating a repeat event (a la XKB detectable
autorepeat), which is only valid for key events.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2: Split up raw events into multiple event types.

Instead of a single XI_RawEvent type with subtypes to represent the actual
event, split up the event into XI_RawButtonPress, XI_RawButtonRelease, etc.
This way clients can select for specific raw events only instead of all of
them at once.

Note that raw events may be selected on master devices too, the server will
route them through master devices.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Fix XIMaskLen macro.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.13

Add effective group and modifiers to XIGroupInfo/XIModifierInfo.

Effective modifiers are easy to calculate but let's send them down the wire
nonetheless. Effective group is slightly more complicated since group
wrapping must be taken into account - sending it down the wire simplifies
clients.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIDeviceChangedEvents may occur on master devices too.

Prime example is a change in the number of buttons due to the availability
of a new slave device.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.12

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Use the term 'labels' to refer to button and axes labels.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Include valuator value in XIValuatorClasses

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Include button state in XIButtonClasses.

Without including the state in a button class, it is impossible to know the
state of a device until this device has pressed or released another button
(and thus sends an event).

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add a source field to the class information.

In some cases it is required to know the source device of a particular
device class. In the future we might also do lazy copying of classes,
meaning that for a given device, each class may come from a different
source. Hence the source id should be included for each class.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add note that bumping XI_LASTEVENT requires changes to the server.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Ensure XIAnyModifier is an unsigned int.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XISelectEventsReq should use win (not window), like all requests.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto: document XSetClientPointer behaviour on None window, etc.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.11

xXIHierarchyEvent should list num_info, not num_devices.

The structures following the request are referred to as "info", having a
name of "num_devices" is misleading as the number of info structs does not
always reflect the number of devices (e.g. if a device got removed).

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Rename XICreateMaster to XIAddMaster for consistency.

We use add/remove for slave devices, add/remove for the hierarchy changed
flags, so let's use add/remove to create a new device as well.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Update comment referring to an old naming scheme.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Document BadValue error for XIHierarchyEvents selection on devices.

These events may only be selected on the XIAllDevices fake device.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIQueryVersion may return a BadValue for major_version less than 2.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Move the XI2 index into versions[] over to XI2.h

Specify modifier interactions with attached slave devices on passive grabs.

inputproto 1.9.99.10

Mirror the core enter/focus modes and add the passive grab mode.

If an enter/focus grabs activates (or deactivates), send an extra set of
enter/focus in (or leave/focus out) events to the grabbing client with mode
XIPassiveGrabNotify.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add Enter/FocusIn passive grabs.

Same behaviour as button/keysym grabs but triggered on enter/leave and
focus in/out events.

XI2proto.txt: remove one more keycode mentioning, fix typo

Add XIGetSelectedEvents request and reply.

Counterpart to XISelectEvents, used to retrieve event masks from the server.

XI2proto.h: fix two comments referring to the old naming scheme.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.9

Document naming conventions for XI2proto.h.

XI2proto: define Window, Cursor, Atom and Time as uint32_t.

Since we're using stdint in the rest of the file, might as well ignore
CARD32 here.

XI2.h: remove XI2Mask, add XISetMask and friends.

XISetMask, XIClearMask, XIMaskIsSet serve to set, clear or check a bit in
the provided array.
XIMaskLen is a macro to get the minimum length of a mask for a given event
type.

They are expected to be common ways to deal with event masks, i.e. clients
will do:

unsigned char mask[XIMaskLen(XI_ButtonRelease)] = {0};
XISetMask(mask, XI_ButtonPress)
XISetMask(mask, XI_ButtonRelease)

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add XIAnyButton and XIAnyKeysym.

XIQueryPointer needs to include sensible button/modifier state.

This includes shuffling the xXIModifierInfo and xXIGroupInfo structs to the
common structs section.

Add an introduction to XI2proto.txt

XI2proto.txt: remove more mentioning of keycode grabs

Remove superfluous "Device" from protocol requests and events.

Anything with prefix XI is per-device anyway.

Add per-device flags to XIDeviceHierarchyEvents

Define Cursor as CARD32.

Reported-by: Benjamin Close <benjamin.close@clearchain.com>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.h: doxygen-ify

XI2proto.h: s/uint32_t/Time/ where appropriate

Prefix all XI2 constants with "XI" -> inputproto 1.99.9.8

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add XI2 property requests.

Basically the same as XI 1.5, save the 16 bit deviceids.

XI2: add passive grabs.

Most notably XI2 provides keysym grabs instead of keycode grabs.

XI2 spec: Add some more Grab/Ungrab/AllowEvents documentation.

Define the Cursor datasize correctly

On 64 bit machines, without Cursor defined Xlib would allocate 64 bits
rather than 32 to any structs using Cursor. This led to data not
correctly being available on the wire hence the Xserver would do strange
things. We hence define Cursor to what it should be and make sure
we undefine it after we've finished to users of XIproto.h aren't affected

Fix-by: Peter Hutterer <peter.hutterer@who-t.net>
Signed-off-by: Benjamin Close <Benjamin.Close@clearchain.com>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Fix typo in XI2proto.txt

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add XIAllowEvents.

Basically the same as the core protocol AllowEvents.

Change FP1616 into a single int32_t.

Add GrabDevice and UngrabDevice XI2 requests.

Revert "Add major/minor version as supported by client to GetExtensionVersionReq."

This reverts commit f6e41306f76de966884d4b72c5fb5e5d6d534ce4.
Sending the supported version hidden in another request is potentially
dangerous, so let's not do it.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: fix typo

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

We don't need to define KeyCode and Mask.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Undef Window, Time, etc. after usage again to avoid pollution.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Remove IsFloating - we don't need this in XI 1.x anymore.

Move XI_2_Major/Minor to XI2.h

Move AttachToMaster, Floating to XI2.h

Move CH_* constants to xi2

Remove XI2 requests from XIproto.h

All requests been moved to XI2proto.h. Only ExtendedGrabDevice is gone for
good.

Bump to 1.9.99.7

Add XISetDeviceFocus and XIGetDeviceFocus requests

Add focus events

Add buttons + modifier/group information to enter/leave events.

Define FP1616 as one int16_t, one uint16_t.

ValuatorInfo moved to FP3232

Add FP3232 typedef.

XI2: remove button state from the RawEvent.

A RawEvent is supposed to represent the state posted by the device. If a
client needs button state, then the client must keep track of it.

Split CH_ChangeAttachment into CH_AttachSlave and CH_DetachSlave

CH_ChangeAttachment is still there, but won't be for long.

Add XI2.h and XI2proto.h, and a few required defines to XI.h

Add XI2 protocol specification document.

Whitespace cleanups.

Yep. Slow day today.

Janitor: Correct make distcheck and dont distribute autogen.sh

Bump to 1.9.99.6.

PropertyNotify, move deviceid back to last byte.

This way, it can be type-cast to deviceKeyButtonPointer to extract the
deviceid, which is (aside from time) the only thing it has in common with
those anyway.

Remove window access protocol requests.

This is a bad idea. It didn't provide security and you can get the same
functionality as you did with normal event registration.

Undef Atom after we're done so we don't pollute users of XIproto.h

Make sure Atoms are defined as CARD32.

Bump to 1.9.99.5.

Remove default properties (XI_PROP_MODE, XI_PROP_ENABLED)

These should be defined by the server, not the protocol.