config: install and distribute XI2proto.txt XIproto.txt

It will now be installed in $docdir in addition
to being distributed in the tarball.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

Add Red Had Copyright in the COPYING file.

Refer to XI2.h and XI2proto.h

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

Makefile.am: add ChangeLog and INSTALL on MAINTAINERCLEANFILES

Now that the INSTALL file is generated.
Allows running make maintainer-clean.

README: file created or updated #24206

Contains a set of URLs to freedesktop.org.

Makefile.am: ChangeLog not required: EXTRA_DIST or *CLEANFILES #24432

ChangeLog filename is known to Automake and requires no further
coding in the makefile.

Makefile.am: INSTALL file is missing or incorrect #24206

The standard GNU file on building/installing  tarball is copied
using the XORG_INSTALL macro contained in XORG_DEFAULT_OPTIONS
Add INSTALL target

configure.ac: deploy the new XORG_DEFAULT_OPTIONS #24242

This macro aggregate a number of existing macros that sets commmon
X.Org components configuration options. It shields the configuration file from
future changes.

configure.ac: AM_MAINTAINER_MODE missing #24238

This turns off maintainer mode build rules in tarballs.
Works in conjunction with autogen.sh --enable-maintainer-mode

.gitignore: use common defaults with custom section # 24239

Using common defaults will reduce errors and maintenance.
Only the very small or inexistent custom section need periodic maintenance
when the structure of the component changes. Do not edit defaults.

inputproto 2.0

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

Add XIproto.txt

This is the XI protocol specification document that used to be in xorg-docs.
It's now moved here, and if it ever sees updates, the updates will only
apply to here.

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

Require macros 1.3 for XORG_DEFAULT_OPTIONS

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

inputproto 1.9.99.902 (RC 2)

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

Device cursors are deleted once the window or the device disappear.

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

XIWarpPointer needs to take FP1616 for positions.

This was already in the spec but the protocol itself hadn't cought up with
it.

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

Replace four leftover INT16 with int16_t.

XIQueryPointer only works on master pointers and floating slaves.

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

XI2proto: XIChangeCursor request requires a master pointer.

State that the server will return BadDevice in this case.

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

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