From bf13f197406fe745c5ff46a4748a41b6646aebf6 Mon Sep 17 00:00:00 2001 From: Alan Coopersmith Date: Sun, 20 Aug 2023 14:09:35 -0700 Subject: [PATCH] docs: remove XkbGetSlowKeysDelay & XkbSetSlowKeysDelay These functions were documented but never implemented. Signed-off-by: Alan Coopersmith --- man/xkb/Makefile.am | 1 - man/xkb/XkbGetSlowKeysDelay.man | 214 -------------------------------- specs/XKB/ch10.xml | 156 +---------------------- 3 files changed, 6 insertions(+), 365 deletions(-) delete mode 100644 man/xkb/XkbGetSlowKeysDelay.man diff --git a/man/xkb/Makefile.am b/man/xkb/Makefile.am index 428aaa3c..51392e4a 100644 --- a/man/xkb/Makefile.am +++ b/man/xkb/Makefile.am @@ -112,7 +112,6 @@ libman_PRE = \ XkbGetNamedGeometry.man \ XkbGetNamedIndicator.man \ XkbGetNames.man \ - XkbGetSlowKeysDelay.man \ XkbGetState.man \ XkbGetStickyKeysOptions.man \ XkbGetUpdatedMap.man \ diff --git a/man/xkb/XkbGetSlowKeysDelay.man b/man/xkb/XkbGetSlowKeysDelay.man deleted file mode 100644 index 279e3321..00000000 --- a/man/xkb/XkbGetSlowKeysDelay.man +++ /dev/null @@ -1,214 +0,0 @@ -'\" t -.\" Copyright (c) 1999, Oracle and/or its affiliates. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbGetSlowKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbGetSlowKeysDelay \- Gets the SlowKeys acceptance delay for a keyboard device -.SH SYNOPSIS -.HP -.B Bool XkbGetSlowKeysDelay -.BI "(\^Display *" "display" "\^," -.BI "unsigned int " "device_spec" "\^," -.BI "unsigned int *" "delay_rtrn" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I display -connection to X server -.TP -.I device_spec -device ID, or XkbUseCoreKbd -.TP -.I delay_rtrn -backfilled with SlowKeys delay, ms -.SH DESCRIPTION -.LP -Some users may accidentally bump keys while moving a hand or typing stick toward -the key they want. Usually, the keys that are accidentally bumped are just hit -for a very short period of time. The SlowKeys control helps filter these -accidental bumps by telling the server to wait a specified period, called the -.I SlowKeys acceptance delay, -before delivering key events. If the key is released before this period elapses, -no key events are generated. Users can then bump any number of keys on their way -to the one they want without accidentally getting those characters. Once they -have reached the key they want, they can then hold the desired key long enough -for the computer to accept it. SlowKeys is a boolean control with one -configurable attribute. - -When the SlowKeys control is active, the server reports the initial key press, -subsequent acceptance or rejection, and release of any key to interested clients -by sending an appropriate AccessXNotify event (see section 10.6.4). - -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. - -.TS -c s -l l -l lw(4i). -Table 1 AccessXNotify Events -_ -detail Reason -_ -XkbAXN_SKPress T{ -A key was pressed when SlowKeys was enabled. -T} -XkbAXN_SKAccept T{ -A key was accepted (held longer than the SlowKeys delay). -T} -XkbAXN_SKRelease T{ -An accepted SlowKeys key was released. -T} -XkbAXN_SKReject T{ -A key was rejected (released before the SlowKeys delay expired). -T} -XkbAXN_BKAccept T{ -A key was accepted by BounceKeys. -T} -XkbAXN_BKReject T{ -A key was rejected (pressed before the BounceKeys delay expired). -T} -XkbAXN_AXKWarning T{ -AccessXKeys is about to turn on/off StickyKeys or BounceKeys. -T} -.TE - - -The -.I keycode -field reports the keycode of the key for which the event occurred. If the action -is related to -.I SlowKeys, -the -.I slowKeysDelay -field contains the current SlowKeys acceptance delay. If the action is related -to BounceKeys, -the -.I debounceDelay -field contains the current BounceKeys debounce delay. - -Selecting for AccessX Events - -To receive XkbAccessXNotify events under all possible conditions, use -.I XkbSelectEvents -and pass XkbAccesXNotifyMask in both -.I bits_to_change -and -.I values_for_bits. - -To receive XkbStateNotify events only under certain conditions, use -.I XkbSelectEventDetails -using XkbAccessXNotify as the -.I event_type -and specifying the desired state changes in -.I bits_to_change -and -.I values_for_bits -using mask bits from Table 2. - -.TS -c s s -l l l -l l lw(3i). -Table 2 AccessXNotify Event Details -_ -XkbAccessXNotify Event Details Value Circumstances -_ -XkbAXN_SKPressMask (1<<0) T{ -Slow key press notification wanted -T} -XkbAXN_SKAcceptMask (1<<1) T{ -Slow key accept notification wanted -T} -XkbAXN_SKRejectMask (1<<2) T{ -Slow key reject notification wanted -T} -XkbAXN_SKReleaseMask (1<<3) T{ -Slow key release notification wanted -T} -XkbAXN_BKAcceptMask (1<<4) T{ -Bounce key accept notification wanted -T} -XkbAXN_BKRejectMask (1<<5) T{ -Bounce key reject notification wanted -T} -XkbAXN_AXKWarningMask (1<<6) T{ -AccessX warning notification wanted -T} -XkbAllAccessXEventsMask (0x7f) T{ -All AccessX features notifications wanted -T} -.TE - -.I XkbGetSlowKeysDelay -requests the attributes of the SlowKeys control from the server, waits for a -reply and backfills -.I delay_rtrn -with the SlowKeys delay attribute. -.I XkbGetSlowKeysDelay -returns True if successful; , -.I XkbGetSlowKeysDelay -returns False. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbGetSlowKeysDelay -function returns True if the request of the Slowkeys control from the server was -successful. -.I -.TP 15 -False -The -.I XkbGetSlowKeysDelay -function returns False if a compatible version of the Xkb extension is not -available in the server. -.SH STRUCTURES -.LP -The structure for the XkbAccessXNotify event type is as follows: - -.nf -typedef struct { - int type; /\&* Xkb extension base event code */ - unsigned long serial; /\&* X server serial number for event */ - Bool send_event; /\&* True => synthetically generated */ - Display * display; /\&* server connection where event generated */ - Time time; /\&* server time when event generated */ - int xkb_type; /\&* XkbAccessXNotify */ - int device; /\&* Xkb device ID, will not be XkbUseCoreKbd */ - int detail; /\&* XkbAXN_* */ - KeyCode keycode; /\&* key of event */ - int slowKeysDelay; /\&* current SlowKeys delay */ - int debounceDelay; /\&* current debounce delay */ -} XkbAccessXNotifyEvent; - -.fi - diff --git a/specs/XKB/ch10.xml b/specs/XKB/ch10.xml index d34ce258..19d15e02 100644 --- a/specs/XKB/ch10.xml +++ b/specs/XKB/ch10.xml @@ -2032,159 +2032,15 @@ event (see section 10.6.4). -To get the +There are no convenience functions in Xkb for manipulating this control. The SlowKeys -acceptance delay for a keyboard device, use -XkbGetSlowKeysDelay. +control settings are carried in the +slow_keys_delay +field of an +XkbControlsRec +structure, discussed in section 10.8. -XkbGetSlowKeysDelay - - - Bool XkbGetSlowKeysDelay - - - Display *display - unsigned int device_spec - unsigned int *delay_rtrn - - - - - - display - - - - connection to X server - - - - - - device_spec - - - - device ID, or XkbUseCoreKbd - - - - - - delay_rtrn - - - - backfilled with SlowKeys delay, ms - - - - - - -XkbGetSlowKeysDelay -requests the attributes of the -SlowKeys -control from the server, waits for a reply and backfills -delay_rtrn -with the -SlowKeys -delay attribute. -XkbGetSlowKeysDelay -returns -True -if successful; if a compatible version of the Xkb extension is not available -in the server, -XkbGetSlowKeysDelay -returns -False. - - - - -To set the -SlowKeys -acceptance delay for a keyboard device, use -XkbSetSlowKeysDelay. - - - -XkbSetSlowKeysDelay - - - Bool XkbSetSlowKeysDelay - - - Display *display - unsigned int device_spec - unsigned int delay - - - - - - display - - - - connection to X server - - - - - - device_spec - - - - device to configure, or XkbUseCoreKbd - - - - - - delay - - - - SlowKeys delay, ms - - - - - - -XkbSetSlowKeysDelay -sends a request to configure the -SlowKeys -control to the server. -It does not wait for a reply, and normally returns -True. -Specifying a value of -0 -for the -delay -parameter causes -XkbSetSlowKeysDelay -to generate a -BadValue -protocol error. If a compatible version of the Xkb extension is not available -in the server -XkbSetSlowKeysDelay -returns -False. - - - The BounceKeys Control