Merge branch 'devel/x11' into tizen
[platform/upstream/kbproto.git] / specs / appB.xml
1 <appendix id='canonical_key_types'>
2 <title>Canonical Key Types</title>
3
4 <sect1 id='Canonical_Key_Types'>
5 <title>Canonical Key Types</title>
6 <sect2 id='The_ONE_LEVEL_Key_Type'>
7 <title>The ONE_LEVEL Key Type</title>
8
9 <para>
10 The <emphasis>
11 ONE_LEVEL</emphasis>
12  key type describes groups that have only one symbol. The default <emphasis>
13 ONE_LEVEL</emphasis>
14  type has no map entries and does not pay attention to any modifiers.
15 </para>
16
17 </sect2>
18 <sect2 id='The_TWO_LEVEL_Key_Type'>
19 <title>The TWO_LEVEL Key Type</title>
20
21 <para>
22 The <emphasis>
23 TWO_LEVEL</emphasis>
24  key type describes groups that have two symbols but are neither alphabetic nor
25 numeric keypad keys. The default <emphasis>
26 TWO_LEVEL</emphasis>
27  type uses only the <emphasis>
28 Shift</emphasis>
29  modifier. It returns level two if <emphasis>
30 Shift</emphasis>
31  is set, level one if it is not.
32 </para>
33
34
35 </sect2>
36 <sect2 id='The_ALPHABETIC_Key_Type'>
37 <title>The ALPHABETIC Key Type</title>
38
39 <para>
40 The <emphasis>
41 ALPHABETIC</emphasis>
42  key type describes groups that consist of two symbols — the lowercase form
43 of a symbol followed by the uppercase form of the same symbol. The default
44 <emphasis>
45 ALPHABETIC</emphasis>
46  type implements locale-sensitive "shift cancels caps lock" behavior using both
47 the <emphasis>
48 Shift</emphasis>
49  and <emphasis>
50 Lock</emphasis>
51  modifiers as follows:
52 </para>
53
54 <itemizedlist>
55 <listitem>
56   <para>If <emphasis>
57 Shift</emphasis>
58  and <emphasis>
59 Lock</emphasis>
60  are both set, the default <emphasis>
61 ALPHABETIC</emphasis>
62  type yields level one.
63   </para>
64 </listitem>
65 <listitem>
66   <para>If <emphasis>
67 Shift</emphasis>
68  alone is set, it yields level two.
69   </para>
70 </listitem>
71 <listitem>
72   <para>If <emphasis>
73 Lock</emphasis>
74  alone is set, it yields level one but preserves the <emphasis>
75 Lock</emphasis>
76  modifier.
77   </para>
78 </listitem>
79 <listitem>
80   <para>If neither <emphasis>
81 Shift</emphasis>
82  nor <emphasis>
83 Lock</emphasis>
84  are set, it yields level one.
85   </para>
86 </listitem>
87 </itemizedlist>
88
89 </sect2>
90 <sect2 id='The_KEYPAD_Key_Type'>
91 <title>The KEYPAD Key Type</title>
92
93 <para>
94 The <emphasis>
95 KEYPAD</emphasis>
96  key type describes that consist of two symbols, at least one of which is a
97 numeric keypad symbol. The default <emphasis>
98 KEYPAD</emphasis>
99  type implements "shift cancels numeric lock" behavior using the <emphasis>
100 Shift</emphasis>
101  modifier and the real modifier bound to the virtual modifier named "NumLock"
102 (the "NumLock" modifier) as follows:
103 </para>
104
105 <itemizedlist>
106 <listitem>
107   <para>If <emphasis>
108 Shift</emphasis>
109  and the "NumLock" modifier are both set, the default <emphasis>
110 KEYPAD </emphasis>
111 type yields level one.
112   </para>
113 </listitem>
114 <listitem>
115   <para>If either <emphasis>
116 Shift</emphasis>
117  or the "NumLock" modifier alone are set, it yields level two.
118   </para>
119 </listitem>
120 <listitem>
121   <para>If neither <emphasis>
122 Shift</emphasis>
123  nor the "NumLock" modifier are set, it yields level one.
124   </para>
125 </listitem>
126 </itemizedlist>
127 </sect2>
128 </sect1>
129 </appendix>