summaryrefslogtreecommitdiff
path: root/specs/ch07.xml
diff options
context:
space:
mode:
Diffstat (limited to 'specs/ch07.xml')
-rw-r--r--specs/ch07.xml28
1 files changed, 14 insertions, 14 deletions
diff --git a/specs/ch07.xml b/specs/ch07.xml
index 500357f..700f28f 100644
--- a/specs/ch07.xml
+++ b/specs/ch07.xml
@@ -7,7 +7,7 @@ client map</emphasis>
for a keyboard is the collection of information a client needs to interpret
key events that come from that keyboard. It contains a global list of <emphasis>
key types</emphasis>
-, described in <link linkend='key_types'>See Key Types</link>,
+, described in <link linkend='key_types'>Key Types</link>,
and an array of <emphasis>
key symbol map</emphasis>
s, each of which describes the symbols bound to one particular key and the
@@ -19,7 +19,7 @@ rules to be used to interpret those symbols.
<para>
XKB associates a two-dimensional array of symbols with each key. Symbols are
-addressed by keyboard group (see <link linkend='keyboard_state'>See
+addressed by keyboard group (see <link linkend='keyboard_state'>
Keyboard State</link>) and shift level, where level is defined as in the
ISO9995 standard:
</para>
@@ -86,13 +86,13 @@ group and shift level that correspond to the event.
<para>
Group is reported in bits 13-14 of the state field of the key event, as
-described in <link linkend='computing_a_state_field_from_an_xkb_state'>See Computing A State
+described in <link linkend='computing_a_state_field_from_an_xkb_state'>Computing A State
Field from an XKB State</link>. The keyboard group reported in the event might
be out-of-range for any particular key because the number of groups can vary
from key to key. The XKB description of each key contains a <emphasis>
group info</emphasis>
field which is interpreted identically to the global groups wrap control (see
-<link linkend='computing_effective_modifier_and_group'>See Computing Effective Modifier and
+<link linkend='computing_effective_modifier_and_group'>Computing Effective Modifier and
Group</link>) and which specifies the interpretation of groups that are
out-of-range for that key.
</para>
@@ -104,7 +104,7 @@ determine the shift level. The description of a key includes a <emphasis>
key type</emphasis>
for each group of symbols bound to the key. Given the modifiers from the key
event, this key type yields a shift level and a set of "leftover" modifiers, as
-described in <link linkend='key_types'>See Key Types</link>
+described in <link linkend='key_types'>Key Types</link>
below.
</para>
@@ -125,7 +125,7 @@ map</emphasis>
field specifies the shift level that corresponds to some XKB modifier
definition; any combination of modifiers that is not explicitly listed
somewhere in the map yields shift level one. Map entries which specify unbound
-virtual modifiers (see <link linkend='inactive_modifier_definitions'>See Inactive
+virtual modifiers (see <link linkend='inactive_modifier_definitions'>Inactive
Modifier Definitions</link>) are not considered; each entry contains an
automatically-updated <emphasis>
active</emphasis>
@@ -161,7 +161,7 @@ Any modifiers specified in <emphasis>
modifiers</emphasis>
are normally <emphasis>
consumed</emphasis>
- (see <link linkend='transforming_the_keysym_associated_with_a_key_event'>See Transforming the KeySym
+ (see <link linkend='transforming_the_keysym_associated_with_a_key_event'>Transforming the KeySym
Associated with a Key Event</link>), which means that they are not considered
during any of the later stages of event processing. For those rare occasions
that a modifier <emphasis>
@@ -427,7 +427,9 @@ Control</emphasis>
<entry>Report the control character associated with the symbol. This
extension defines the control characters associated with the ASCII alphabetic
characters (both upper and lower case) and for a small set of punctuation
-characters (see <link linkend="default_symbol_transformations">Default Symbol Transformations</link>). Applications are
+characters (see
+<link linkend="default_symbol_transformations">Default Symbol Transformations</link>).
+Applications are
free to associate control characters with any symbols that are not specified by
this extension.</entry>
</row>
@@ -449,11 +451,9 @@ Interpretation of other modifiers is application dependent.
<note><para>This definition of capitalization is fundamentally different from
the core protocol’s, which uses the lock modifier to select from the symbols
-bound to the key. Consider key 9 in the example keyboard on <link
-linkend="client_map_example">See Consider a simple, if
-unlikely, keyboard with the following keys (gray characters indicate symbols
-that are implied or expected but are not actually engraved on the
-key):</link>; the core protocol provides no way to generate the capital form
+bound to the key. Consider key 9 in the
+<link linkend="client_map_example">client map example</link>;
+the core protocol provides no way to generate the capital form
of either symbol bound to this key. XKB specifies that we first look up the
symbol and then capitalize, so XKB yields the capital form of the two symbols
when caps lock is active. </para></note>
@@ -677,7 +677,7 @@ to be used. The key type determines which symbol is chosen from the list.
<para>
-<link linkend='determining_the_keysym_associated_with_a_key_event'>See Determining the KeySym Associated
+<link linkend='determining_the_keysym_associated_with_a_key_event'>Determining the KeySym Associated
with a Key Event</link> details the procedure to map from a key event to a
symbol and/or a string.
</para>