diff --git a/specs/XKB/ch10.xml b/specs/XKB/ch10.xml index d4b57536..5604048c 100644 --- a/specs/XKB/ch10.xml +++ b/specs/XKB/ch10.xml @@ -2393,7 +2393,7 @@ To set the It does not wait for a reply, and normally returns True. Specifying a value of -0 +0 for the delay parameter causes diff --git a/specs/XKB/ch11.xml b/specs/XKB/ch11.xml index 02940d37..2277924b 100644 --- a/specs/XKB/ch11.xml +++ b/specs/XKB/ch11.xml @@ -277,9 +277,8 @@ used when the ComposeLED control is implemented, a consistent convention between implementations is to everyone’s benefit. If a named indicator is used for this purpose, the -recommended name is " -Compose -". Note that some implementations may use an unnamed, custom hardware LED for +recommended name is “Compose”. +Note that some implementations may use an unnamed, custom hardware LED for this purpose. @@ -312,9 +311,7 @@ While the Xkb extension does not specify the type of bell to be used when the BeepOnComposeFail control is implemented, a consistent convention between implementations is to everyone’s benefit. If a named bell is used for this purpose, the recommended -name is " -ComposeFail -". +name is “ComposeFail”. diff --git a/specs/XKB/ch20.xml b/specs/XKB/ch20.xml index 3ca2523c..580f986c 100644 --- a/specs/XKB/ch20.xml +++ b/specs/XKB/ch20.xml @@ -250,20 +250,16 @@ described below. Each of the fields in composed of characters from the ISO Latin1 encoding, but can contain only parentheses, the wildcard characters -‘ -? -’ and ‘ -* -’, and characters permitted in a component class or member name +‘?’ and ‘*’, +and characters permitted in a component class or member name (see section 20.1). A pattern may be NULL, in which case no components for that type is returned. Pattern matches with -component names are case sensitive. The ‘ -? -’ wildcard matches any single character, except a left or right parenthesis; -the ‘ -* -’ wildcard matches any number of characters, except a left or right +component names are case sensitive. The +‘?’ +wildcard matches any single character, except a left or right parenthesis; +the ‘*’ +wildcard matches any number of characters, except a left or right parenthesis. If an implementation allows additional characters in a component class or member name other than those required by the Xkb extension (see section 20.1), the result of comparing one of the additional characters to @@ -651,21 +647,18 @@ The individual fields in are component expressions composed of keyboard component names (no wildcarding as may be used in -XkbListComponents -), the special component name symbol ‘%’, and the special operator -characters ‘ -+ -’ and ‘ -| -’. A component expression is parsed left to right, as follows: +XkbListComponents), +the special component name symbol ‘%’, +and the special operator characters +‘+’ and ‘|’. +A component expression is parsed left to right, as follows: -The special component name " -computed -" may be used in +The special component name “computed” +may be used in keycodes component expressions and refers to a component consisting of a set of keycodes computed automatically by the server as needed. @@ -673,9 +666,7 @@ keycodes computed automatically by the server as needed. -The special component name " -canonical -" may be used in +The special component name “canonical” may be used in types component expressions and refers to a partial component defining the four standard key types: @@ -688,25 +679,22 @@ and -The special component name ‘ -% -’ refers to the keyboard description for the device specified in +The special component name ‘%’ +refers to the keyboard description for the device specified in device_spec or the keymap names component. If a keymap names component is specified that -does not begin with ‘+’ or ‘|’ and does not contain ‘ -% -’, then ‘ -% -’ refers to the description generated by the keymap names component. +does not begin with +‘+’ or ‘|’ and does not contain +‘%’, then ‘%’ +refers to the description generated by the keymap names component. Otherwise, it refers to the keyboard description for device_spec. -The ‘ -+ -’ operator specifies that the following component should +The ‘+’ + operator specifies that the following component should override the currently assembled description; any definitions that are present in both components are taken from the second. @@ -714,9 +702,8 @@ components are taken from the second. -The ‘ -| -’ operator specifies that the next specified component should +The ‘|’ + operator specifies that the next specified component should augment the currently assembled description; any definitions that are present in both components are taken from the first. @@ -724,9 +711,8 @@ components are taken from the first. -If the component expression begins with an operator, a leading ‘ -% -’ is implied. +If the component expression begins with an operator, a leading +‘%’ is implied. @@ -751,12 +737,12 @@ Here is a slightly more involved example: the expression "acme(ascii)+de(basic)|iso9995-3" constructs a German (de) mapping for the ASCII keyboard supplied by the "acme" vendor. The new definition begins with the symbols for the ASCII keyboard for Acme ( -acme(ascii) +acme(ascii) ), overrides them with definitions for the basic German keyboard ( -de(basic) +de(basic) ), and then applies the definitions from the default iso9995-3 keyboard ( -iso9995-3 +iso9995-3 ) to any undefined keys or groups of keys (part three of the iso9995 standard defines a common set of bindings for the secondary group, but allows national layouts to override those definitions where necessary). @@ -769,17 +755,16 @@ ordering are. Note that the presence of a keymap names - component that does not contain ‘ -% -’ (either explicit or implied by virtue of an expression starting with an + component that does not contain +‘%’ + (either explicit or implied by virtue of an expression starting with an operator) indicates a description that is independent of the keyboard description for the device specified in device_spec. The same is true of requests in which the keymap names component is empty and all five other names components contain expressions void of references to -‘ -% -’. Requests of this form allow you to deal with keyboard definitions +‘%’. +Requests of this form allow you to deal with keyboard definitions independent of any actual device. @@ -808,9 +793,9 @@ If a required component has not been specified in the names structure (the corresponding field is NULL -), the server substitutes the expression " -% -", resulting in the component values being taken from +), the server substitutes the expression +“%”, + resulting in the component values being taken from device_spec. In addition, if load @@ -818,9 +803,9 @@ In addition, if True, the server modifies names - if necessary (again using a " -% -" entry) to ensure all of the following fields are non- + if necessary (again using a +“%” + entry) to ensure all of the following fields are non- NULL : types,