From 45e3694d529b052f4122262c9bdff5476219b2b4 Mon Sep 17 00:00:00 2001 From: marha Date: Mon, 23 Jan 2012 08:33:10 +0100 Subject: git update libX11 mesa libxcb xkeyboard-config 23 jan 2012 --- libX11/specs/XKB/ch10.xml | 727 ++++++++++++++++++++++++---------------------- 1 file changed, 383 insertions(+), 344 deletions(-) (limited to 'libX11/specs/XKB/ch10.xml') diff --git a/libX11/specs/XKB/ch10.xml b/libX11/specs/XKB/ch10.xml index 97ce484e1..b7f306938 100644 --- a/libX11/specs/XKB/ch10.xml +++ b/libX11/specs/XKB/ch10.xml @@ -56,131 +56,132 @@ XkbControlsRec The Xkb controls are grouped as shown in Table 10.1. - +
Xkb Keyboard Controls - - - - + + + + + - + Type of Control Control Name Boolean Control? - + Controls for enabling and disabling other controls EnabledControls No - + AutoReset No - + Control for bell behavior AudibleBell Boolean - + Controls for repeat key behavior PerKeyRepeat No - + RepeatKeys Boolean - + DetectableAutorepeat Boolean - + Controls for keyboard overlays Overlay1 Boolean - + Overlay2 Boolean - + Controls for using the mouse from the keyboard MouseKeys Boolean - + MouseKeysAccel Boolean - + Controls for better keyboard access by AccessXFeedback Boolean - + physically impaired persons AccessXKeys Boolean - + AccessXTimeout Boolean - + BounceKeys Boolean - + SlowKeys Boolean - + StickyKeys Boolean - + Controls for general keyboard mapping GroupsWrap No - + IgnoreGroupLock Boolean - + IgnoreLockMods No - + InternalMods No - + Miscellaneous per-client controls GrabsUseXKBState Boolean - + LookupStateWhenGrabbed Boolean - + SendEventUsesXKBState Boolean @@ -237,10 +238,11 @@ EnabledControls - - + + + - + Bool XkbChangeEnabledControls @@ -255,28 +257,28 @@ mask ) - + Display * dpy ; /* connection to X server */ - + unsigned int device_spec ; /* keyboard device to modify */ - + unsigned int mask ; /* 1 bit -> controls to enable / disable */ - + unsigned int values @@ -378,10 +380,11 @@ XkbGetAutoResetControls - - + + + - + Bool XkbGetAutoResetControls @@ -394,14 +397,14 @@ auto_values ) - + Display * dpy ; /* connection to X server */ - + unsigned int * auto_ctrls @@ -410,7 +413,7 @@ auto_values are relevant */ - + unsigned int * auto_values @@ -447,10 +450,11 @@ XkbSetAutoResetControls. - - + + + - + Bool XkbSetAutoResetControls @@ -465,28 +469,28 @@ auto_values ) - + Display * dpy ; /* connection to X server */ - + unsigned int changes ; /* controls for which to change auto-reset values */ - + unsigned int * auto_ctrls ; /* controls from changes that should auto reset */ - + unsigned int * auto_values @@ -710,10 +714,11 @@ XkbGetAutoRepeatRate - - + + + - + Bool XkbGetAutoRepeatRate @@ -722,14 +727,14 @@ display, device_spec, timeout_rtrn, interval_rtrn ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -738,14 +743,14 @@ XkbUseCoreKbd */ - + unsigned int * timeout_rtrn ; /* backfilled with initial repeat delay, ms */ - + unsigned int * interval_rtrn @@ -785,10 +790,11 @@ XkbSetAutoRepeatRate - - + + + - + Bool XkbSetAutoRepeatRate @@ -797,14 +803,14 @@ display, device_spec, timeout, interval ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -813,14 +819,14 @@ XkbUseCoreKbd */ - + unsigned int timeout ; /* initial delay, ms */ - + unsigned int interval @@ -947,10 +953,11 @@ XkbGetDetectableAutorepeat - - + + + - + Bool XkbGetDetectableAutorepeat @@ -959,14 +966,14 @@ display, supported_rtrn ) - + Display * display ; /* connection to X server */ - + Bool * supported_rtrn @@ -1022,10 +1029,11 @@ they have requested otherwise. - - + + + - + Bool XkbSetDetectableAutorepeat @@ -1034,14 +1042,14 @@ display, detectable, supported_rtrn ) - + Display * display ; /* connection to X server */ - + Bool detectable @@ -1052,7 +1060,7 @@ DetectableAutorepeat */ - + Bool * supported_rtrn @@ -1244,37 +1252,38 @@ XkbControlsRec structure (see section 10.8). -
+
MouseKeysAccel Fields - - - + + + + - + Field Function - + mk_delay Time (ms) between the initial key press and the first repeated motion event - + mk_interval Time (ms) between repeated motion events - + mk_time_to_max Number of events (count) before the pointer reaches maximum speed - + mk_max_speed The maximum speed (in pixels per event) the pointer reaches - + mk_curve The ramp used to reach maximum pointer speed @@ -1602,10 +1611,11 @@ AccessXTimeout - - + + + - + Bool XkbGetAccessXTimeout @@ -1624,14 +1634,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -1640,28 +1650,28 @@ XkbUseCoreKbd */ - + unsigned short * timeout_rtrn ; /* delay until AccessXTimeout, seconds */ - + unsigned int * ctrls_mask_rtrn ; /* backfilled with controls to modify */ - + unsigned int * ctrls_values_rtrn ; /* backfilled with on/off status for controls */ - + unsigned short * opts_mask_rtrn @@ -1670,7 +1680,7 @@ ax_options to modify */ - + unsigned short * opts_values_rtrn @@ -1725,10 +1735,11 @@ XkbSetAccessXTimeout - - + + + - + Bool XkbSetAccessXTimeout @@ -1740,14 +1751,14 @@ opts_values ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -1756,21 +1767,21 @@ XkbUseCoreKbd */ - + unsigned short timeout ; /* seconds idle until AccessXTimeout occurs */ - + unsigned int ctrls_mask ; /* boolean controls to modify */ - + unsigned int ctrls_values @@ -1779,7 +1790,7 @@ ctrls_mask */ - + unsigned short opts_mask @@ -1788,7 +1799,7 @@ ax_options to change */ - + unsigned short opts_values @@ -1875,91 +1886,92 @@ XkbSetControls (see section 10.10): -
+
AccessXFeedback Masks - - - - + + + + + - + Action Beep Code ax_options bit - + LED turned on High-pitched beep XkbAX_IndicatorFBMask - + LED turned off Low-pitched beep XkbAX_IndicatorFBMask - + More than one LED changed state Two high-pitched beeps XkbAX_IndicatorFBMask - + Control turned on Rising tone XkbAX_FeatureFBMask - + Control turned off Falling tone XkbAX_FeatureFBMask - + More than one control changed state Two high-pitched beeps XkbAX_FeatureFBMask - + SlowKeys and BounceKeys about to be turned on or off Three high-pitched beeps XkbAX_SlowWarnFBMask - + SlowKeys key pressed Medium-pitched beep XkbAX_SKPressFBMask - + SlowKeys key accepted Medium-pitched beep XkbAX_SKAcceptFBMask - + SlowKeys key rejected Low-pitched beep XkbAX_SKRejectFBMask - + Accepted SlowKeys key released Medium-pitched beep XkbAX_SKReleaseFBMask - + BounceKeys key rejected Low-pitched beep XkbAX_BKRejectFBMask - + StickyKeys key latched Low-pitched beep followed by high-pitched beep XkbAX_StickyKeysFBMask - + StickyKeys key locked High-pitched beep XkbAX_StickyKeysFBMask - + StickyKeys key unlocked Low-pitched beep XkbAX_StickyKeysFBMask @@ -2024,45 +2036,46 @@ detail in Table 10.4. -
+
AccessXNotify Events - - - + + + + - + detail Reason - + XkbAXN_SKPress A key was pressed when SlowKeys was enabled. - + XkbAXN_SKAccept A key was accepted (held longer than the SlowKeys delay). - + XkbAXN_SKRelease An accepted SlowKeys key was released. - + XkbAXN_SKReject A key was rejected (released before the SlowKeys delay expired). - + XkbAXN_BKAccept A key was accepted by BounceKeys. - + XkbAXN_BKReject A key was rejected (pressed before the BounceKeys delay expired). - + XkbAXN_AXKWarning AccessXKeys is about to turn on/off StickyKeys or BounceKeys. @@ -2123,56 +2136,57 @@ values_for_bits using mask bits from Table 10.5. -
+
AccessXNotify Event Details - - - - + + + + + - + XkbAccessXNotify Event Details Value Circumstances - + XkbAXN_SKPressMask (1<<0) Slow key press notification wanted - + XkbAXN_SKAcceptMask (1<<1) Slow key accept notification wanted - + XkbAXN_SKRejectMask (1<<2) Slow key reject notification wanted - + XkbAXN_SKReleaseMask (1<<3) Slow key release notification wanted - + XkbAXN_BKAcceptMask (1<<4) Bounce key accept notification wanted - + XkbAXN_BKRejectMask (1<<5) Bounce key reject notification wanted - + XkbAXN_AXKWarningMask (1<<6) AccessX warning notification wanted - + XkbAXN_AllEventsMask (0x7f) All AccessX features notifications wanted @@ -2250,10 +2264,11 @@ XkbGetSlowKeysDelay - - + + + - + Bool XkbGetSlowKeysDelay @@ -2266,14 +2281,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -2282,7 +2297,7 @@ XkbUseCoreKbd */ - + unsigned int * delay_rtrn @@ -2327,10 +2342,11 @@ XkbSetSlowKeysDelay - - + + + - + Bool XkbSetSlowKeysDelay @@ -2343,14 +2359,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -2359,7 +2375,7 @@ XkbUseCoreKbd */ - + unsigned int delay @@ -2435,10 +2451,11 @@ BounceKeys - - + + + - + Bool XkbGetBounceKeysDelay @@ -2451,14 +2468,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -2467,7 +2484,7 @@ XkbUseCoreKbd */ - + unsigned int * delay_rtrn @@ -2512,10 +2529,11 @@ XkbSetBounceKeysDelay - - + + + - + Bool XkbSetBounceKeysDelay @@ -2528,14 +2546,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -2544,7 +2562,7 @@ XkbUseCoreKbd */ - + unsigned int delay @@ -2735,10 +2753,11 @@ StickyKeys - - + + + - + Bool XkbGetStickyKeysOptions @@ -2751,14 +2770,14 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec @@ -2767,7 +2786,7 @@ XkbUseCoreKbd */ - + unsigned int * options_rtrn @@ -2823,10 +2842,11 @@ XkbSetStickyKeysOptions - - + + + - + Bool XkbSetStickyKeysOptions @@ -2837,28 +2857,28 @@ display ) - + Display * display ; /* connection to X server */ - + unsigned int device_spec ; /* device to configure, or XkbUseCoreKbd */ - + unsigned int mask ; /* selects StickyKeys attributes to modify */ - + unsigned int values; @@ -3067,10 +3087,11 @@ XkbSetIgnoreLockMods. - - + + + - + Bool XkbSetIgnoreLockMods @@ -3080,14 +3101,14 @@ virtual_values ) - + Display * display ; /* connection to the X server */ - + unsigned int device_spec @@ -3096,28 +3117,28 @@ XkbUseCoreKbd */ - + unsigned int affect_real ; /* mask of real modifiers affected by this call */ - + unsigned int real_values ; /* values for affected real modifiers (1=>set, 0=>unset) */ - + unsigned int affect_virtual ; /* mask of virtual modifiers affected by this call */ - + unsigned int virtual_values @@ -3268,10 +3289,11 @@ XkbSetServerInternalMods. - - + + + - + Bool XkbSetServerInternalMods @@ -3281,14 +3303,14 @@ virtual_values ) - + Display * display ; /* connection to the X server */ - + unsigned int device_spec @@ -3297,28 +3319,28 @@ XkbUseCoreKbd */ - + unsigned int affect_real ; /* mask of real modifiers affected by this call */ - + unsigned int real_values ; /* values for affected real modifiers (1=>set, 0=>unset) */ - + unsigned int affect_virtual ; /* mask of virtual modifiers affected by this call */ - + unsigned int virtual_values @@ -3470,12 +3492,17 @@ bit used to turn boolean controls on and off and the section where each control is described in more detail. -
+
Xkb Controls - - + + + + + + + - + Control Control Selection Mask (which parameter) Relevant XkbControlsRec Data Fields @@ -3484,21 +3511,21 @@ is described in more detail. - + AccessXFeedback XkbAccessXFeedbackMask ax_options: XkbAX_*FBMask - XkbAccessXFeedbackMask + XkbAccessXFeedback­Mask 10.6.3 - + AccessXKeys - XkbAccessXKeysMask + XkbAccessXKeys­Mask 10.6.1 - + AccessXTimeout XkbAccessXTimeoutMask @@ -3508,80 +3535,80 @@ is described in more detail. axt_ctrls_mask axt_ctrls_values - XkbAccessXTimeoutMask + XkbAccessXTimeout­Mask 10.6.2 - + AudibleBell XkbAudibleBellMask 9.2 - + AutoReset 10.1.2 - + BounceKeys XkbBounceKeysMask debounce_delay XkbBounceKeysMask 10.6.7 - + Detectable-Autorepeat 10.3.3 - + EnabledControls XkbControlsEnabledMask enabled_ctrls Non-Boolean Control 10.1.1 - + GroupsWrap XkbGroupsWrapMask groups_wrap Non-Boolean Control 10.7.1 - + IgnoreGroupLock - XkbIgnoreGroupLockMask + XkbIgnoreGroupLock­Mask 10.7.3 - + IgnoreLockMods XkbIgnoreLockModsMask ignore_lock Non-Boolean Control 5.1 - + InternalMods XkbInternalModsMask internal Non-Boolean Control 5.1 - + MouseKeys XkbMouseKeysMask mk_dflt_btn XkbMouseKeysMask 10.5.1 - + MouseKeysAccel XkbMouseKeysAccelMask @@ -3591,31 +3618,31 @@ is described in more detail. mk_max_speed mk_curve - XkbMouseKeysAccelMask + XkbMouseKeysAccel­Mask 10.5.2 - + Overlay1 XkbOverlay1Mask 10.4 - + Overlay2 XkbOverlay2Mask 10.4 - + PerKeyRepeat XkbPerKeyRepeatMask per_key_repeat Non-Boolean Control 10.3.1 - + RepeatKeys XkbRepeatKeysMask @@ -3625,20 +3652,20 @@ is described in more detail. XkbRepeatKeysMask 10.3 - + SlowKeys XkbSlowKeysMask slow_keys_delay XkbSlowKeysMask 10.6.6 - + StickyKeys XkbStickyKeysMask ax_options: - XkbAX_TwoKeysMask - XkbAX_LatchToLockMask + XkbAX_Two­KeysMask + XkbAX_Latch­ToLockMask XkbStickyKeysMask 10.6.8 @@ -3660,15 +3687,16 @@ configurable attributes; and for controls that are not boolean controls and therefore cannot be enabled or disabled. -
+
Controls Mask Bits - - - - - + + + + + + - + Mask Bit which or changed_ctrls enabled_ctrls @@ -3676,127 +3704,127 @@ therefore cannot be enabled or disabled. - + XkbRepeatKeysMask ok ok (1L<<0) - + XkbSlowKeysMask ok ok (1L<<1) - + XkbBounceKeysMask ok ok (1L<<2) - + XkbStickyKeysMask ok ok (1L<<3) - + XkbMouseKeysMask ok ok (1L<<4) - + XkbMouseKeysAccelMask ok ok (1L<<5) - + XkbAccessXKeysMask ok ok (1L<<6) - + XkbAccessXTimeoutMask ok ok (1L<<7) - + XkbAccessXFeedbackMask ok ok (1L<<8) - + XkbAudibleBellMask ok (1L<<9) - + XkbOverlay1Mask ok (1L<<10) - + XkbOverlay2Mask ok (1L<<11) - + XkbIgnoreGroupLockMask ok (1L<<12) - + XkbGroupsWrapMask ok (1L<<27) - + XkbInternalModsMask ok (1L<<28) - + XkbIgnoreLockModsMask ok (1L<<29) - + XkbPerKeyRepeatMask ok (1L<<30) - + XkbControlsEnabledMask ok (1L<<31) - + XkbAccessXOptionsMask ok ok (XkbStickyKeysMask | XkbAccessXFeedbackMask) - + XkbAllBooleanCtrlsMask ok (0x00001FFF) - + XkbAllControlsMask ok @@ -3865,27 +3893,28 @@ groups_wrap are shown in Table 10.8. -
+
GroupsWrap options (groups_wrap field) - - - + + + + - + groups_wrap symbolic name value - + XkbWrapIntoRange (0x00) - + XkbClampIntoRange (0x40) - + XkbRedirectIntoRange (0x80) @@ -4061,81 +4090,82 @@ ax_options Table 10.9. -
+
Access X Enable/Disable Bits (ax_options field) - - - - + + + + + - + Access X Control ax_options bit value - + AccessXFeedback XkbAX_SKPressFBMask (1L<<0) - + XkbAX_SKAcceptFBMask (1L << 1) - + XkbAX_FeatureFBMask (1L << 2) - + XkbAX_SlowWarnFBMask (1L << 3) - + XkbAX_IndicatorFBMask (1L << 4) - + XkbAX_StickyKeysFBMask (1L << 5) - + XkbAX_SKReleaseFBMask (1L << 8) - + XkbAX_SKRejectFBMask (1L << 9) - + XkbAX_BKRejectFBMask (1L << 10) - + XkbAX_DumbBellFBMask (1L << 11) - + StickyKeys XkbAX_TwoKeysMask (1L << 6) - + XkbAX_LatchToLockMask (1L << 7) - + XkbAX_AllOptionsMask (0xFFF) @@ -4313,10 +4343,11 @@ XkbGetControls - - + + + - + Status XkbGetControls @@ -4324,21 +4355,21 @@ XkbGetControls display, which, xkb) - + Display * display ; /* connection to X server */ - + unsigned long which ; /* mask of controls requested */ - + XkbDescPtr xkb @@ -4467,10 +4498,11 @@ XkbSetControls - - + + + - + Bool XkbSetControls @@ -4478,21 +4510,21 @@ XkbSetControls display, which, xkb) - + Display * display ; /* connection to X server */ - + unsigned long which ; /* mask of controls to change */ - + XkbDescPtr xkb @@ -4649,10 +4681,11 @@ match those in the changed keyboard description. - - + + + - + Bool XkbChangeControls @@ -4661,14 +4694,14 @@ dpy, xkb, changes ) - + Display * dpy ; /* connection to X server */ - + XkbDescPtr xkb @@ -4677,7 +4710,7 @@ xkb->ctrls */ - + XkbControlsChangesPtr changes @@ -4863,10 +4896,11 @@ XkbNoteControlsChanges - - + + + - + void XkbNoteControlsChanges @@ -4879,21 +4913,21 @@ changes ) - + XkbControlsChangesPtr changes ; /* records changes indicated by new */ - + XkbControlsNotifyEvent * new ; /* tells which things have changed */ - + unsigned int wanted @@ -4932,10 +4966,11 @@ XkbNoteControlsChanges. - - + + + - + Status XkbGetControlsChanges @@ -4948,14 +4983,14 @@ dpy ) - + Display * dpy ; /* connection to X server */ - + XkbDescPtr xkb @@ -4964,7 +4999,7 @@ xkb->ctrls will be updated */ - + XkbNameChangesPtr changes @@ -5037,10 +5072,11 @@ XkbAllocControls - - + + + - + Status XkbAllocControls @@ -5049,14 +5085,14 @@ xkb, which ) - + XkbDescPtr xkb ; /* Xkb description in which to allocate ctrls rec */ - + unsigned int which @@ -5124,10 +5160,11 @@ XkbFreeControls: - - + + + - + void XkbFreeControls @@ -5136,14 +5173,14 @@ xkb, which, free_all ) - + XkbDescPtr xkb ; /* Xkb description in which to free controls components */ - + unsigned int which @@ -5152,7 +5189,7 @@ ctrls to free */ - + Bool free_all @@ -5227,10 +5264,11 @@ XkbGetPerClientControls - - + + + - + Bool XkbGetPerClientControls @@ -5241,14 +5279,14 @@ ctrls ) - + Display * dpy ; /* connection to X server */ - + unsigned int * ctrls @@ -5283,10 +5321,11 @@ XkbSetPerClientControls. - - + + + - + Bool XkbSetPerClientControls @@ -5297,21 +5336,21 @@ ctrls ) - + Display * dpy ; /* connection to X server */ - + unsigned int change ; /* 1 bit => change control */ - + unsigned int * value -- cgit v1.2.3