diff --git a/specs/XKB/ch01.xml b/specs/XKB/ch01.xml index 8e447187..86db1919 100644 --- a/specs/XKB/ch01.xml +++ b/specs/XKB/ch01.xml @@ -309,7 +309,7 @@ configuration. The Xkb extension adds a single protocol error, BadKeyboard, -to the core protocol error set. See section 2.6 for a discussion of the +to the core protocol error set. See section 2.6 for a discussion of the BadKeyboard protocol error. diff --git a/specs/XKB/ch02.xml b/specs/XKB/ch02.xml index 65a214e5..40fbb3a5 100644 --- a/specs/XKB/ch02.xml +++ b/specs/XKB/ch02.xml @@ -308,7 +308,7 @@ and the major and minor version numbers of the extension in The major opcode is reported in the req_major fields of some Xkb events. For a discussion of the base event code, see -section 4.1. +section 4.1. diff --git a/specs/XKB/ch04.xml b/specs/XKB/ch04.xml index a0456129..8e5d110a 100644 --- a/specs/XKB/ch04.xml +++ b/specs/XKB/ch04.xml @@ -18,7 +18,7 @@ of which window currently has the keyboard focus and regardless of the grab state of the keyboard.The one exception to this rule is the XkbExtensionDeviceNotify event report that is sent when a client attempts to use an unsupported feature of an X Input Extension device (see section 21.4). - + diff --git a/specs/XKB/ch05.xml b/specs/XKB/ch05.xml index 3b72824e..c611ba4d 100644 --- a/specs/XKB/ch05.xml +++ b/specs/XKB/ch05.xml @@ -168,7 +168,7 @@ The global locked or effective group changes. In this case, the changed group is groups_wrap field of the XkbControlsRec - structure for the keyboard (see section 10.7.1). + structure for the keyboard (see section 10.7.1). @@ -871,7 +871,7 @@ To track changes in the keyboard state for a particular device, select to receiv XkbSelectEvents or XkbSelectEventDetails - (see section 4.3). + (see section 4.3). diff --git a/specs/XKB/ch06.xml b/specs/XKB/ch06.xml index d6f3de91..ebf0747a 100644 --- a/specs/XKB/ch06.xml +++ b/specs/XKB/ch06.xml @@ -276,7 +276,7 @@ The valid masks for To free the returned keyboard description, use XkbFreeKeyboard - (see section 6.4). + (see section 6.4). @@ -286,7 +286,7 @@ To free the returned keyboard description, use The server can generate events whenever its copy of the keyboard description -for a device changes. Refer to section 14.4 for detailed information on +for a device changes. Refer to section 14.4 for detailed information on tracking changes to the keyboard description. diff --git a/specs/XKB/ch07.xml b/specs/XKB/ch07.xml index ca138006..650534e7 100644 --- a/specs/XKB/ch07.xml +++ b/specs/XKB/ch07.xml @@ -229,14 +229,14 @@ applications should need to change the virtual modifier mapping explicitly. Use XkbGetMap -(see section 14.2) to get the virtual modifiers from the server or use +(see section 14.2) to get the virtual modifiers from the server or use XkbGetVirtualMods - (see section 16.4.1) to update a local copy of the virtual modifiers bindings + (see section 16.4.1) to update a local copy of the virtual modifiers bindings from the server. To set the binding of a virtual modifier to a real modifier, use XkbSetMap (see -section 14.3 +section 14.3 ). diff --git a/specs/XKB/ch08.xml b/specs/XKB/ch08.xml index e37f218f..8428d630 100644 --- a/specs/XKB/ch08.xml +++ b/specs/XKB/ch08.xml @@ -58,7 +58,7 @@ specific indicators, use XkbSetNamedIndicator (below). To retrieve indicator names, use XkbGetNames - (). + (). @@ -81,7 +81,7 @@ to inquire about and control most indicator properties and behaviors. The description for all the Xkb indicators is held in the indicators - field of the complete keyboard description (see ), which is defined + field of the complete keyboard description (see ), which is defined as follows: @@ -188,7 +188,7 @@ using the functions For more information on the effects of explicit changes to indicators and the -relationship to the indicator map, see section 8.4.1. +relationship to the indicator map, see section 8.4.1. @@ -532,7 +532,7 @@ field specifies what modifiers an indicator watches. The mods field is an Xkb modifier definition, XkbModsRec, -as described in section 7.2, which can specify both real and virtual +as described in section 7.2, which can specify both real and virtual modifiers. The mods field takes effect even if some or all of the virtual indicators specified in @@ -574,7 +574,7 @@ Remember that the mask field is comprised of all of the real modifiers specified in the definition plus any real modifiers that are bound to the virtual modifiers specified in -the definition. (See for more information on the keyboard state and +the definition. (See for more information on the keyboard state and for more information on virtual modifiers.) Use a bitwise inclusive OR of the following values to compose a value for which_mods: @@ -707,7 +707,7 @@ The effect on the keyboard modifiers of is set (the indicator drives the keyboard) is shown in Table 8.5. The "New State" column refers to the new state to which you set the indicator. - + XkbIndicatorMapRec which_mods and mods, Indicator Drives Keyboard @@ -797,7 +797,7 @@ The ctrls field specifies what controls (see ) the indicator watches and is composed using the bitwise inclusive OR of the following values: - + #define XkbRepeatKeysMask (1L << 0) @@ -1588,11 +1588,11 @@ in map. BadImplementation errors. In addition, it can also generate XkbIndicatorStateNotify - (see section 8.5), + (see section 8.5), XkbIndicatorMapNotify, and XkbNamesNotify - events (see section 18.5). + events (see section 18.5). @@ -1721,7 +1721,7 @@ s can generate XkbIndicatorStateNotify and XkbIndicatorMapNotify - events (see section 8.5). + events (see section 8.5). @@ -1745,7 +1745,7 @@ To receive XkbIndicatorStateNotify events, use XkbSelectEvents - (see section 4.3) with both the + (see section 4.3) with both the bits_to_change and values_for_bits @@ -1995,7 +1995,7 @@ If the indicators field, use XkbFreeIndicators - (see section 8.6). + (see section 8.6). diff --git a/specs/XKB/ch09.xml b/specs/XKB/ch09.xml index bf381d79..d21feef4 100644 --- a/specs/XKB/ch09.xml +++ b/specs/XKB/ch09.xml @@ -16,7 +16,7 @@ opposed to any other audible sound generated elsewhere in the system. You can ask to receive XkbBellNotify - events (see section 9.4) when any client rings any one of the following: + events (see section 9.4) when any client rings any one of the following: @@ -75,7 +75,7 @@ spite of the setting of the XkbForceDeviceBell or XkbForceBell - (see section 9.3.3). In this case the server does not generate a bell event. + (see section 9.3.3). In this case the server does not generate a bell event. @@ -85,7 +85,7 @@ or repeating, Xkb can provide feedback for the controls by using special beep codes. The AccessXFeedback control is used to configure the specific types of operations that generate -feedback. See section 10.6.3 for a discussion on +feedback. See section 10.6.3 for a discussion on AccessXFeedback control. @@ -204,7 +204,7 @@ bell. This is useful if you need to use an audio server instead of the system beep. For example, when an audio client starts, it could disable the audible bell (the system bell) and then listen for XkbBellNotify - events (see section 9.4). When it receives a + events (see section 9.4). When it receives a XkbBellNotify event, the audio client could then send a request to an audio server to play a sound. @@ -216,7 +216,7 @@ You can control the audible bells feature by passing the XkbAudibleBellMask to XkbChangeEnabledControls - (see section 10.1.1). If you set + (see section 10.1.1). If you set XkbAudibleBellMask on, the server rings the system bell when a bell event occurs. This is the default. If you set @@ -226,12 +226,12 @@ you call XkbForceDeviceBell or XkbForceBell - (see section 9.3.3). + (see section 9.3.3). Audible bells are also part of the per-client auto-reset controls. For more -information on auto-reset controls, see section 10.1.2. +information on auto-reset controls, see section 10.1.2. @@ -1074,7 +1074,7 @@ and values_for_bits parameters to XkbSelectEvents - (see section 4.3). + (see section 4.3). diff --git a/specs/XKB/ch10.xml b/specs/XKB/ch10.xml index 1fd5eac7..632eece5 100644 --- a/specs/XKB/ch10.xml +++ b/specs/XKB/ch10.xml @@ -616,10 +616,10 @@ and disable it using either the EnabledControls control or the AutoReset - control discussed in section 10.1.1. When enabled, protocol requests to + control discussed in section 10.1.1. When enabled, protocol requests to generate a sound result in the X server actually producing a real sound; when disabled, requests to the server to generate a sound are ignored unless the -sound is forced. See section 9.2. +sound is forced. See section 9.2. @@ -663,7 +663,7 @@ control. The per_key_repeat field of an XkbControlsRec - structure, discussed in section 10.8. + structure, discussed in section 10.8. @@ -1148,7 +1148,7 @@ the EnabledControls control or the AutoReset - control discussed in section 10.1.1. + control discussed in section 10.1.1. @@ -1158,7 +1158,7 @@ should generate when that overlay is enabled, assign it either the XkbKB_Overlay1 or XkbKB_Overlay2 - key behaviors, as described in section 16.2. + key behaviors, as described in section 16.2. @@ -1181,9 +1181,9 @@ and disable them using either the EnabledControls control or the AutoReset - control discussed in section 10.1.1. The individual keys that simulate + control discussed in section 10.1.1. The individual keys that simulate different aspects of the pointer device are determined by the keyboard mapping, -discussed in . +discussed in . @@ -1217,7 +1217,7 @@ or setting the attribute; instead use XkbGetControls and XkbSetControls - (see section 10.9 and section 10.10). + (see section 10.9 and section 10.10). @@ -1244,7 +1244,7 @@ mouse-pointer key yields one mouse event. When XkbSA_MovePtr action and the following fields in the XkbControlsRec - structure (see section 10.8). + structure (see section 10.8).
@@ -1293,7 +1293,7 @@ There are no convenience functions to query or change the attributes of the XkbGetControls and XkbSetControls - (see section 10.9 and section 10.10). + (see section 10.9 and section 10.10). @@ -1302,7 +1302,7 @@ The effects of the attributes of the MouseKeysAccel control depend on whether the XkbSA_MovePtr - action (see section 16.1) specifies relative or absolute pointer motion. + action (see section 16.1) specifies relative or absolute pointer motion. @@ -1503,7 +1503,7 @@ Enabling or disabling the keyboard controls through a graphical user interface may be impossible for people who need to use the controls. For example, a user who needs SlowKeys - (see section 10.6.6) may not even be able to start the graphical application, + (see section 10.6.6) may not even be able to start the graphical application, let alone use it, if SlowKeys is not enabled. To allow easier access to some of the controls, the @@ -1556,9 +1556,9 @@ When the Some of these key sequences optionally generate audible feedback of the change -in state, as described in section 10.6.3, or +in state, as described in section 10.6.3, or XkbControlsNotify - events, described in section 10.11. + events, described in section 10.11. @@ -1590,7 +1590,7 @@ When a timeout as specified by XkbControlsNotify event. For more information on XkbControlsNotify - events, refer to section 10.11. + events, refer to section 10.11. @@ -1711,7 +1711,7 @@ The parameters ax_options, which is a field in the XkbControlsRec - structure (see section 10.8). + structure (see section 10.8). XkbGetAccessXTimeout returns True @@ -1845,7 +1845,7 @@ for the ax_options field of an XkbDescRec - (see section 10.8). + (see section 10.8). @@ -1887,7 +1887,7 @@ on or off by modifying the following bits in the XkbControlsRec structure and using XkbSetControls - (see section 10.10): + (see section 10.10):
@@ -2000,7 +2000,7 @@ pitch. In these cases, use the When any of the above feedbacks occur, Xkb may generate a XkbBellNotify - event (see section 9.4). + event (see section 9.4). @@ -2113,7 +2113,7 @@ To receive XkbAccessXNotify events under all possible conditions, use XkbSelectEvents - (see section 4.3) and pass + (see section 4.3) and pass XkbAccesXNotifyMask in both bits_to_change @@ -2219,7 +2219,7 @@ locking, or unlocking of modifiers using KeyRelease events, though the auto-repeat can be detected using DetectableAutorepeat - (see section 10.3.3). Finally, + (see section 10.3.3). Finally, MouseKeys generates pointer events identical to those of the core pointer device. @@ -2253,7 +2253,7 @@ When the acceptance or rejection, and release of any key to interested clients by sending an appropriate AccessXNotify - event (see section 10.6.4). + event (see section 10.6.4). @@ -2433,7 +2433,7 @@ When the control is active, the server reports acceptance or rejection of any key to interested clients by sending an appropriate AccessXNotify - event (see section 10.6.4). + event (see section 10.6.4). @@ -3018,10 +3018,10 @@ There are no convenience functions for manipulating the XkbSetControls and XkbGetControls - (see section 10.9 and section 10.10) to query and change this control. + (see section 10.9 and section 10.10) to query and change this control. -See also section 15.3.2 or a discussion of the related field, +See also section 15.3.2 or a discussion of the related field, group_info, which also normalizes a group under certain circumstances. @@ -3060,7 +3060,7 @@ Manipulate the XkbSetControls and XkbGetControls - (see section 10.9 and section 10.10) to query and change this control. Alternatively, + (see section 10.9 and section 10.10) to query and change this control. Alternatively, use XkbSetIgnoreLockMods. @@ -3205,7 +3205,7 @@ be added and removed from the server’s are removed from the server’s IgnoreLockMods control. -See section 7.1 for a discussion of virtual modifier masks to use in +See section 7.1 for a discussion of virtual modifier masks to use in affect_virtual and virtual_values. @@ -3233,7 +3233,7 @@ passive grabs. Because IgnoreGroupLock is a boolean control with no attributes, use the general boolean controls -functions (see section 10.1) to change its state. +functions (see section 10.1) to change its state. @@ -3404,7 +3404,7 @@ selected by both but not by virtual_values are removed from the server’s internal modifiers control. -See section 7.1 for a discussion of virtual modifier masks to use in +See section 7.1 for a discussion of virtual modifier masks to use in affect_virtual and virtual_values. @@ -3882,7 +3882,7 @@ computed automatically by the server whenever the keyboard mapping changes. groups_wrap is an attribute of the GroupsWrap - control (see section 10.7.1). It specifies the handling of illegal groups on a + control (see section 10.7.1). It specifies the handling of illegal groups on a global basis. Valid values for groups_wrap are shown in Table 10.8. @@ -3934,7 +3934,7 @@ its four low-order bits specify the index of the group to use. internal is an attribute of the InternalMods - control (see section 10.7.4). It specifies modifiers to be consumed in the + control (see section 10.7.4). It specifies modifiers to be consumed in the server and not passed on to clients when events are reported. Valid values consist of any combination of the eight core modifier bits: ShiftMask, @@ -3954,7 +3954,7 @@ consist of any combination of the eight core modifier bits: ignore_lock is an attribute of the IgnoreLockMods - control (see section 10.7.2). It specifies modifiers to be ignored in grab + control (see section 10.7.2). It specifies modifiers to be ignored in grab calculations. Valid values consist of any combination of the eight core modifier bits: ShiftMask, @@ -3974,7 +3974,7 @@ modifier bits: enabled_ctrls is an attribute of the EnabledControls - control (see section 10.1.1). It contains one bit per boolean control. Each + control (see section 10.1.1). It contains one bit per boolean control. Each bit determines whether the corresponding control is enabled or disabled; a one bit means the control is enabled. The mask bits used to enable these controls are listed in Table 10.7, @@ -3994,7 +3994,7 @@ using only those masks with "ok" in the repeat_interval are attributes of the RepeatKeys - control (see section 10.3.2). + control (see section 10.3.2). repeat_delay is the initial delay before a key begins repeating, in milliseconds; repeat_interval @@ -4010,7 +4010,7 @@ repeat_delay slow_keys_delay is an attribute of the SlowKeys - control (see section 10.6.6). Its value specifies the + control (see section 10.6.6). Its value specifies the SlowKeys acceptance delay period in milliseconds before a key press is accepted by the server. @@ -4025,7 +4025,7 @@ server. debounce_delay is an attribute of the BounceKeys - control (see section 10.6.7). Its value specifies the + control (see section 10.6.7). Its value specifies the BounceKeys delay period in milliseconds for which the key is disabled after having been pressed before another press of the same key is accepted by the server. @@ -4045,7 +4045,7 @@ and mk_curve are attributes of the MouseKeysAccel - control. Refer to section 10.5.2 for a description of these fields and the + control. Refer to section 10.5.2 for a description of these fields and the units involved. @@ -4059,9 +4059,9 @@ The ax_options field contains attributes used to configure two different controls, the StickyKeys - control (see section 10.6.8) and the + control (see section 10.6.8) and the AccessXFeedback - control (see section 10.6.3). The + control (see section 10.6.3). The ax_options field is a bitmask and may include any combination of the bits defined in Table 10.9. @@ -4263,7 +4263,7 @@ and axt_ctrls_values are attributes of the AccessXTimeout - control. Refer to section 10.6.2 for a description of these fields and the + control. Refer to section 10.6.2 for a description of these fields and the units involved. @@ -4563,7 +4563,7 @@ the corresponding values are still updated in the X server. For example, the set in enabled_ctrls ). It is permissible to modify the attributes of a control in one call to -XkbSetControls and enable the control in a subsequent call. See section 10.1.1 +XkbSetControls and enable the control in a subsequent call. See section 10.1.1 for more information on enabling and disabling controls. @@ -4585,7 +4585,7 @@ Because this is somewhat awkward if all you want to do is enable and disable controls, and not modify any of their attributes, a convenience function is also provided for this purpose ( XkbChangeEnabledControls, -section 10.1.1). +section 10.1.1). @@ -5001,7 +5001,7 @@ results into the ctrls field, use XkbFreeControls - (see section 10.12). + (see section 10.12). diff --git a/specs/XKB/ch14.xml b/specs/XKB/ch14.xml index 11fa9c0f..8ebab299 100644 --- a/specs/XKB/ch14.xml +++ b/specs/XKB/ch14.xml @@ -194,14 +194,14 @@ type and specifies the modifier combinations necessary to access each level. For example, Xkb allows key types where the Control modifier can be used to access the shift level two of a key. Key types are in -the client map component and are described in detail in section 15.2. +the client map component and are described in detail in section 15.2. Xkb provides precise specification of the behavior of a key using key behaviors. Key behaviors are in the server map component and are described in -detail in section 16.2. +detail in section 16.2. diff --git a/specs/XKB/ch17.xml b/specs/XKB/ch17.xml index e003a919..f627e8f7 100644 --- a/specs/XKB/ch17.xml +++ b/specs/XKB/ch17.xml @@ -136,7 +136,7 @@ contained in an structure; plus a set of explicit override controls used to prevent particular components of type 2 (core-to-Xkb keyboard mapping) transformations from automatically occurring. These explicit override controls are maintained in a -separate data structure discussed in section 16.3. +separate data structure discussed in section 16.3.