diff options
| author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2021-11-11 08:58:34 +0000 |
|---|---|---|
| committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2021-11-11 08:58:34 +0000 |
| commit | f6fb485bbe93b602210392845f3b42d868170248 (patch) | |
| tree | e16f93669432217dae3c25a845809a3f8396f286 /lib/libXi/man | |
| parent | a225f11c0035c2e974687471cd3d2fc7cdfa0f14 (diff) | |
Update to libXi 1.8
Diffstat (limited to 'lib/libXi/man')
96 files changed, 917 insertions, 276 deletions
diff --git a/lib/libXi/man/Makefile.am b/lib/libXi/man/Makefile.am index b84ee5370..c2fbfdf7f 100644 --- a/lib/libXi/man/Makefile.am +++ b/lib/libXi/man/Makefile.am @@ -25,6 +25,7 @@ libmandir = $(LIB_MAN_DIR) # Source files for X Input v2 man pages XI2_txt = \ + XIAllowEvents.txt \ XIBarrierReleasePointer.txt \ XIChangeHierarchy.txt \ XIDefineCursor.txt \ diff --git a/lib/libXi/man/Makefile.in b/lib/libXi/man/Makefile.in index 271363740..e0b080221 100644 --- a/lib/libXi/man/Makefile.in +++ b/lib/libXi/man/Makefile.in @@ -288,6 +288,7 @@ pdfdir = @pdfdir@ prefix = @prefix@ program_transform_name = @program_transform_name@ psdir = @psdir@ +runstatedir = @runstatedir@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ @@ -300,6 +301,7 @@ libmandir = $(LIB_MAN_DIR) # Source files for X Input v2 man pages XI2_txt = \ + XIAllowEvents.txt \ XIBarrierReleasePointer.txt \ XIChangeHierarchy.txt \ XIDefineCursor.txt \ diff --git a/lib/libXi/man/XAllowDeviceEvents.man b/lib/libXi/man/XAllowDeviceEvents.man index c9acbcd37..c6378334c 100644 --- a/lib/libXi/man/XAllowDeviceEvents.man +++ b/lib/libXi/man/XAllowDeviceEvents.man @@ -2,12 +2,12 @@ .\" Title: xallowdeviceevents .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XALLOWDEVICEEVENTS" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XALLOWDEVICEEVENTS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,7 +52,7 @@ device .sp .nf event_mode - Specifies the event mode\&.You can pass AsyncThisDevice, + Specifies the event mode\&. You can pass AsyncThisDevice, SyncThisDevice, ReplayThisDevice, AsyncOtherDevices, SyncAll, or AsyncAll\&. .fi diff --git a/lib/libXi/man/XAllowDeviceEvents.txt b/lib/libXi/man/XAllowDeviceEvents.txt index 1120e3dde..5842c1218 100644 --- a/lib/libXi/man/XAllowDeviceEvents.txt +++ b/lib/libXi/man/XAllowDeviceEvents.txt @@ -23,7 +23,7 @@ SYNOPSIS allowed. event_mode - Specifies the event mode.You can pass AsyncThisDevice, + Specifies the event mode. You can pass AsyncThisDevice, SyncThisDevice, ReplayThisDevice, AsyncOtherDevices, SyncAll, or AsyncAll. diff --git a/lib/libXi/man/XChangeDeviceControl.man b/lib/libXi/man/XChangeDeviceControl.man index 948806386..2c385bcec 100644 --- a/lib/libXi/man/XChangeDeviceControl.man +++ b/lib/libXi/man/XChangeDeviceControl.man @@ -1 +1 @@ -.so XGetDeviceControl.libmansuffix +.so manlibmansuffix/XGetDeviceControl.libmansuffix diff --git a/lib/libXi/man/XChangeDeviceDontPropagateList.man b/lib/libXi/man/XChangeDeviceDontPropagateList.man index 2e7c201e3..43d959081 100644 --- a/lib/libXi/man/XChangeDeviceDontPropagateList.man +++ b/lib/libXi/man/XChangeDeviceDontPropagateList.man @@ -2,12 +2,12 @@ .\" Title: xchangedevicedontpropagatelist .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XCHANGEDEVICEDONTPRO" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XCHANGEDEVICEDONTPRO" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XChangeDeviceKeyMapping.man b/lib/libXi/man/XChangeDeviceKeyMapping.man index d78687126..4ff457c64 100644 --- a/lib/libXi/man/XChangeDeviceKeyMapping.man +++ b/lib/libXi/man/XChangeDeviceKeyMapping.man @@ -1 +1 @@ -.so XGetDeviceKeyMapping.libmansuffix +.so manlibmansuffix/XGetDeviceKeyMapping.libmansuffix diff --git a/lib/libXi/man/XChangeDeviceProperty.man b/lib/libXi/man/XChangeDeviceProperty.man index 156dd2c9e..20c3934e8 100644 --- a/lib/libXi/man/XChangeDeviceProperty.man +++ b/lib/libXi/man/XChangeDeviceProperty.man @@ -1 +1 @@ -.so XGetDeviceProperty.libmansuffix +.so manlibmansuffix/XGetDeviceProperty.libmansuffix diff --git a/lib/libXi/man/XChangeFeedbackControl.man b/lib/libXi/man/XChangeFeedbackControl.man index dc41a6014..1ea22c54e 100644 --- a/lib/libXi/man/XChangeFeedbackControl.man +++ b/lib/libXi/man/XChangeFeedbackControl.man @@ -1 +1 @@ -.so XGetFeedbackControl.libmansuffix +.so manlibmansuffix/XGetFeedbackControl.libmansuffix diff --git a/lib/libXi/man/XChangeKeyboardDevice.man b/lib/libXi/man/XChangeKeyboardDevice.man index 8c538ffa5..664294f9c 100644 --- a/lib/libXi/man/XChangeKeyboardDevice.man +++ b/lib/libXi/man/XChangeKeyboardDevice.man @@ -2,12 +2,12 @@ .\" Title: xchangekeyboarddevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XCHANGEKEYBOARDDEVIC" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XCHANGEKEYBOARDDEVIC" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XChangePointerDevice.man b/lib/libXi/man/XChangePointerDevice.man index d0887592a..66ffa8748 100644 --- a/lib/libXi/man/XChangePointerDevice.man +++ b/lib/libXi/man/XChangePointerDevice.man @@ -2,12 +2,12 @@ .\" Title: xchangepointerdevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XCHANGEPOINTERDEVICE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XCHANGEPOINTERDEVICE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XCloseDevice.man b/lib/libXi/man/XCloseDevice.man index 79846cc6d..ff0ce17ed 100644 --- a/lib/libXi/man/XCloseDevice.man +++ b/lib/libXi/man/XCloseDevice.man @@ -1 +1 @@ -.so XOpenDevice.libmansuffix +.so manlibmansuffix/XOpenDevice.libmansuffix diff --git a/lib/libXi/man/XDeleteDeviceProperty.man b/lib/libXi/man/XDeleteDeviceProperty.man index 156dd2c9e..20c3934e8 100644 --- a/lib/libXi/man/XDeleteDeviceProperty.man +++ b/lib/libXi/man/XDeleteDeviceProperty.man @@ -1 +1 @@ -.so XGetDeviceProperty.libmansuffix +.so manlibmansuffix/XGetDeviceProperty.libmansuffix diff --git a/lib/libXi/man/XDeviceBell.man b/lib/libXi/man/XDeviceBell.man index 1b1c9ef77..89616fbfb 100644 --- a/lib/libXi/man/XDeviceBell.man +++ b/lib/libXi/man/XDeviceBell.man @@ -2,12 +2,12 @@ .\" Title: xdevicebell .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XDEVICEBELL" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XDEVICEBELL" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XDeviceTimeCoord.man b/lib/libXi/man/XDeviceTimeCoord.man index 7d0b7dc6d..f9f3afd54 100644 --- a/lib/libXi/man/XDeviceTimeCoord.man +++ b/lib/libXi/man/XDeviceTimeCoord.man @@ -1 +1 @@ -.so XGetDeviceMotionEvents.libmansuffix +.so manlibmansuffix/XGetDeviceMotionEvents.libmansuffix diff --git a/lib/libXi/man/XFreeDeviceList.man b/lib/libXi/man/XFreeDeviceList.man index 1a79ebf2d..9dd0be8ff 100644 --- a/lib/libXi/man/XFreeDeviceList.man +++ b/lib/libXi/man/XFreeDeviceList.man @@ -1 +1 @@ -.so XListInputDevices.libmansuffix +.so manlibmansuffix/XListInputDevices.libmansuffix diff --git a/lib/libXi/man/XGetDeviceButtonMapping.man b/lib/libXi/man/XGetDeviceButtonMapping.man index 01e08448a..44b0ff9f1 100644 --- a/lib/libXi/man/XGetDeviceButtonMapping.man +++ b/lib/libXi/man/XGetDeviceButtonMapping.man @@ -1 +1 @@ -.so XSetDeviceButtonMapping.libmansuffix +.so manlibmansuffix/XSetDeviceButtonMapping.libmansuffix diff --git a/lib/libXi/man/XGetDeviceControl.man b/lib/libXi/man/XGetDeviceControl.man index 8de91e41b..54414210c 100644 --- a/lib/libXi/man/XGetDeviceControl.man +++ b/lib/libXi/man/XGetDeviceControl.man @@ -2,12 +2,12 @@ .\" Title: xgetdevicecontrol .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETDEVICECONTROL" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETDEVICECONTROL" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XGetDeviceDontPropagateList.man b/lib/libXi/man/XGetDeviceDontPropagateList.man index a691a8b33..65257dae4 100644 --- a/lib/libXi/man/XGetDeviceDontPropagateList.man +++ b/lib/libXi/man/XGetDeviceDontPropagateList.man @@ -1 +1 @@ -.so XChangeDeviceDontPropagateList.libmansuffix +.so manlibmansuffix/XChangeDeviceDontPropagateList.libmansuffix diff --git a/lib/libXi/man/XGetDeviceFocus.man b/lib/libXi/man/XGetDeviceFocus.man index 54b7e130a..9ce679e36 100644 --- a/lib/libXi/man/XGetDeviceFocus.man +++ b/lib/libXi/man/XGetDeviceFocus.man @@ -1 +1 @@ -.so XSetDeviceFocus.libmansuffix +.so manlibmansuffix/XSetDeviceFocus.libmansuffix diff --git a/lib/libXi/man/XGetDeviceKeyMapping.man b/lib/libXi/man/XGetDeviceKeyMapping.man index 8df368aba..822c17722 100644 --- a/lib/libXi/man/XGetDeviceKeyMapping.man +++ b/lib/libXi/man/XGetDeviceKeyMapping.man @@ -2,12 +2,12 @@ .\" Title: xgetdevicekeymapping .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETDEVICEKEYMAPPING" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETDEVICEKEYMAPPING" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -70,7 +70,7 @@ keysyms_per_keycode .nf keysyms_per_keycode_return Specifies the address of a variable into which the - number of KeySyms per KeyCodewill be returned\&. + number of KeySyms per KeyCode will be returned\&. .fi .sp .nf @@ -252,7 +252,7 @@ the client to be large enough to hold all desired symbols\&. A special KeySym value of NoSymbol should be used to fill in unused elements for individual KeyCodes\&. It is legal for NoSymbol to appear in nontrailing positions of the effective -list for a KeyCode\&.XChangeDeviceKeyMapping generates a +list for a KeyCode\&. XChangeDeviceKeyMapping generates a DeviceMappingNotify event that is sent to all clients that have selected that type of event\&. .fi diff --git a/lib/libXi/man/XGetDeviceKeyMapping.txt b/lib/libXi/man/XGetDeviceKeyMapping.txt index 0c684126f..dfa59fc82 100644 --- a/lib/libXi/man/XGetDeviceKeyMapping.txt +++ b/lib/libXi/man/XGetDeviceKeyMapping.txt @@ -36,7 +36,7 @@ SYNOPSIS keysyms_per_keycode_return Specifies the address of a variable into which the - number of KeySyms per KeyCodewill be returned. + number of KeySyms per KeyCode will be returned. keysyms Specifies the address of an array of KeySyms. @@ -101,7 +101,7 @@ DESCRIPTION special KeySym value of NoSymbol should be used to fill in unused elements for individual KeyCodes. It is legal for NoSymbol to appear in nontrailing positions of the effective - list for a KeyCode.XChangeDeviceKeyMapping generates a + list for a KeyCode. XChangeDeviceKeyMapping generates a DeviceMappingNotify event that is sent to all clients that have selected that type of event. diff --git a/lib/libXi/man/XGetDeviceModifierMapping.man b/lib/libXi/man/XGetDeviceModifierMapping.man index 51bd2dac7..b678b6d56 100644 --- a/lib/libXi/man/XGetDeviceModifierMapping.man +++ b/lib/libXi/man/XGetDeviceModifierMapping.man @@ -2,12 +2,12 @@ .\" Title: xgetdevicemodifiermapping .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETDEVICEMODIFIERMA" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETDEVICEMODIFIERMA" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XGetDeviceMotionEvents.man b/lib/libXi/man/XGetDeviceMotionEvents.man index c845fc61b..c60da78bc 100644 --- a/lib/libXi/man/XGetDeviceMotionEvents.man +++ b/lib/libXi/man/XGetDeviceMotionEvents.man @@ -2,12 +2,12 @@ .\" Title: xgetdevicemotionevents .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETDEVICEMOTIONEVEN" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETDEVICEMOTIONEVEN" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XGetDeviceProperty.man b/lib/libXi/man/XGetDeviceProperty.man index f5bfebd1d..72140fab8 100644 --- a/lib/libXi/man/XGetDeviceProperty.man +++ b/lib/libXi/man/XGetDeviceProperty.man @@ -2,12 +2,12 @@ .\" Title: xgetdeviceproperty .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETDEVICEPROPERTY" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETDEVICEPROPERTY" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XGetExtensionVersion.man b/lib/libXi/man/XGetExtensionVersion.man index 4344a641f..860c2b72a 100644 --- a/lib/libXi/man/XGetExtensionVersion.man +++ b/lib/libXi/man/XGetExtensionVersion.man @@ -2,12 +2,12 @@ .\" Title: xgetextensionversion .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETEXTENSIONVERSION" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETEXTENSIONVERSION" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +48,7 @@ display .nf name Specifies the extension to be queried\&. The input - extension name is definedin the header file XI\&.h\&. + extension name is defined in the header file XI\&.h\&. .fi .SH "DESCRIPTION" .sp diff --git a/lib/libXi/man/XGetExtensionVersion.txt b/lib/libXi/man/XGetExtensionVersion.txt index c7d45f40a..53426fd32 100644 --- a/lib/libXi/man/XGetExtensionVersion.txt +++ b/lib/libXi/man/XGetExtensionVersion.txt @@ -19,7 +19,7 @@ SYNOPSIS name Specifies the extension to be queried. The input - extension name is definedin the header file XI.h. + extension name is defined in the header file XI.h. DESCRIPTION ----------- diff --git a/lib/libXi/man/XGetFeedbackControl.man b/lib/libXi/man/XGetFeedbackControl.man index c968a12bb..36e8c0a57 100644 --- a/lib/libXi/man/XGetFeedbackControl.man +++ b/lib/libXi/man/XGetFeedbackControl.man @@ -2,12 +2,12 @@ .\" Title: xgetfeedbackcontrol .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGETFEEDBACKCONTROL" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGETFEEDBACKCONTROL" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,19 +62,19 @@ device .nf num_feedbacks Specifies an address into which the number of feedbacks - supported by thedevice is to be returned\&. + supported by the device is to be returned\&. .fi .sp .nf mask Specifies a mask specific to each type of feedback that - describes howthe feedback is to be modified\&. + describes how the feedback is to be modified\&. .fi .sp .nf control Specifies the address of an XFeedbackControl structure - that containsthe new values for the feedback\&. + that contains the new values for the feedback\&. .fi .SH "DESCRIPTION" .sp diff --git a/lib/libXi/man/XGetFeedbackControl.txt b/lib/libXi/man/XGetFeedbackControl.txt index 820ff9644..c4ef32253 100644 --- a/lib/libXi/man/XGetFeedbackControl.txt +++ b/lib/libXi/man/XGetFeedbackControl.txt @@ -30,15 +30,15 @@ SYNOPSIS num_feedbacks Specifies an address into which the number of feedbacks - supported by thedevice is to be returned. + supported by the device is to be returned. mask Specifies a mask specific to each type of feedback that - describes howthe feedback is to be modified. + describes how the feedback is to be modified. control Specifies the address of an XFeedbackControl structure - that containsthe new values for the feedback. + that contains the new values for the feedback. DESCRIPTION ----------- diff --git a/lib/libXi/man/XGetSelectedExtensionEvents.man b/lib/libXi/man/XGetSelectedExtensionEvents.man index ea49cf1af..4adbaa61e 100644 --- a/lib/libXi/man/XGetSelectedExtensionEvents.man +++ b/lib/libXi/man/XGetSelectedExtensionEvents.man @@ -1 +1 @@ -.so XSelectExtensionEvent.libmansuffix +.so manlibmansuffix/XSelectExtensionEvent.libmansuffix diff --git a/lib/libXi/man/XGrabDevice.man b/lib/libXi/man/XGrabDevice.man index 49703f1e8..9cc7e5da2 100644 --- a/lib/libXi/man/XGrabDevice.man +++ b/lib/libXi/man/XGrabDevice.man @@ -2,12 +2,12 @@ .\" Title: xgrabdevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGRABDEVICE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGRABDEVICE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,7 +100,7 @@ this_device_mode .nf other_devices_mode Specifies further processing of events from other - devices\&.You can pass GrabModeSync or GrabModeAsync\&. + devices\&. You can pass GrabModeSync or GrabModeAsync\&. .fi .sp .nf @@ -117,7 +117,7 @@ time The XGrabDevice request actively grabs control of the device and generates DeviceFocusIn and DeviceFocusOut events\&. Further device events are reported only to the grabbing -client\&.XGrabDevice overrides any active device grab by this +client\&. XGrabDevice overrides any active device grab by this client\&. event_list is a pointer to a list of event classes\&. This list indicates which events the client wishes to receive while the grab is active\&. If owner_events is False, all @@ -218,7 +218,7 @@ BadWindow errors\&. The XUngrabDevice request releases the device and any queued events if this client has it actively grabbed from either XGrabDevice or XGrabDeviceKey\&. If other devices are frozen by -the grab, XUngrabDevice thaws them\&.XUngrabDevice does not +the grab, XUngrabDevice thaws them\&. XUngrabDevice does not release the device and any queued events if the specified time is earlier than the last\-device\-grab time or is later than the current X server time\&. It also generates DeviceFocusIn and diff --git a/lib/libXi/man/XGrabDevice.txt b/lib/libXi/man/XGrabDevice.txt index cfe215f2e..e1f74c1f4 100644 --- a/lib/libXi/man/XGrabDevice.txt +++ b/lib/libXi/man/XGrabDevice.txt @@ -58,7 +58,7 @@ SYNOPSIS other_devices_mode Specifies further processing of events from other - devices.You can pass GrabModeSync or GrabModeAsync. + devices. You can pass GrabModeSync or GrabModeAsync. time Specifies the time. You can pass either a timestamp or @@ -70,7 +70,7 @@ DESCRIPTION The XGrabDevice request actively grabs control of the device and generates DeviceFocusIn and DeviceFocusOut events. Further device events are reported only to the grabbing - client.XGrabDevice overrides any active device grab by this + client. XGrabDevice overrides any active device grab by this client. event_list is a pointer to a list of event classes. This list indicates which events the client wishes to receive while the grab is active. If owner_events is False, all @@ -123,7 +123,7 @@ DESCRIPTION The XUngrabDevice request releases the device and any queued events if this client has it actively grabbed from either XGrabDevice or XGrabDeviceKey. If other devices are frozen by - the grab, XUngrabDevice thaws them.XUngrabDevice does not + the grab, XUngrabDevice thaws them. XUngrabDevice does not release the device and any queued events if the specified time is earlier than the last-device-grab time or is later than the current X server time. It also generates DeviceFocusIn and diff --git a/lib/libXi/man/XGrabDeviceButton.man b/lib/libXi/man/XGrabDeviceButton.man index 4ecdb0092..75e2eefda 100644 --- a/lib/libXi/man/XGrabDeviceButton.man +++ b/lib/libXi/man/XGrabDeviceButton.man @@ -2,12 +2,12 @@ .\" Title: xgrabdevicebutton .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGRABDEVICEBUTTON" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGRABDEVICEBUTTON" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -76,10 +76,10 @@ button .sp .nf modifiers - Specifies the set of keymasks or AnyModifier\&.The mask is + Specifies the set of keymasks or AnyModifier\&. The mask is the bitwise inclusive OR of the valid keymask bits\&. - Valid bits are: Shiftmask, LockMask, ControlMask, - Mod1Mask, Mod2Mask,Mod3Mask, Mod4Mask, Mod5Mask\&. + Valid bits are: ShiftMask, LockMask, ControlMask, + Mod1Mask, Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask\&. .fi .sp .nf @@ -223,14 +223,23 @@ combination\&. XGrabDeviceButton has no effect on an active grab\&. .\} .nf XGrabDeviceButton can generate BadClass, BadDevice, BadMatch, -BadValue, and BadWindow errors\&.\&.P The XUngrabDeviceButton -request releases the passive grab for a button/modifier -combination on the specified window if it was grabbed by this -client\&. A modifier of AnyModifier is equivalent to issuing the -ungrab request for all possible modifier combinations, -including the combination of no modifiers\&. A button of -AnyButton is equivalent to issuing the request for all possible -buttons\&. XUngrabDeviceButton has no effect on an active grab\&. +BadValue, and BadWindow errors\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +The XUngrabDeviceButton request releases the passive grab for a +button/modifier combination on the specified window if it was +grabbed by this client\&. A modifier of AnyModifier is equivalent to +issuing the ungrab request for all possible modifier combinations, +including the combination of no modifiers\&. A button of AnyButton is +equivalent to issuing the request for all possible buttons\&. +XUngrabDeviceButton has no effect on an active grab\&. .fi .if n \{\ .RE diff --git a/lib/libXi/man/XGrabDeviceButton.txt b/lib/libXi/man/XGrabDeviceButton.txt index ab64782f3..dcdc7b200 100644 --- a/lib/libXi/man/XGrabDeviceButton.txt +++ b/lib/libXi/man/XGrabDeviceButton.txt @@ -42,10 +42,10 @@ SYNOPSIS released or AnyButton. modifiers - Specifies the set of keymasks or AnyModifier.The mask is + Specifies the set of keymasks or AnyModifier. The mask is the bitwise inclusive OR of the valid keymask bits. - Valid bits are: Shiftmask, LockMask, ControlMask, - Mod1Mask, Mod2Mask,Mod3Mask, Mod4Mask, Mod5Mask. + Valid bits are: ShiftMask, LockMask, ControlMask, + Mod1Mask, Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask. modifier_device specifies the device whose modifiers are to be used. If @@ -124,14 +124,15 @@ DESCRIPTION combination. XGrabDeviceButton has no effect on an active grab. XGrabDeviceButton can generate BadClass, BadDevice, BadMatch, - BadValue, and BadWindow errors..P The XUngrabDeviceButton - request releases the passive grab for a button/modifier - combination on the specified window if it was grabbed by this - client. A modifier of AnyModifier is equivalent to issuing the - ungrab request for all possible modifier combinations, - including the combination of no modifiers. A button of - AnyButton is equivalent to issuing the request for all possible - buttons. XUngrabDeviceButton has no effect on an active grab. + BadValue, and BadWindow errors. + + The XUngrabDeviceButton request releases the passive grab for a + button/modifier combination on the specified window if it was + grabbed by this client. A modifier of AnyModifier is equivalent to + issuing the ungrab request for all possible modifier combinations, + including the combination of no modifiers. A button of AnyButton is + equivalent to issuing the request for all possible buttons. + XUngrabDeviceButton has no effect on an active grab. A modifier_device of NULL indicates that the X keyboard should be used as the modifier_device. diff --git a/lib/libXi/man/XGrabDeviceKey.man b/lib/libXi/man/XGrabDeviceKey.man index 3bc7e357b..988e3f38f 100644 --- a/lib/libXi/man/XGrabDeviceKey.man +++ b/lib/libXi/man/XGrabDeviceKey.man @@ -2,12 +2,12 @@ .\" Title: xgrabdevicekey .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XGRABDEVICEKEY" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XGRABDEVICEKEY" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -76,10 +76,10 @@ Key .sp .nf modifiers - Specifies the set of keymasks or AnyModifier\&.The mask is - the bitwise inclusive OR of the valid keymask bits\&.Valid + Specifies the set of keymasks or AnyModifier\&. The mask is + the bitwise inclusive OR of the valid keymask bits\&. Valid bits are: ShiftMask, LockMask, ControlMask, Mod1Mask, - Mod2Mask,Mod3Mask, Mod4Mask, Mod5Mask\&. + Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask\&. .fi .sp .nf @@ -122,7 +122,7 @@ this_device_mode .nf other_devices_mode Specifies further processing of events from other - devices\&. You can pass GrabModeSyncor GrabModeAsync\&. + devices\&. You can pass GrabModeSync or GrabModeAsync\&. .fi .SH "DESCRIPTION" .sp @@ -225,7 +225,7 @@ the same Key/modifier combination on the same window, a BadAccess error results\&. When using AnyModifier or AnyKey, the request fails completely, and a BadAccess error results (no grabs are established) if there is a conflicting grab for any -combination\&.XGrabDeviceKey has no effect on an active grab\&. +combination\&. XGrabDeviceKey has no effect on an active grab\&. .fi .if n \{\ .RE @@ -253,7 +253,7 @@ grabbed by this client\&. A modifier of AnyModifier is equivalent to issuing the ungrab request for all possible modifier combinations, including the combination of no modifiers\&. A Key of AnyKey is equivalent to issuing the request for all possible -Keys\&.XUngrabDeviceKey has no effect on an active grab\&. +Keys\&. XUngrabDeviceKey has no effect on an active grab\&. .fi .if n \{\ .RE diff --git a/lib/libXi/man/XGrabDeviceKey.txt b/lib/libXi/man/XGrabDeviceKey.txt index ff86375b5..988b377c5 100644 --- a/lib/libXi/man/XGrabDeviceKey.txt +++ b/lib/libXi/man/XGrabDeviceKey.txt @@ -42,10 +42,10 @@ SYNOPSIS or AnyKey. modifiers - Specifies the set of keymasks or AnyModifier.The mask is - the bitwise inclusive OR of the valid keymask bits.Valid + Specifies the set of keymasks or AnyModifier. The mask is + the bitwise inclusive OR of the valid keymask bits. Valid bits are: ShiftMask, LockMask, ControlMask, Mod1Mask, - Mod2Mask,Mod3Mask, Mod4Mask, Mod5Mask. + Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask. modifier_device Specifies the device whose modifiers are to be used. If @@ -74,7 +74,7 @@ SYNOPSIS other_devices_mode Specifies further processing of events from other - devices. You can pass GrabModeSyncor GrabModeAsync. + devices. You can pass GrabModeSync or GrabModeAsync. DESCRIPTION ----------- @@ -126,7 +126,7 @@ DESCRIPTION BadAccess error results. When using AnyModifier or AnyKey, the request fails completely, and a BadAccess error results (no grabs are established) if there is a conflicting grab for any - combination.XGrabDeviceKey has no effect on an active grab. + combination. XGrabDeviceKey has no effect on an active grab. XGrabDeviceKey can generate BadAccess, BadClass, BadDevice, BadMatch, BadValue, and BadWindow errors. It returns Success on @@ -138,7 +138,7 @@ DESCRIPTION to issuing the ungrab request for all possible modifier combinations, including the combination of no modifiers. A Key of AnyKey is equivalent to issuing the request for all possible - Keys.XUngrabDeviceKey has no effect on an active grab. + Keys. XUngrabDeviceKey has no effect on an active grab. If a modifier_device of NULL is specified, the X keyboard will be used as the modifier_device. diff --git a/lib/libXi/man/XIAllowEvents.man b/lib/libXi/man/XIAllowEvents.man new file mode 100644 index 000000000..32d45d222 --- /dev/null +++ b/lib/libXi/man/XIAllowEvents.man @@ -0,0 +1,321 @@ +'\" t +.\" Title: xiallowevents +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> +.\" Date: 09/15/2021 +.\" Manual: \ \& +.\" Source: \ \& +.\" Language: English +.\" +.TH "XIALLOWEVENTS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +XIAllowEvents \- Release queued events +.SH "SYNOPSIS" +.sp +.nf +#include <X11/extensions/XInput2\&.h> +.fi +.sp +.nf +Status XIAllowEvents( Display *display, + int deviceid, + int event_mode, + Time time ); +.fi +.sp +.nf +Status XIAllowTouchEvents( Display *dpy, + int deviceid, + unsigned int touchid, + Window grab_window, + int event_mode ); +.fi +.sp +.nf +display + Specifies the connection to the X server\&. +.fi +.sp +.nf +device + Specifies the device that is to be grabbed or released +.fi +.sp +.nf +event_mode + Specifies whether a device is to be thawed and events are to be + replayed, or how to handle a grabbed touch sequence\&. +.fi +.sp +.nf +time + A valid server time or CurrentTime\&. +.fi +.sp +.nf +touchid + The ID of the touch sequence to accept or reject\&. The value is ignored + for event modes other than AcceptTouch and RejectTouch\&. +.fi +.sp +.nf +grab_window + The window on which to accept or reject a touch sequence grab\&. The value + is ignored for event modes other than AcceptTouch and RejectTouch\&. +.fi +.SH "DESCRIPTION" +.sp +.if n \{\ +.RS 4 +.\} +.nf +The XIAllowEvents request releases some queued events if the client +has caused a device to freeze\&. It also is used to handle touch grab and +ownership processing\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +The function has no effect if the specified time is earlier than the last\-grab +time of the most recent active grab for the client, or if the specified time is +later than the current X server time\&. The time parameter must be CurrentTime for +requests with event modes of XIAcceptTouch and XIRejectTouch\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +The following describes the processing that occurs depending on what constant +you pass to the event_mode argument: +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIAsyncDevice: + If the specified device is frozen by the client, event processing for that + device continues as usual\&. If the device is frozen multiple times by the + client on behalf of multiple separate grabs, XIAsyncDevice thaws for + all\&. XIAsyncDevice has no effect if the specified device is not frozen + by the client, but the device need not be grabbed by the client\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XISyncDevice: + If the specified device is frozen and actively grabbed by the client, + event processing for that device continues normally until the next + button press or release, or key press or release, or a gesture begin or end + event (depending on the grab) is reported to the client\&. + At this time, the specified device again appears to freeze\&. + However, if the reported event causes the grab to be released, the + specified device does not freeze\&. + XISyncDevice has no effect if the specified device is not frozen by the + client or is not grabbed by the client\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIReplayDevice: + If the specified device is actively grabbed by the client and is frozen + as the result of an event having been sent to the client (either from + the activation of a XIGrabButton or from a previous XIAllowEvents with + mode SyncDevice, but not from a Grab), the grab is released and + that event is completely reprocessed\&. This time, however, the request + ignores any passive grabs at or above (towards the root) the + grab window of the grab just released\&. + The request has no effect if the specified device is not grabbed by + the client or if it is not frozen as the result of an event\&. + In case of gesture begin event being replayed, the original grabbing + client will receive a XI_GesturePinchEnd or XI_GestureSwipeEnd event\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIAsyncPairedDevice: + If the paired master device is frozen by the client, event processing + for it continues as usual\&. If the paired device is frozen multiple + times by the client on behalf of multiple separate grabs, + XIAsyncPairedDevice thaws for all\&. + XIAsyncPairedDevice has no effect if the device is not frozen by the + client, but those devices need not be grabbed by the client\&. + XIAsyncPairedDevice has no effect if deviceid specifies a slave device\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XISyncPair: + If both the device and the paired master device are frozen by the + client, event processing (for both devices) continues normally until + the next XI_ButtonPress, XI_ButtonRelease, XI_KeyPress, or XI_KeyRelease + event is reported to the client for a grabbed device (button event for + a pointer, key event for a keyboard), at which time the devices again + appear to freeze\&. However, if the reported event causes the grab to be + released, then the devices do not freeze (but if the other device is + still grabbed, then a subsequent event for it will still cause both + devices to freeze)\&. + XISyncPair has no effect unless both the device and the paired master + device are frozen by the client\&. If the device or paired master device + is frozen twice by the client on behalf of two separate grabs, + XISyncPair thaws for both (but a subsequent freeze for XISyncPair will + only freeze each device once)\&. + XISyncPair has no effect if deviceid specifies a slave device\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIAsyncPair: + If the device and the paired master device are frozen by the client, + event processing for both devices continues normally\&. If a device is + frozen twice by the client on behalf of two separate grabs, AsyncBoth + thaws for both\&. XIAsyncPair has no effect unless both the device and the + paired master device frozen by the client\&. + XIAsyncPair has no effect if deviceid specifies a slave device\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIAcceptTouch: + The client is deemed to have taken control of the touch sequence once it + owns the sequence\&. TouchEnd events will be sent to all clients listening + to the touch sequence that have either grabbed the touch sequence on a + child window of the grab_window or have received events for the touch + sequence through event selection\&. These clients will no longer receive + any TouchUpdate events\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIRejectTouch: + The client is no longer interested in the touch sequence, and will + receive a XI_TouchEnd event\&. If the client is the current owner of the + sequence, ownership will be passed on to the next listener\&. +.fi +.if n \{\ +.RE +.\} +.SH "DIAGNOSTICS" +.sp +.if n \{\ +.RS 4 +.\} +.nf +BadDevice + An invalid deviceid was specified\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +BadAccess + This error may occur if event_mode is XIAcceptTouch and this client + is not the current or potential owner of the specified touch ID\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +BadValue + This error may occur if event_mode is XIAcceptTouch and touch ID is invalid\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +BadWindow + A value for a grab_window argument does not name a defined + Window\&. +.fi +.if n \{\ +.RE +.\} +.SH "SEE ALSO" +.sp +.if n \{\ +.RS 4 +.\} +.nf +XIGrabButton(libmansuffix) +.fi +.if n \{\ +.RE +.\} diff --git a/lib/libXi/man/XIAllowEvents.txt b/lib/libXi/man/XIAllowEvents.txt new file mode 100644 index 000000000..f00b39b01 --- /dev/null +++ b/lib/libXi/man/XIAllowEvents.txt @@ -0,0 +1,159 @@ +XIALLOWEVENTS(libmansuffix) +=========================== + +NAME +---- + + XIAllowEvents - Release queued events + +SYNOPSIS +-------- + + #include <X11/extensions/XInput2.h> + + Status XIAllowEvents( Display *display, + int deviceid, + int event_mode, + Time time ); + + Status XIAllowTouchEvents( Display *dpy, + int deviceid, + unsigned int touchid, + Window grab_window, + int event_mode ); + + display + Specifies the connection to the X server. + + device + Specifies the device that is to be grabbed or released + + event_mode + Specifies whether a device is to be thawed and events are to be + replayed, or how to handle a grabbed touch sequence. + + time + A valid server time or CurrentTime. + + touchid + The ID of the touch sequence to accept or reject. The value is ignored + for event modes other than AcceptTouch and RejectTouch. + + grab_window + The window on which to accept or reject a touch sequence grab. The value + is ignored for event modes other than AcceptTouch and RejectTouch. + +DESCRIPTION +----------- + + The XIAllowEvents request releases some queued events if the client + has caused a device to freeze. It also is used to handle touch grab and + ownership processing. + + The function has no effect if the specified time is earlier than the last-grab + time of the most recent active grab for the client, or if the specified time is + later than the current X server time. The time parameter must be CurrentTime for + requests with event modes of XIAcceptTouch and XIRejectTouch. + + The following describes the processing that occurs depending on what constant + you pass to the event_mode argument: + + XIAsyncDevice: + If the specified device is frozen by the client, event processing for that + device continues as usual. If the device is frozen multiple times by the + client on behalf of multiple separate grabs, XIAsyncDevice thaws for + all. XIAsyncDevice has no effect if the specified device is not frozen + by the client, but the device need not be grabbed by the client. + + XISyncDevice: + If the specified device is frozen and actively grabbed by the client, + event processing for that device continues normally until the next + button press or release, or key press or release, or a gesture begin or end + event (depending on the grab) is reported to the client. + At this time, the specified device again appears to freeze. + However, if the reported event causes the grab to be released, the + specified device does not freeze. + XISyncDevice has no effect if the specified device is not frozen by the + client or is not grabbed by the client. + + XIReplayDevice: + If the specified device is actively grabbed by the client and is frozen + as the result of an event having been sent to the client (either from + the activation of a XIGrabButton or from a previous XIAllowEvents with + mode SyncDevice, but not from a Grab), the grab is released and + that event is completely reprocessed. This time, however, the request + ignores any passive grabs at or above (towards the root) the + grab window of the grab just released. + The request has no effect if the specified device is not grabbed by + the client or if it is not frozen as the result of an event. + In case of gesture begin event being replayed, the original grabbing + client will receive a XI_GesturePinchEnd or XI_GestureSwipeEnd event. + + XIAsyncPairedDevice: + If the paired master device is frozen by the client, event processing + for it continues as usual. If the paired device is frozen multiple + times by the client on behalf of multiple separate grabs, + XIAsyncPairedDevice thaws for all. + XIAsyncPairedDevice has no effect if the device is not frozen by the + client, but those devices need not be grabbed by the client. + XIAsyncPairedDevice has no effect if deviceid specifies a slave device. + + XISyncPair: + If both the device and the paired master device are frozen by the + client, event processing (for both devices) continues normally until + the next XI_ButtonPress, XI_ButtonRelease, XI_KeyPress, or XI_KeyRelease + event is reported to the client for a grabbed device (button event for + a pointer, key event for a keyboard), at which time the devices again + appear to freeze. However, if the reported event causes the grab to be + released, then the devices do not freeze (but if the other device is + still grabbed, then a subsequent event for it will still cause both + devices to freeze). + XISyncPair has no effect unless both the device and the paired master + device are frozen by the client. If the device or paired master device + is frozen twice by the client on behalf of two separate grabs, + XISyncPair thaws for both (but a subsequent freeze for XISyncPair will + only freeze each device once). + XISyncPair has no effect if deviceid specifies a slave device. + + XIAsyncPair: + If the device and the paired master device are frozen by the client, + event processing for both devices continues normally. If a device is + frozen twice by the client on behalf of two separate grabs, AsyncBoth + thaws for both. XIAsyncPair has no effect unless both the device and the + paired master device frozen by the client. + XIAsyncPair has no effect if deviceid specifies a slave device. + + XIAcceptTouch: + The client is deemed to have taken control of the touch sequence once it + owns the sequence. TouchEnd events will be sent to all clients listening + to the touch sequence that have either grabbed the touch sequence on a + child window of the grab_window or have received events for the touch + sequence through event selection. These clients will no longer receive + any TouchUpdate events. + + XIRejectTouch: + The client is no longer interested in the touch sequence, and will + receive a XI_TouchEnd event. If the client is the current owner of the + sequence, ownership will be passed on to the next listener. + +DIAGNOSTICS +----------- + + BadDevice + An invalid deviceid was specified. + + BadAccess + This error may occur if event_mode is XIAcceptTouch and this client + is not the current or potential owner of the specified touch ID. + + BadValue + This error may occur if event_mode is XIAcceptTouch and touch ID is invalid. + + BadWindow + A value for a grab_window argument does not name a defined + Window. + +SEE ALSO +-------- + + XIGrabButton(libmansuffix) diff --git a/lib/libXi/man/XIBarrierReleasePointer.man b/lib/libXi/man/XIBarrierReleasePointer.man index cf971ff05..d3f8ffbfd 100644 --- a/lib/libXi/man/XIBarrierReleasePointer.man +++ b/lib/libXi/man/XIBarrierReleasePointer.man @@ -2,12 +2,12 @@ .\" Title: xibarrierreleasepointer .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIBARRIERRELEASEPOIN" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIBARRIERRELEASEPOIN" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XIBarrierReleasePointers.man b/lib/libXi/man/XIBarrierReleasePointers.man index d7c667242..78bb999ed 100644 --- a/lib/libXi/man/XIBarrierReleasePointers.man +++ b/lib/libXi/man/XIBarrierReleasePointers.man @@ -1 +1 @@ -.so XIBarrierReleasePointer.libmansuffix +.so manlibmansuffix/XIBarrierReleasePointer.libmansuffix diff --git a/lib/libXi/man/XIChangeHierarchy.man b/lib/libXi/man/XIChangeHierarchy.man index 45716851e..dbc9bcf4b 100644 --- a/lib/libXi/man/XIChangeHierarchy.man +++ b/lib/libXi/man/XIChangeHierarchy.man @@ -2,12 +2,12 @@ .\" Title: xichangehierarchy .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XICHANGEHIERARCHY" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XICHANGEHIERARCHY" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -175,7 +175,7 @@ typedef struct { .\} .nf XIAddMasterInfo creates a new master pointer and a new -master keyboard labelled "name pointer" and "name keyboard" +master keyboard labeled "name pointer" and "name keyboard" respectively\&. If sendCore is True, the devices will send core events\&. If enable is True, the device is enabled immediately\&. .fi @@ -245,7 +245,7 @@ XIAttachSlaveInfo can generate a BadDevice error\&. .RS 4 .\} .nf -XIDettachSlaveInfo deattaches device from the current master +XIDetachSlaveInfo detaches device from the current master device and sets it floating\&. If the device is already floating, no changes are made\&. .fi diff --git a/lib/libXi/man/XIChangeHierarchy.txt b/lib/libXi/man/XIChangeHierarchy.txt index cef826f68..05117067c 100644 --- a/lib/libXi/man/XIChangeHierarchy.txt +++ b/lib/libXi/man/XIChangeHierarchy.txt @@ -77,7 +77,7 @@ DESCRIPTION } XIDetachSlaveInfo; XIAddMasterInfo creates a new master pointer and a new - master keyboard labelled "name pointer" and "name keyboard" + master keyboard labeled "name pointer" and "name keyboard" respectively. If sendCore is True, the devices will send core events. If enable is True, the device is enabled immediately. @@ -99,7 +99,7 @@ DESCRIPTION XIAttachSlaveInfo can generate a BadDevice error. - XIDettachSlaveInfo deattaches device from the current master + XIDetachSlaveInfo detaches device from the current master device and sets it floating. If the device is already floating, no changes are made. diff --git a/lib/libXi/man/XIChangeProperty.man b/lib/libXi/man/XIChangeProperty.man index f10b30f14..470c22d8e 100644 --- a/lib/libXi/man/XIChangeProperty.man +++ b/lib/libXi/man/XIChangeProperty.man @@ -2,12 +2,12 @@ .\" Title: xichangeproperty .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XICHANGEPROPERTY" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XICHANGEPROPERTY" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -69,8 +69,8 @@ Status XIGetProperty( Display *dpy, .sp .nf bytes_after_return - Returns the number of bytes remaining to be read in the prop\- - erty if a partial read was performed\&. + Returns the number of bytes remaining to be read in the property + if a partial read was performed\&. .fi .sp .nf @@ -208,7 +208,7 @@ A = N \- (I + L) .sp The returned value starts at byte index I in the property (indexing from zero), and its length in bytes is L\&. If the value for long_offset causes L to be negative, a BadValue error results\&. The value of bytes_after_return is A, giving the number of trailing unread bytes in the stored property\&. .sp -If the returned format is 8, the returned data is represented as a char array\&. If the returned format is 16, the returned data is represented as a uint16_t array and should be cast to that type to obtain the ele\- ments\&. If the returned format is 32, the returned data is represented as a uint32_t array and should be cast to that type to obtain the elements\&. +If the returned format is 8, the returned data is represented as a char array\&. If the returned format is 16, the returned data is represented as a uint16_t array and should be cast to that type to obtain the elements\&. If the returned format is 32, the returned data is represented as a uint32_t array and should be cast to that type to obtain the elements\&. .sp XIGetProperty always allocates one extra byte in prop_return (even if the property is zero length) and sets it to zero so that simple properties consisting of characters do not have to be copied into yet another string before use\&. .sp diff --git a/lib/libXi/man/XIChangeProperty.txt b/lib/libXi/man/XIChangeProperty.txt index b35d90f5e..c106e6a15 100644 --- a/lib/libXi/man/XIChangeProperty.txt +++ b/lib/libXi/man/XIChangeProperty.txt @@ -39,8 +39,8 @@ SYNOPSIS unsigned char **data) bytes_after_return - Returns the number of bytes remaining to be read in the prop- - erty if a partial read was performed. + Returns the number of bytes remaining to be read in the property + if a partial read was performed. data Specifies the property data. @@ -142,8 +142,8 @@ unread bytes in the stored property. If the returned format is 8, the returned data is represented as a char array. If the returned format is 16, the returned data is represented -as a uint16_t array and should be cast to that type to obtain the ele- -ments. If the returned format is 32, the returned data is represented +as a uint16_t array and should be cast to that type to obtain the elements. +If the returned format is 32, the returned data is represented as a uint32_t array and should be cast to that type to obtain the elements. XIGetProperty always allocates one extra byte in prop_return (even diff --git a/lib/libXi/man/XIDefineCursor.man b/lib/libXi/man/XIDefineCursor.man index 33e83b821..84c067032 100644 --- a/lib/libXi/man/XIDefineCursor.man +++ b/lib/libXi/man/XIDefineCursor.man @@ -2,12 +2,12 @@ .\" Title: xidefinecursor .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIDEFINECURSOR" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIDEFINECURSOR" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XIDeleteProperty.man b/lib/libXi/man/XIDeleteProperty.man index 849e4f611..42e944184 100644 --- a/lib/libXi/man/XIDeleteProperty.man +++ b/lib/libXi/man/XIDeleteProperty.man @@ -1 +1 @@ -.so XIChangeProperty.libmansuffix +.so manlibmansuffix/XIChangeProperty.libmansuffix diff --git a/lib/libXi/man/XIFreeDeviceInfo.man b/lib/libXi/man/XIFreeDeviceInfo.man index 5f4f9922e..314c6de3d 100644 --- a/lib/libXi/man/XIFreeDeviceInfo.man +++ b/lib/libXi/man/XIFreeDeviceInfo.man @@ -1 +1 @@ -.so XIQueryDevice.libmansuffix +.so manlibmansuffix/XIQueryDevice.libmansuffix diff --git a/lib/libXi/man/XIGetClientPointer.man b/lib/libXi/man/XIGetClientPointer.man index 9230bef87..6cd9325a5 100644 --- a/lib/libXi/man/XIGetClientPointer.man +++ b/lib/libXi/man/XIGetClientPointer.man @@ -1 +1 @@ -.so XISetClientPointer.libmansuffix +.so manlibmansuffix/XISetClientPointer.libmansuffix diff --git a/lib/libXi/man/XIGetFocus.man b/lib/libXi/man/XIGetFocus.man index c5f54cac7..c119282d9 100644 --- a/lib/libXi/man/XIGetFocus.man +++ b/lib/libXi/man/XIGetFocus.man @@ -1 +1 @@ -.so XISetFocus.libmansuffix +.so manlibmansuffix/XISetFocus.libmansuffix diff --git a/lib/libXi/man/XIGetProperty.man b/lib/libXi/man/XIGetProperty.man index 849e4f611..42e944184 100644 --- a/lib/libXi/man/XIGetProperty.man +++ b/lib/libXi/man/XIGetProperty.man @@ -1 +1 @@ -.so XIChangeProperty.libmansuffix +.so manlibmansuffix/XIChangeProperty.libmansuffix diff --git a/lib/libXi/man/XIGetSelectedEvents.man b/lib/libXi/man/XIGetSelectedEvents.man index 60b61fd47..fbad756e2 100644 --- a/lib/libXi/man/XIGetSelectedEvents.man +++ b/lib/libXi/man/XIGetSelectedEvents.man @@ -1 +1 @@ -.so XISelectEvents.libmansuffix +.so manlibmansuffix/XISelectEvents.libmansuffix diff --git a/lib/libXi/man/XIGrabButton.man b/lib/libXi/man/XIGrabButton.man index 64d948deb..3d7ded619 100644 --- a/lib/libXi/man/XIGrabButton.man +++ b/lib/libXi/man/XIGrabButton.man @@ -2,12 +2,12 @@ .\" Title: xigrabbutton .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIGRABBUTTON" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIGRABBUTTON" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,7 +28,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -XIGrabButton, XIUngrabButton, XIGrabKeycode, XIUngrabKeycode, XIGrabTouchBegin, XIUngrabTouchBegin \- grab/ungrab buttons or keys +XIGrabButton, XIUngrabButton, XIGrabKeycode, XIUngrabKeycode, XIGrabTouchBegin, XIUngrabTouchBegin, XIGrabPinchGestureBegin, XIUngrabPinchGestureBegin, XIGrabSwipeGestureBegin \- grab/ungrab buttons or keys .SH "SYNOPSIS" .sp .nf @@ -99,6 +99,46 @@ int XIUngrabTouchBegin( Display *display, .fi .sp .nf +int XIGrabPinchGestureBegin( Display* display, + int deviceid, + Window grab_window, + int grab_mode, + int paired_device_mode, + int owner_events, + XIEventMask *mask, + int num_modifiers, + XIGrabModifiers *modifiers_inout); +.fi +.sp +.nf +int XIUngrabPinchGestureBegin( Display* display, + int deviceid, + Window grab_window, + int num_modifiers, + XIGrabModifiers *modifiers); +.fi +.sp +.nf +int XIGrabSwipeGestureBegin( Display* display, + int deviceid, + Window grab_window, + int grab_mode, + int paired_device_mode, + int owner_events, + XIEventMask *mask, + int num_modifiers, + XIGrabModifiers *modifiers_inout); +.fi +.sp +.nf +int XIUngrabSwipeGestureBegin( Display* display, + int deviceid, + Window grab_window, + int num_modifiers, + XIGrabModifiers *modifiers); +.fi +.sp +.nf display Specifies the connection to the X server\&. .fi @@ -176,8 +216,9 @@ paired_device_mode .RS 4 .\} .nf -XIGrabButton, XIGrabKeycode and XIGrabTouchBegin establish a passive -grab\&. The modifier device for a button grab is the paired master device +XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin, +XIGrabSwipeTouchBegin establish a passive grab\&. +The modifier device for a button grab is the paired master device if deviceid specifies a master pointer\&. Otherwise, the modifier device is the device specified with deviceid\&. In the future, the device is actively grabbed (as for XIGrabDevice, the @@ -185,7 +226,7 @@ last\-grab time is set to the time at which the button or keycode was pressed and the XI_ButtonPress or XI_KeyPress event is reported if all of the following conditions are true: * The device is not grabbed, and the specified button or - keycode is logically pressed or a touch event occurs when the + keycode is logically pressed, a touch or a gesture event occurs when the specified modifier keys are logically down on the modifier device and no other buttons or modifier keys are logically down\&. * Either the grab window is an ancestor of (or is) the focus @@ -279,9 +320,11 @@ active grab\&. .RS 4 .\} .nf -On success, XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return 0; +On success, XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, +XIGrabPinchGestureBegin and XIGrabSwipeGestureBegin return 0; If one or more modifier combinations could not be grabbed, -XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return the number of +XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin +and XIGrabSwipeGestureBegin return the number of failed combinations and modifiers_inout contains the failed combinations and their respective error codes\&. .fi @@ -293,7 +336,8 @@ and their respective error codes\&. .RS 4 .\} .nf -XIGrabButton, XIGrabKeycode and XIGrabTouchBegin can generate BadClass, +XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin +and XIGrabSwipeGestureBegin can generate BadClass, BadDevice, BadMatch, BadValue, and BadWindow errors\&. .fi .if n \{\ @@ -304,7 +348,8 @@ BadDevice, BadMatch, BadValue, and BadWindow errors\&. .RS 4 .\} .nf -XIUngrabButton, XIUngrabKeycode and XIUngrabTouchBegin release the +XIUngrabButton, XIUngrabKeycode, XIUngrabTouchBegin, XIUngrabPinchGestureBegin +and XIUngrabSwipeGestureBegin release the passive grab for a button/modifier, keycode/modifier or touch/modifier combination on the specified window if it was grabbed by this client\&. A modifier of XIAnyModifier is equivalent to issuing the ungrab request @@ -322,7 +367,8 @@ grab\&. .RS 4 .\} .nf -XIUngrabButton, XIUngrabKeycode and XIUngrabTouchBegin can generate +XIUngrabButton, XIUngrabKeycode, XIUngrabTouchBegin, +XIUngrabPinchGestureBegin and XIUngrabSwipeGestureBegin can generate BadDevice, BadMatch, BadValue and BadWindow errors\&. .fi .if n \{\ @@ -334,7 +380,8 @@ BadDevice, BadMatch, BadValue and BadWindow errors\&. .RS 4 .\} .nf -XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return the number of +XIGrabButton, XIGrabKeycode, XIGrabTouchBegin and +XIGrabPinchGestureBegin and XIGrabSwipeGestureBegin return the number of modifier combination that could not establish a passive grab\&. The modifiers are returned in modifiers_inout, along with the respective error for this modifier combination\&. If XIGrabButton, XIGrabKeycode @@ -364,8 +411,10 @@ BadDevice BadMatch This error may occur if XIGrabButton specified a device that has no buttons, or XIGrabKeycode specified a device - that has no keys, or XIGrabTouchBegin specified a device - that is not touch\-capable\&. + that has no keys, + or XIGrabTouchBegin specified a device that is not touch\-capable, + or XIGrabPinchGestureBegin specified a device that is not gesture\-capable, + or XIGrabSwipeGestureBegin specified a device that is not gesture\-capable\&. .fi .if n \{\ .RE diff --git a/lib/libXi/man/XIGrabButton.txt b/lib/libXi/man/XIGrabButton.txt index c5100fb94..5d638f12a 100644 --- a/lib/libXi/man/XIGrabButton.txt +++ b/lib/libXi/man/XIGrabButton.txt @@ -4,7 +4,7 @@ XIGRABBUTTON(libmansuffix) NAME ---- - XIGrabButton, XIUngrabButton, XIGrabKeycode, XIUngrabKeycode, XIGrabTouchBegin, XIUngrabTouchBegin - grab/ungrab buttons or keys + XIGrabButton, XIUngrabButton, XIGrabKeycode, XIUngrabKeycode, XIGrabTouchBegin, XIUngrabTouchBegin, XIGrabPinchGestureBegin, XIUngrabPinchGestureBegin, XIGrabSwipeGestureBegin, XIUngrabSwipeGestureBegin - grab/ungrab buttons or keys SYNOPSIS -------- @@ -62,6 +62,38 @@ SYNOPSIS int num_modifiers, XIGrabModifiers *modifiers); + int XIGrabPinchGestureBegin( Display* display, + int deviceid, + Window grab_window, + int grab_mode, + int paired_device_mode, + int owner_events, + XIEventMask *mask, + int num_modifiers, + XIGrabModifiers *modifiers_inout); + + int XIUngrabPinchGestureBegin( Display* display, + int deviceid, + Window grab_window, + int num_modifiers, + XIGrabModifiers *modifiers); + + int XIGrabSwipeGestureBegin( Display* display, + int deviceid, + Window grab_window, + int grab_mode, + int paired_device_mode, + int owner_events, + XIEventMask *mask, + int num_modifiers, + XIGrabModifiers *modifiers_inout); + + int XIUngrabSwipeGestureBegin( Display* display, + int deviceid, + Window grab_window, + int num_modifiers, + XIGrabModifiers *modifiers); + display Specifies the connection to the X server. @@ -114,8 +146,9 @@ SYNOPSIS DESCRIPTION ----------- - XIGrabButton, XIGrabKeycode and XIGrabTouchBegin establish a passive - grab. The modifier device for a button grab is the paired master device + XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin, + XIGrabSwipeTouchBegin establish a passive grab. + The modifier device for a button grab is the paired master device if deviceid specifies a master pointer. Otherwise, the modifier device is the device specified with deviceid. In the future, the device is actively grabbed (as for XIGrabDevice, the @@ -123,7 +156,7 @@ DESCRIPTION was pressed and the XI_ButtonPress or XI_KeyPress event is reported if all of the following conditions are true: * The device is not grabbed, and the specified button or - keycode is logically pressed or a touch event occurs when the + keycode is logically pressed, a touch or a gesture event occurs when the specified modifier keys are logically down on the modifier device and no other buttons or modifier keys are logically down. * Either the grab window is an ancestor of (or is) the focus @@ -169,16 +202,20 @@ DESCRIPTION combination. XIGrabButton and XIGrabKeycode have no effect on an active grab. - On success, XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return 0; + On success, XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, + XIGrabPinchGestureBegin and XIGrabSwipeGestureBegin return 0; If one or more modifier combinations could not be grabbed, - XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return the number of + XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin + and XIGrabSwipeGestureBegin return the number of failed combinations and modifiers_inout contains the failed combinations and their respective error codes. - XIGrabButton, XIGrabKeycode and XIGrabTouchBegin can generate BadClass, + XIGrabButton, XIGrabKeycode, XIGrabTouchBegin, XIGrabPinchGestureBegin + and XIGrabSwipeGestureBegin can generate BadClass, BadDevice, BadMatch, BadValue, and BadWindow errors. - XIUngrabButton, XIUngrabKeycode and XIUngrabTouchBegin release the + XIUngrabButton, XIUngrabKeycode, XIUngrabTouchBegin, XIUngrabPinchGestureBegin + and XIUngrabSwipeGestureBegin release the passive grab for a button/modifier, keycode/modifier or touch/modifier combination on the specified window if it was grabbed by this client. A modifier of XIAnyModifier is equivalent to issuing the ungrab request @@ -188,12 +225,14 @@ DESCRIPTION XIUngrabButton and XIUngrabKeycode have no effect on an active grab. - XIUngrabButton, XIUngrabKeycode and XIUngrabTouchBegin can generate + XIUngrabButton, XIUngrabKeycode, XIUngrabTouchBegin, + XIUngrabPinchGestureBegin and XIUngrabSwipeGestureBegin can generate BadDevice, BadMatch, BadValue and BadWindow errors. RETURN VALUE ------------ - XIGrabButton, XIGrabKeycode and XIGrabTouchBegin return the number of + XIGrabButton, XIGrabKeycode, XIGrabTouchBegin and + XIGrabPinchGestureBegin and XIGrabSwipeGestureBegin return the number of modifier combination that could not establish a passive grab. The modifiers are returned in modifiers_inout, along with the respective error for this modifier combination. If XIGrabButton, XIGrabKeycode @@ -209,8 +248,10 @@ DIAGNOSTICS BadMatch This error may occur if XIGrabButton specified a device that has no buttons, or XIGrabKeycode specified a device - that has no keys, or XIGrabTouchBegin specified a device - that is not touch-capable. + that has no keys, + or XIGrabTouchBegin specified a device that is not touch-capable, + or XIGrabPinchGestureBegin specified a device that is not gesture-capable, + or XIGrabSwipeGestureBegin specified a device that is not gesture-capable. BadValue Some numeric value falls outside the range of values diff --git a/lib/libXi/man/XIGrabDevice.man b/lib/libXi/man/XIGrabDevice.man index 4c42a2270..303759767 100644 --- a/lib/libXi/man/XIGrabDevice.man +++ b/lib/libXi/man/XIGrabDevice.man @@ -2,12 +2,12 @@ .\" Title: xigrabdevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIGRABDEVICE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIGRABDEVICE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XIGrabEnter.man b/lib/libXi/man/XIGrabEnter.man index 09ef66cad..ff02828cb 100644 --- a/lib/libXi/man/XIGrabEnter.man +++ b/lib/libXi/man/XIGrabEnter.man @@ -2,12 +2,12 @@ .\" Title: xigrabenter .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIGRABENTER" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIGRABENTER" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -230,7 +230,7 @@ XIGrabFocusIn on the same window, a BadAccess error results\&. When using XIAnyModifier, the request fails completely, and a XIBadAccess error results (no grabs are established) if there is a conflicting grab for any combination\&. XIGrabEnter and -XIGrabFocusin have no effect on an active grab\&. +XIGrabFocusIn have no effect on an active grab\&. .fi .if n \{\ .RE diff --git a/lib/libXi/man/XIGrabEnter.txt b/lib/libXi/man/XIGrabEnter.txt index 5203f05e3..83fdcc0f9 100644 --- a/lib/libXi/man/XIGrabEnter.txt +++ b/lib/libXi/man/XIGrabEnter.txt @@ -131,7 +131,7 @@ DESCRIPTION When using XIAnyModifier, the request fails completely, and a XIBadAccess error results (no grabs are established) if there is a conflicting grab for any combination. XIGrabEnter and - XIGrabFocusin have no effect on an active grab. + XIGrabFocusIn have no effect on an active grab. On success, XIGrabEnter and XIGrabFocusIn return 0; If one or more modifier combinations could not be grabbed, diff --git a/lib/libXi/man/XIGrabFocusIn.man b/lib/libXi/man/XIGrabFocusIn.man index 0af569967..ebd8b17c2 100644 --- a/lib/libXi/man/XIGrabFocusIn.man +++ b/lib/libXi/man/XIGrabFocusIn.man @@ -1 +1 @@ -.so XIGrabEnter.libmansuffix +.so manlibmansuffix/XIGrabEnter.libmansuffix diff --git a/lib/libXi/man/XIGrabKeycode.man b/lib/libXi/man/XIGrabKeycode.man index d6764b54a..beed4f136 100644 --- a/lib/libXi/man/XIGrabKeycode.man +++ b/lib/libXi/man/XIGrabKeycode.man @@ -1 +1 @@ -.so XIGrabButton.libmansuffix +.so manlibmansuffix/XIGrabButton.libmansuffix diff --git a/lib/libXi/man/XIGrabTouchBegin.man b/lib/libXi/man/XIGrabTouchBegin.man index d6764b54a..beed4f136 100644 --- a/lib/libXi/man/XIGrabTouchBegin.man +++ b/lib/libXi/man/XIGrabTouchBegin.man @@ -1 +1 @@ -.so XIGrabButton.libmansuffix +.so manlibmansuffix/XIGrabButton.libmansuffix diff --git a/lib/libXi/man/XIListProperties.man b/lib/libXi/man/XIListProperties.man index 70970139d..7b185dd24 100644 --- a/lib/libXi/man/XIListProperties.man +++ b/lib/libXi/man/XIListProperties.man @@ -2,12 +2,12 @@ .\" Title: xilistproperties .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XILISTPROPERTIES" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XILISTPROPERTIES" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XIQueryDevice.man b/lib/libXi/man/XIQueryDevice.man index 87a14d9b5..8a53f240d 100644 --- a/lib/libXi/man/XIQueryDevice.man +++ b/lib/libXi/man/XIQueryDevice.man @@ -2,12 +2,12 @@ .\" Title: xiquerydevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIQUERYDEVICE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIQUERYDEVICE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -162,7 +162,7 @@ and the current attachment or pairing\&. and the attachment field specifies the paired master pointer\&. \- If use is XISlavePointer, the device is a slave device and currently attached to the master pointer specified in - attachement\&. + attachment\&. \- If use is XISlaveKeyboard, the device is a slave device an currently attached to the master keyboard specified in attachment\&. @@ -218,7 +218,7 @@ typedef struct The type field specifies the type of the input class\&. Currently, the following types are defined: XIKeyClass, XIButtonClass, XIValuatorClass, XIScrollClass, - XITouchClass + XITouchClass, XIGestureClass\&. .fi .if n \{\ .RE @@ -438,7 +438,7 @@ describing the axis\&. .\} .nf min and max are the minimum and maximum values allowed on this -axis\&. If both are zero, no minumum or maximum values are set on +axis\&. If both are zero, no minimum or maximum values are set on this device\&. value is the current value of this axis\&. .fi .if n \{\ @@ -604,7 +604,7 @@ may send TouchBegin, TouchUpdate, TouchEnd and TouchOwnership events\&. The mode field is either XIDirectTouch for direct\-input touch devices such as touchscreens or XIDependentTouch for indirect input devices such as touchpads\&. For XIDirectTouch devices, touch events are sent to window -at the position the touch occured\&. For XIDependentTouch devices, touch +at the position the touch occurred\&. For XIDependentTouch devices, touch events are sent to the window at the position of the device\*(Aqs sprite\&. .fi .if n \{\ @@ -640,6 +640,47 @@ classes\&. A valuator may send both pointer and touch\-events\&. .RS 4 .\} .nf +typedef struct +{ + int type; + int sourceid; + int num_touches; +} XIGestureClassInfo; +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +A device may have zero or one XIGestureClassInfo, denoting +touchpad gesture capability on the device\&. A device with a XIGestureClassInfo +may send GestureSwipeBegin, GestureSwipeUpdate, GestureSwipeEnd, +GesturePinchBegin, GesturePinchUpdate, GesturePinchEnd\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +The num_touches field defines the maximum number of simultaneous touches +the device supports\&. A num_touches of 0 means the maximum number of +simultaneous touches is undefined or unspecified\&. This field should be +used as a guide only, devices will lie about their capabilities\&. +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf XIQueryDevice can generate a BadDevice error\&. .fi .if n \{\ diff --git a/lib/libXi/man/XIQueryDevice.txt b/lib/libXi/man/XIQueryDevice.txt index e5e825128..bc9e36fa1 100644 --- a/lib/libXi/man/XIQueryDevice.txt +++ b/lib/libXi/man/XIQueryDevice.txt @@ -77,7 +77,7 @@ DESCRIPTION and the attachment field specifies the paired master pointer. - If use is XISlavePointer, the device is a slave device and currently attached to the master pointer specified in - attachement. + attachment. - If use is XISlaveKeyboard, the device is a slave device an currently attached to the master keyboard specified in attachment. @@ -101,7 +101,7 @@ DESCRIPTION The type field specifies the type of the input class. Currently, the following types are defined: XIKeyClass, XIButtonClass, XIValuatorClass, XIScrollClass, - XITouchClass + XITouchClass, XIGestureClass. In the future, additional types may be added. Clients are required to ignore unknown input classes. @@ -185,7 +185,7 @@ DESCRIPTION describing the axis. min and max are the minimum and maximum values allowed on this - axis. If both are zero, no minumum or maximum values are set on + axis. If both are zero, no minimum or maximum values are set on this device. value is the current value of this axis. The resolution field specifies the resolution of the device in @@ -247,7 +247,7 @@ DESCRIPTION The mode field is either XIDirectTouch for direct-input touch devices such as touchscreens or XIDependentTouch for indirect input devices such as touchpads. For XIDirectTouch devices, touch events are sent to window - at the position the touch occured. For XIDependentTouch devices, touch + at the position the touch occurred. For XIDependentTouch devices, touch events are sent to the window at the position of the device's sprite. The num_touches field defines the maximum number of simultaneous touches @@ -259,6 +259,23 @@ DESCRIPTION valuators must be defined with the respective XIValuatorClass classes. A valuator may send both pointer and touch-events. + typedef struct + { + int type; + int sourceid; + int num_touches; + } XIGestureClassInfo; + + A device may have zero or one XIGestureClassInfo, denoting + touchpad gesture capability on the device. A device with a XIGestureClassInfo + may send GestureSwipeBegin, GestureSwipeUpdate, GestureSwipeEnd, + GesturePinchBegin, GesturePinchUpdate, GesturePinchEnd. + + The num_touches field defines the maximum number of simultaneous touches + the device supports. A num_touches of 0 means the maximum number of + simultaneous touches is undefined or unspecified. This field should be + used as a guide only, devices will lie about their capabilities. + XIQueryDevice can generate a BadDevice error. XIFreeDeviceInfo frees the information returned by diff --git a/lib/libXi/man/XIQueryPointer.man b/lib/libXi/man/XIQueryPointer.man index 2c553c240..a00d4e351 100644 --- a/lib/libXi/man/XIQueryPointer.man +++ b/lib/libXi/man/XIQueryPointer.man @@ -2,12 +2,12 @@ .\" Title: xiquerypointer .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIQUERYPOINTER" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIQUERYPOINTER" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XIQueryVersion.man b/lib/libXi/man/XIQueryVersion.man index 7291984ed..2d4018f89 100644 --- a/lib/libXi/man/XIQueryVersion.man +++ b/lib/libXi/man/XIQueryVersion.man @@ -2,12 +2,12 @@ .\" Title: xiqueryversion .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIQUERYVERSION" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIQUERYVERSION" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XISelectEvents.man b/lib/libXi/man/XISelectEvents.man index d259428aa..a2fed861f 100644 --- a/lib/libXi/man/XISelectEvents.man +++ b/lib/libXi/man/XISelectEvents.man @@ -2,12 +2,12 @@ .\" Title: xiselectevents .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XISELECTEVENTS" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XISELECTEVENTS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XISetClientPointer.man b/lib/libXi/man/XISetClientPointer.man index 740331689..4e5479e8e 100644 --- a/lib/libXi/man/XISetClientPointer.man +++ b/lib/libXi/man/XISetClientPointer.man @@ -2,12 +2,12 @@ .\" Title: xisetclientpointer .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XISETCLIENTPOINTER" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XISETCLIENTPOINTER" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -67,7 +67,7 @@ deviceid .RS 4 .\} .nf -The ClientPointer is the device that is percieved to be the +The ClientPointer is the device that is perceived to be the core pointer for non\-XI protocol requests and replies\&. Each time a protocol message needs device\-dependent data and the device is not explicitly given, the ClientPointer device is diff --git a/lib/libXi/man/XISetClientPointer.txt b/lib/libXi/man/XISetClientPointer.txt index bb45cdcf1..bedbb979b 100644 --- a/lib/libXi/man/XISetClientPointer.txt +++ b/lib/libXi/man/XISetClientPointer.txt @@ -32,7 +32,7 @@ SYNOPSIS DESCRIPTION ----------- - The ClientPointer is the device that is percieved to be the + The ClientPointer is the device that is perceived to be the core pointer for non-XI protocol requests and replies. Each time a protocol message needs device-dependent data and the device is not explicitly given, the ClientPointer device is diff --git a/lib/libXi/man/XISetFocus.man b/lib/libXi/man/XISetFocus.man index 82a2871a1..c8d1d30b1 100644 --- a/lib/libXi/man/XISetFocus.man +++ b/lib/libXi/man/XISetFocus.man @@ -2,12 +2,12 @@ .\" Title: xisetfocus .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XISETFOCUS" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XISETFOCUS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -78,7 +78,7 @@ time .RS 4 .\} .nf -XISetFocus changes the focus of the specified device ans its +XISetFocus changes the focus of the specified device and its last\-focus\-change time\&. It has no effect if the specified time is earlier than the current last\-focus\-change time or is later than the current X server time\&. Otherwise, the diff --git a/lib/libXi/man/XISetFocus.txt b/lib/libXi/man/XISetFocus.txt index dbfed7025..6d2f287e4 100644 --- a/lib/libXi/man/XISetFocus.txt +++ b/lib/libXi/man/XISetFocus.txt @@ -38,7 +38,7 @@ SYNOPSIS DESCRIPTION ----------- - XISetFocus changes the focus of the specified device ans its + XISetFocus changes the focus of the specified device and its last-focus-change time. It has no effect if the specified time is earlier than the current last-focus-change time or is later than the current X server time. Otherwise, the diff --git a/lib/libXi/man/XIUndefineCursor.man b/lib/libXi/man/XIUndefineCursor.man index 8afc645e2..fbbbdebf7 100644 --- a/lib/libXi/man/XIUndefineCursor.man +++ b/lib/libXi/man/XIUndefineCursor.man @@ -1 +1 @@ -.so XIDefineCursor.libmansuffix +.so manlibmansuffix/XIDefineCursor.libmansuffix diff --git a/lib/libXi/man/XIUngrabButton.man b/lib/libXi/man/XIUngrabButton.man index d6764b54a..beed4f136 100644 --- a/lib/libXi/man/XIUngrabButton.man +++ b/lib/libXi/man/XIUngrabButton.man @@ -1 +1 @@ -.so XIGrabButton.libmansuffix +.so manlibmansuffix/XIGrabButton.libmansuffix diff --git a/lib/libXi/man/XIUngrabDevice.man b/lib/libXi/man/XIUngrabDevice.man index 8b96d09ba..784a862cb 100644 --- a/lib/libXi/man/XIUngrabDevice.man +++ b/lib/libXi/man/XIUngrabDevice.man @@ -1 +1 @@ -.so XIGrabDevice.libmansuffix +.so manlibmansuffix/XIGrabDevice.libmansuffix diff --git a/lib/libXi/man/XIUngrabEnter.man b/lib/libXi/man/XIUngrabEnter.man index 0af569967..ebd8b17c2 100644 --- a/lib/libXi/man/XIUngrabEnter.man +++ b/lib/libXi/man/XIUngrabEnter.man @@ -1 +1 @@ -.so XIGrabEnter.libmansuffix +.so manlibmansuffix/XIGrabEnter.libmansuffix diff --git a/lib/libXi/man/XIUngrabFocusIn.man b/lib/libXi/man/XIUngrabFocusIn.man index 0af569967..ebd8b17c2 100644 --- a/lib/libXi/man/XIUngrabFocusIn.man +++ b/lib/libXi/man/XIUngrabFocusIn.man @@ -1 +1 @@ -.so XIGrabEnter.libmansuffix +.so manlibmansuffix/XIGrabEnter.libmansuffix diff --git a/lib/libXi/man/XIUngrabKeycode.man b/lib/libXi/man/XIUngrabKeycode.man index d6764b54a..beed4f136 100644 --- a/lib/libXi/man/XIUngrabKeycode.man +++ b/lib/libXi/man/XIUngrabKeycode.man @@ -1 +1 @@ -.so XIGrabButton.libmansuffix +.so manlibmansuffix/XIGrabButton.libmansuffix diff --git a/lib/libXi/man/XIUngrabTouchBegin.man b/lib/libXi/man/XIUngrabTouchBegin.man index d6764b54a..beed4f136 100644 --- a/lib/libXi/man/XIUngrabTouchBegin.man +++ b/lib/libXi/man/XIUngrabTouchBegin.man @@ -1 +1 @@ -.so XIGrabButton.libmansuffix +.so manlibmansuffix/XIGrabButton.libmansuffix diff --git a/lib/libXi/man/XIWarpPointer.man b/lib/libXi/man/XIWarpPointer.man index ff6164522..fd30f90a9 100644 --- a/lib/libXi/man/XIWarpPointer.man +++ b/lib/libXi/man/XIWarpPointer.man @@ -2,12 +2,12 @@ .\" Title: xiwarppointer .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XIWARPPOINTER" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XIWARPPOINTER" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XListDeviceProperties.man b/lib/libXi/man/XListDeviceProperties.man index 0b1951a5d..e4cd206eb 100644 --- a/lib/libXi/man/XListDeviceProperties.man +++ b/lib/libXi/man/XListDeviceProperties.man @@ -2,12 +2,12 @@ .\" Title: xlistdeviceproperties .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XLISTDEVICEPROPERTIE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XLISTDEVICEPROPERTIE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XListInputDevices.man b/lib/libXi/man/XListInputDevices.man index ebe6eef66..a4f1635fa 100644 --- a/lib/libXi/man/XListInputDevices.man +++ b/lib/libXi/man/XListInputDevices.man @@ -2,12 +2,12 @@ .\" Title: xlistinputdevices .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XLISTINPUTDEVICES" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XLISTINPUTDEVICES" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -85,7 +85,7 @@ A master pointer is a virtual pointer device that does not represent a physical device\&. It is visually represented through a cursor\&. A master keyboard is a virtual keyboard device that does not represent a physical device\&. It is virtually -representd through a keyboard focus\&. A master pointer and a +represented through a keyboard focus\&. A master pointer and a master keyboard are always paired (i\&.e\&. if shift is pressed on the master keyboard, a pointer click would be a shift\-click)\&. Multiple master pointer/keyboard pairs can exist\&. diff --git a/lib/libXi/man/XListInputDevices.txt b/lib/libXi/man/XListInputDevices.txt index 8b856f426..d8fff5273 100644 --- a/lib/libXi/man/XListInputDevices.txt +++ b/lib/libXi/man/XListInputDevices.txt @@ -42,7 +42,7 @@ DESCRIPTION represent a physical device. It is visually represented through a cursor. A master keyboard is a virtual keyboard device that does not represent a physical device. It is virtually - representd through a keyboard focus. A master pointer and a + represented through a keyboard focus. A master pointer and a master keyboard are always paired (i.e. if shift is pressed on the master keyboard, a pointer click would be a shift-click). Multiple master pointer/keyboard pairs can exist. diff --git a/lib/libXi/man/XOpenDevice.man b/lib/libXi/man/XOpenDevice.man index 545396234..707b8e38a 100644 --- a/lib/libXi/man/XOpenDevice.man +++ b/lib/libXi/man/XOpenDevice.man @@ -2,12 +2,12 @@ .\" Title: xopendevice .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XOPENDEVICE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XOPENDEVICE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -187,7 +187,7 @@ The information contained in the XInputClassInfo structure is used by macros to obtain the event classes that clients use in making XSelectExtensionEvent requests\&. Currently defined macros include DeviceKeyPress, DeviceKeyRelease, DeviceButtonPress, -DeviceButtonRelese, DeviceMotionNotify, DeviceFocusIn, +DeviceButtonRelease, DeviceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut, DeviceStateNotify, DeviceMappingNotify, ChangeDeviceNotify, DevicePointerMotionHint, DeviceButton1Motion, diff --git a/lib/libXi/man/XOpenDevice.txt b/lib/libXi/man/XOpenDevice.txt index fbeb5e712..dee5dc74d 100644 --- a/lib/libXi/man/XOpenDevice.txt +++ b/lib/libXi/man/XOpenDevice.txt @@ -80,7 +80,7 @@ Structures used by macros to obtain the event classes that clients use in making XSelectExtensionEvent requests. Currently defined macros include DeviceKeyPress, DeviceKeyRelease, DeviceButtonPress, - DeviceButtonRelese, DeviceMotionNotify, DeviceFocusIn, + DeviceButtonRelease, DeviceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut, DeviceStateNotify, DeviceMappingNotify, ChangeDeviceNotify, DevicePointerMotionHint, DeviceButton1Motion, diff --git a/lib/libXi/man/XQueryDeviceState.man b/lib/libXi/man/XQueryDeviceState.man index b043b79cd..01b126b2a 100644 --- a/lib/libXi/man/XQueryDeviceState.man +++ b/lib/libXi/man/XQueryDeviceState.man @@ -2,12 +2,12 @@ .\" Title: xquerydevicestate .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XQUERYDEVICESTATE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XQUERYDEVICESTATE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XSelectExtensionEvent.man b/lib/libXi/man/XSelectExtensionEvent.man index f4314c109..6a9378dbd 100644 --- a/lib/libXi/man/XSelectExtensionEvent.man +++ b/lib/libXi/man/XSelectExtensionEvent.man @@ -2,12 +2,12 @@ .\" Title: xselectextensionevent .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSELECTEXTENSIONEVEN" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSELECTEXTENSIONEVEN" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -152,7 +152,7 @@ Information contained in the XDevice structure returned by XOpenDevice is used by macros to obtain the event classes that clients use in making XSelectExtensionEvent requests\&. Currently defined macros include DeviceKeyPress, DeviceKeyRelease, -DeviceButtonPress, DeviceButtonRelese, DeviceMotionNotify, +DeviceButtonPress, DeviceButtonRelease, DeviceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut, DeviceStateNotify, DeviceMappingNotify, ChangeDeviceNotify, DevicePointerMotionHint, DeviceButton1Motion, diff --git a/lib/libXi/man/XSelectExtensionEvent.txt b/lib/libXi/man/XSelectExtensionEvent.txt index 95e0ac754..a2a9ec726 100644 --- a/lib/libXi/man/XSelectExtensionEvent.txt +++ b/lib/libXi/man/XSelectExtensionEvent.txt @@ -84,7 +84,7 @@ DESCRIPTION XOpenDevice is used by macros to obtain the event classes that clients use in making XSelectExtensionEvent requests. Currently defined macros include DeviceKeyPress, DeviceKeyRelease, - DeviceButtonPress, DeviceButtonRelese, DeviceMotionNotify, + DeviceButtonPress, DeviceButtonRelease, DeviceMotionNotify, DeviceFocusIn, DeviceFocusOut, ProximityIn, ProximityOut, DeviceStateNotify, DeviceMappingNotify, ChangeDeviceNotify, DevicePointerMotionHint, DeviceButton1Motion, diff --git a/lib/libXi/man/XSendExtensionEvent.man b/lib/libXi/man/XSendExtensionEvent.man index b97d299fc..6d0cbd8b6 100644 --- a/lib/libXi/man/XSendExtensionEvent.man +++ b/lib/libXi/man/XSendExtensionEvent.man @@ -2,12 +2,12 @@ .\" Title: xsendextensionevent .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSENDEXTENSIONEVENT" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSENDEXTENSIONEVENT" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -59,7 +59,7 @@ device .nf destination Specifies the window the event is to be sent to\&. You can - pass window id, PointerWindow,or InputFocus\&. + pass window id, PointerWindow, or InputFocus\&. .fi .sp .nf @@ -94,10 +94,10 @@ to pass an event class list\&. For a discussion of the valid event class names, see XOpenDevice(libmansuffix) This request uses the w argument to identify the destination window as follows: - * If w is PointerWindow,the destination window is the window + * If w is PointerWindow, the destination window is the window that contains the pointer\&. - * If w is InputFocusand if the focus window contains the - pointer,the destination window is the window that contains + * If w is InputFocus and if the focus window contains the + pointer, the destination window is the window that contains the pointer; otherwise, the destination window is the focus window\&. .fi @@ -110,24 +110,24 @@ as follows: .\} .nf To determine which clients should receive the specified events, -XSendExtensionEventuses the propagate argument as follows: - * If event_list is the empty set,the event is sent to the +XSendExtensionEvent uses the propagate argument as follows: + * If event_list is the empty set, the event is sent to the client that created the destination window\&. If that client - no longer exists,no event is sent\&. - * If propagate is False,the event is sent to every client - selecting on destination any of the eventtypes specified by + no longer exists, no event is sent\&. + * If propagate is False, the event is sent to every client + selecting on destination any of the event types specified by the event_list array\&. - * If propagate is Trueand no clients have selected on - destination any ofthe events specified by the event_list - array,the destination is replaced with theclosest ancestor - of destination for which some client has selected atype + * If propagate is True and no clients have selected on + destination any of the events specified by the event_list + array, the destination is replaced with the closest ancestor + of destination for which some client has selected a type specified by the event\-list array and for which no - interveningwindow has that type in - itsdo\-not\-propagate\-mask\&. If no such window exists or if - the window isan ancestor of the focus window and - InputFocuswas originally specifiedas the destination, the + intervening window has that type in + its do\-not\-propagate\-mask\&. If no such window exists or if + the window is an ancestor of the focus window and + InputFocus was originally specified as the destination, the event is not sent to any clients\&. Otherwise, the event is - reported to every client selecting on the finaldestination + reported to every client selecting on the final destination any of the events specified in the event_list array\&. .fi .if n \{\ @@ -138,11 +138,11 @@ XSendExtensionEventuses the propagate argument as follows: .RS 4 .\} .nf -The event in the XEventstructure must be one of the events -defined by the input extension (or a BadValueerror results) so -that the X server can correctly byte\-swapthe contents as -necessary\&. The contents of the event areotherwise unaltered and -unchecked by the X server except to force send_event to Truein +The event in the XEvent structure must be one of the events +defined by the input extension (or a BadValue error results) so +that the X server can correctly byte\-swap the contents as +necessary\&. The contents of the event are otherwise unaltered and +unchecked by the X server except to force send_event to True in the forwarded event and to set the serial number in the event correctly\&. .fi @@ -154,9 +154,9 @@ correctly\&. .RS 4 .\} .nf -XSendExtensionEventreturns zero if the conversion to wire -protocol format failedand returns nonzero -otherwise\&.XSendExtensionEventcan generate BadClass, BadDevice, +XSendExtensionEvent returns zero if the conversion to wire +protocol format failed and returns nonzero +otherwise\&. XSendExtensionEvent can generate BadClass, BadDevice, BadValue, and BadWindow errors\&. .fi .if n \{\ diff --git a/lib/libXi/man/XSendExtensionEvent.txt b/lib/libXi/man/XSendExtensionEvent.txt index 77051a56d..efec173b8 100644 --- a/lib/libXi/man/XSendExtensionEvent.txt +++ b/lib/libXi/man/XSendExtensionEvent.txt @@ -28,7 +28,7 @@ SYNOPSIS destination Specifies the window the event is to be sent to. You can - pass window id, PointerWindow,or InputFocus. + pass window id, PointerWindow, or InputFocus. propagate Specifies a Boolean value that is either True or False. @@ -52,45 +52,45 @@ DESCRIPTION event class names, see XOpenDevice(libmansuffix) This request uses the w argument to identify the destination window as follows: - * If w is PointerWindow,the destination window is the window + * If w is PointerWindow, the destination window is the window that contains the pointer. - * If w is InputFocusand if the focus window contains the - pointer,the destination window is the window that contains + * If w is InputFocus and if the focus window contains the + pointer, the destination window is the window that contains the pointer; otherwise, the destination window is the focus window. To determine which clients should receive the specified events, - XSendExtensionEventuses the propagate argument as follows: - * If event_list is the empty set,the event is sent to the + XSendExtensionEvent uses the propagate argument as follows: + * If event_list is the empty set, the event is sent to the client that created the destination window. If that client - no longer exists,no event is sent. - * If propagate is False,the event is sent to every client - selecting on destination any of the eventtypes specified by + no longer exists, no event is sent. + * If propagate is False, the event is sent to every client + selecting on destination any of the event types specified by the event_list array. - * If propagate is Trueand no clients have selected on - destination any ofthe events specified by the event_list - array,the destination is replaced with theclosest ancestor - of destination for which some client has selected atype + * If propagate is True and no clients have selected on + destination any of the events specified by the event_list + array, the destination is replaced with the closest ancestor + of destination for which some client has selected a type specified by the event-list array and for which no - interveningwindow has that type in - itsdo-not-propagate-mask. If no such window exists or if - the window isan ancestor of the focus window and - InputFocuswas originally specifiedas the destination, the + intervening window has that type in + its do-not-propagate-mask. If no such window exists or if + the window is an ancestor of the focus window and + InputFocus was originally specified as the destination, the event is not sent to any clients. Otherwise, the event is - reported to every client selecting on the finaldestination + reported to every client selecting on the final destination any of the events specified in the event_list array. - The event in the XEventstructure must be one of the events - defined by the input extension (or a BadValueerror results) so - that the X server can correctly byte-swapthe contents as - necessary. The contents of the event areotherwise unaltered and - unchecked by the X server except to force send_event to Truein + The event in the XEvent structure must be one of the events + defined by the input extension (or a BadValue error results) so + that the X server can correctly byte-swap the contents as + necessary. The contents of the event are otherwise unaltered and + unchecked by the X server except to force send_event to True in the forwarded event and to set the serial number in the event correctly. - XSendExtensionEventreturns zero if the conversion to wire - protocol format failedand returns nonzero - otherwise.XSendExtensionEventcan generate BadClass, BadDevice, + XSendExtensionEvent returns zero if the conversion to wire + protocol format failed and returns nonzero + otherwise. XSendExtensionEvent can generate BadClass, BadDevice, BadValue, and BadWindow errors. DIAGNOSTICS diff --git a/lib/libXi/man/XSetDeviceButtonMapping.man b/lib/libXi/man/XSetDeviceButtonMapping.man index 002787650..7b2c4503a 100644 --- a/lib/libXi/man/XSetDeviceButtonMapping.man +++ b/lib/libXi/man/XSetDeviceButtonMapping.man @@ -2,12 +2,12 @@ .\" Title: xsetdevicebuttonmapping .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSETDEVICEBUTTONMAPP" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSETDEVICEBUTTONMAPP" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -115,7 +115,7 @@ BadValue errors\&. .nf The XGetDeviceButtonMapping request returns the current mapping of the specified device\&. Buttons are numbered starting from -one\&.XGetDeviceButtonMapping returns the number of physical +one\&. XGetDeviceButtonMapping returns the number of physical buttons actually on the device\&. The nominal mapping for a device is map[i]=i+1\&. The nmap argument specifies the length of the array where the device mapping is returned, and only the diff --git a/lib/libXi/man/XSetDeviceButtonMapping.txt b/lib/libXi/man/XSetDeviceButtonMapping.txt index 4c1251cdb..36890fa50 100644 --- a/lib/libXi/man/XSetDeviceButtonMapping.txt +++ b/lib/libXi/man/XSetDeviceButtonMapping.txt @@ -60,7 +60,7 @@ DESCRIPTION The XGetDeviceButtonMapping request returns the current mapping of the specified device. Buttons are numbered starting from - one.XGetDeviceButtonMapping returns the number of physical + one. XGetDeviceButtonMapping returns the number of physical buttons actually on the device. The nominal mapping for a device is map[i]=i+1. The nmap argument specifies the length of the array where the device mapping is returned, and only the diff --git a/lib/libXi/man/XSetDeviceFocus.man b/lib/libXi/man/XSetDeviceFocus.man index b885c61fc..ce2604cca 100644 --- a/lib/libXi/man/XSetDeviceFocus.man +++ b/lib/libXi/man/XSetDeviceFocus.man @@ -2,12 +2,12 @@ .\" Title: xsetdevicefocus .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSETDEVICEFOCUS" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSETDEVICEFOCUS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XSetDeviceMode.man b/lib/libXi/man/XSetDeviceMode.man index 544a1b3c7..b436634bc 100644 --- a/lib/libXi/man/XSetDeviceMode.man +++ b/lib/libXi/man/XSetDeviceMode.man @@ -2,12 +2,12 @@ .\" Title: xsetdevicemode .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSETDEVICEMODE" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSETDEVICEMODE" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XSetDeviceModifierMapping.man b/lib/libXi/man/XSetDeviceModifierMapping.man index 3362ea9eb..1f3aa2d8f 100644 --- a/lib/libXi/man/XSetDeviceModifierMapping.man +++ b/lib/libXi/man/XSetDeviceModifierMapping.man @@ -1 +1 @@ -.so XGetDeviceModifierMapping.libmansuffix +.so manlibmansuffix/XGetDeviceModifierMapping.libmansuffix diff --git a/lib/libXi/man/XSetDeviceValuators.man b/lib/libXi/man/XSetDeviceValuators.man index 408a92277..8c310f0e0 100644 --- a/lib/libXi/man/XSetDeviceValuators.man +++ b/lib/libXi/man/XSetDeviceValuators.man @@ -2,12 +2,12 @@ .\" Title: xsetdevicevaluators .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 06/19/2019 +.\" Date: 09/15/2021 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "XSETDEVICEVALUATORS" "libmansuffix" "06/19/2019" "\ \&" "\ \&" +.TH "XSETDEVICEVALUATORS" "libmansuffix" "09/15/2021" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/lib/libXi/man/XUngrabDevice.man b/lib/libXi/man/XUngrabDevice.man index 92a0ec776..f7925d1a2 100644 --- a/lib/libXi/man/XUngrabDevice.man +++ b/lib/libXi/man/XUngrabDevice.man @@ -1 +1 @@ -.so XGrabDevice.libmansuffix +.so manlibmansuffix/XGrabDevice.libmansuffix diff --git a/lib/libXi/man/XUngrabDeviceButton.man b/lib/libXi/man/XUngrabDeviceButton.man index 1131aafe7..aed816df3 100644 --- a/lib/libXi/man/XUngrabDeviceButton.man +++ b/lib/libXi/man/XUngrabDeviceButton.man @@ -1 +1 @@ -.so XGrabDeviceButton.libmansuffix +.so manlibmansuffix/XGrabDeviceButton.libmansuffix diff --git a/lib/libXi/man/XUngrabDeviceKey.man b/lib/libXi/man/XUngrabDeviceKey.man index e57f8ef99..19849bb04 100644 --- a/lib/libXi/man/XUngrabDeviceKey.man +++ b/lib/libXi/man/XUngrabDeviceKey.man @@ -1 +1 @@ -.so XGrabDeviceKey.libmansuffix +.so manlibmansuffix/XGrabDeviceKey.libmansuffix |