From b33b8d8ae86876b50df96881b96074b3fe177cce Mon Sep 17 00:00:00 2001 From: marha Date: Mon, 28 Jul 2014 21:19:00 +0200 Subject: plink fontconfig libX11 libXext xserver xkeyboard-config mesa git update 28 July 2014 xserver commit 4afedf545b673282f2e214c0e2c759c9be9b9a2a xkeyboard-config commit 9010f6c0745f472b670c22340b5bbd36e33ce37e libX11 commit 0885cad1e4a9ed57266582be320be55259c881bf libXext commit efdcbb7634501e1117d422636a0a75d7ea84b16b fontconfig commit a9e7b0494e04b3925d1bccc140ff2500cfff9618 mesa commit cc1e1da24a6c535617d9fb38858d48d8c2999e68 plink revision 10211 --- libX11/specs/XKB/ch06.xml | 464 ++++++++++++++++++++++------------------------ 1 file changed, 226 insertions(+), 238 deletions(-) (limited to 'libX11/specs/XKB/ch06.xml') diff --git a/libX11/specs/XKB/ch06.xml b/libX11/specs/XKB/ch06.xml index 422e6d23b..b3b58da28 100644 --- a/libX11/specs/XKB/ch06.xml +++ b/libX11/specs/XKB/ch06.xml @@ -1,3 +1,6 @@ + + Complete Keyboard Description @@ -11,73 +14,64 @@ document that discuss the major Xkb components in detail. The XkbDescRec Structure + +XkbDescRec + -The complete description of an Xkb keyboard is given by an -XkbDescRec -. The component structures in the -XkbDescRec - represent the major Xkb components outlined in Figure 1.1. +The complete description of an Xkb keyboard is given by an +XkbDescRec. +The component structures in the +XkbDescRec +represent the major Xkb components outlined in Figure 1.1. typedef struct { - struct _XDisplay * display; /* connection to -X server */ - unsigned short flags; /* private to Xkb, do -not modify */ - unsigned short device_spec; /* device of -interest */ - KeyCode min_key_code; /* minimum keycode for -device */ - KeyCode max_key_code; /* maximum keycode for -device */ - XkbControlsPtr ctrls; /* controls */ - XkbServerMapPtr server; /* server keymap */ - XkbClientMapPtr map; /* client keymap */ - XkbIndicatorPtr indicators; /* indicator map -*/ - XkbNamesPtr names; /* names for all -components */ - XkbCompatMapPtr compat; /* compatibility map -*/ - XkbGeometryPtr geom; /* physical geometry of -keyboard */ -} -XkbDescRec -, *XkbDescPtr; + struct _XDisplay * display; /* connection to X server */ + unsigned short flags; /* private to Xkb, do not modify */ + unsigned short device_spec; /* device of interest */ + KeyCode min_key_code; /* minimum keycode for device */ + KeyCode max_key_code; /* maximum keycode for device */ + XkbControlsPtr ctrls; /* controls */ + XkbServerMapPtr server; /* server keymap */ + XkbClientMapPtr map; /* client keymap */ + XkbIndicatorPtr indicators; /* indicator map */ + XkbNamesPtr names; /* names for all components */ + XkbCompatMapPtr compat; /* compatibility map */ + XkbGeometryPtr geom; /* physical geometry of keyboard */ +} XkbDescRec, *XkbDescPtr; -The -display - field points to an X display structure. The -flags - field is private to the library: modifying -flags - may yield unpredictable results. The -device_spec - field specifies the device identifier of the keyboard input device, or - -XkbUseCoreKeyboard -, which specifies the core keyboard device. The -min_key_code - and -max_key_code - fields specify the least and greatest keycode that can be returned by the +The +display +field points to an X display structure. The +flags +field is private to the library: modifying +flags +may yield unpredictable results. The +device_spec +field specifies the device identifier of the keyboard input device, or +XkbUseCoreKbd, +which specifies the core keyboard device. The +min_key_code +and +max_key_code +fields specify the least and greatest keycode that can be returned by the keyboard. The other fields specify structure components of the keyboard description and -are described in detail in other sections of this document. Table 6.1 +are described in detail in other sections of this document. +Table 6.1 identifies the subsequent sections of this document that discuss the individual -components of the -XkbDescRec -. +components of the +XkbDescRec. - +
XkbDescRec Component References @@ -92,31 +86,31 @@ XkbDescRec ctrls - Chapter 10 + server - Chapter 16 + map - Chapter 15 + indicators - Chapter 8 + names - Chapter 18 + compat - Chapter 17 + geom - Chapter 13 + @@ -126,12 +120,12 @@ XkbDescRec Each structure component has a corresponding mask bit that is used in function calls to indicate that the structure should be manipulated in some manner, such as allocating it or freeing it. These masks and their relationships to the -fields in the -XkbDescRec - are shown in Table 6.2. +fields in the +XkbDescRec +are shown in Table 6.2. -
+
Mask Bits for XkbDescRec @@ -147,12 +141,12 @@ XkbDescRec - XkbControlsMask + XkbControlsMask ctrls (1L<<0) - XkbServerMapMask + XkbServerMapMask server (1L<<1) @@ -162,27 +156,27 @@ XkbDescRec(1L<<2) - XkbIndicatorMapMask + XkbIndicatorMapMask indicators (1L<<3) - XkbNamesMask + XkbNamesMask names (1L<<4) - XkbCompatMapMask + XkbCompatMapMask compat (1L<<5) - XkbGeometryMask + XkbGeometryMask geom (1L<<6) - XkbAllComponentsMask + XkbAllComponentsMask All Fields (0x7f) @@ -196,86 +190,88 @@ XkbDescRec To retrieve one or more components of a keyboard device description, use - -XkbGetKeyboard - (see also -XkbGetKeyboardbyName -). +XkbGetKeyboard +(see also +XkbGetKeyboardByName). + - - - - - - - -XkbDescPtr -XkbGetKeyboard -( -display, which, device_spec -) - - - - -Display * - display -; /* connection to X server */ - - - - -unsigned int -which -; /* mask indicating components to return */ - - - - -unsigned int - device_spec -; /* device for which to fetch description, or -XkbUseCoreKbd - */ - - - - - +XkbGetKeyboard + + + XkbDescPtr XkbGetKeyboard + + + Display *display + unsigned int which + unsigned int device_spec + + + + + + display + + + + connection to X server + + + + + + which + + + + mask indicating components to return + + + + + + device_spec + + + + device for which to fetch description, or +XkbUseCoreKbd + + + + - -XkbGetKeyboard +XkbGetKeyboard allocates and returns a pointer to a keyboard description. It queries the -server for those components specified in the -which - parameter for device -device_spec - and copies the results to the -XkbDescRec - it allocated. The remaining fields in the keyboard description are set to - -NULL -. The valid masks for -which - are those listed in Table 6.2. +server for those components specified in the +which +parameter for device +device_spec +and copies the results to the +XkbDescRec +it allocated. The remaining fields in the keyboard description are set to +NULL. +The valid masks for +which +are those listed in Table 6.2. - -XkbGetKeyboard - can generate -BadAlloc - protocol errors. +XkbGetKeyboard +can generate +BadAlloc +protocol errors. -To free the returned keyboard description, use -XkbFreeKeyboard - (see section 6.4). +To free the returned keyboard description, use +XkbFreeKeyboard +(see section 6.4). @@ -285,7 +281,7 @@ XkbFreeKeyboard 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. @@ -296,122 +292,114 @@ tracking changes to the keyboard description. Applications seldom need to directly allocate a keyboard description; calling - -XkbGetKeyboard - usually suffices. In the event you need to create a keyboard description from -scratch, however, use -XkbAllocKeyboard - rather than directly calling -malloc -or -Xmalloc -. +XkbGetKeyboard +usually suffices. In the event you need to create a keyboard description from +scratch, however, use +XkbAllocKeyboard +rather than directly calling +malloc +or +Xmalloc. - - - - - - - -XkbDescRec * -XkbAllocKeyboard -(void) - - - - - +XkbAllocKeyboard + + + XkbDescRec *XkbAllocKeyboard + + + + -If -XkbAllocKeyboard - fails to allocate the keyboard description, it returns -NULL -. Otherwise, it returns a pointer to an empty keyboard description structure. -The -device_spec - field will have been initialized to -XkbUseCoreKbd -. You may then either fill in the structure components or use Xkb functions to +If +XkbAllocKeyboard +fails to allocate the keyboard description, it returns +NULL. +Otherwise, it returns a pointer to an empty keyboard description structure. +The +device_spec +field will have been initialized to +XkbUseCoreKbd. +You may then either fill in the structure components or use Xkb functions to obtain values for the structure components from a keyboard device. -To destroy either an entire an -XkbDescRec - or just some of its members, use -XkbFreeKeyboard. +To destroy either an entire an +XkbDescRec +or just some of its members, use +XkbFreeKeyboard. - - - - - - - -void -XkbFreeKeyboard - -(xkb, which, free_all -) - - - - -XkbDescPtr - xkb -; /* keyboard description with components to free */ - - - - -unsigned int - which -; /* mask selecting components to free */ - - - - -Bool - free_all -; /* -True - => free all components and -xkb - */ - - - - - +XkbFreeKeyboard + + + void XkbFreeKeyboard + + + XkbDescPtr xkb + unsigned int which + Bool free_all + + + + + + xkb + + + + keyboard description with components to free + + + + + + which + + + + mask selecting components to free + + + + + + free_all + + + + True ⇒ free all components and xkb + + + + - -XkbFreeKeyboard - frees the components of -xkb - specified by -which - and sets the corresponding values to -NULL -. If -free_all - is -True -, -XkbFreeKeyboard - frees every non- -NULL - component of -xkb - and then frees the -xkb - structure itself. +XkbFreeKeyboard +frees the components of +xkb +specified by +which +and sets the corresponding values to +NULL. +If +free_all +is +True, +XkbFreeKeyboard +frees every non- +NULL +component of +xkb +and then frees the +xkb +structure itself. -- cgit v1.2.3