Debian Codegraph @

help/C/preferences_key_echo.page

raw
1 <page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_key_echo">
2 <info>
3 <title type="link">Echo</title>
4 <title type="sort">4. Echo</title>
5 <desc>
6 Configuring what is spoken as you type
7 </desc>
8 <link type="guide" xref="preferences#orca" />
9 <link type="next" xref="preferences_key_bindings" />
10 <credit type="author">
11 <name>Joanmarie Diggs</name>
12 <email>[email protected]</email>
13 </credit>
14 <license>
15 <p>Creative Commons Share Alike 3.0</p>
16 </license>
17 </info>
18 <title>Echo Preferences</title>
19 <section id="keyecho">
20 <title>Enable key echo</title>
21 <p>
22 Orca's key echo setting controls what happens each time you press
23 a key. To enable key echo, check the "Enable key echo" checkbox.
24 Doing so causes additional checkboxes to become available through
25 which you can choose exactly which keys should and should not be
26 echoed to best suit your needs.
27 </p>
28 <p>
29 Default value: checked
30 </p>
31 <section id="keyecho_enable_alphanumeric">
32 <title>Enable alphabetic keys</title>
33 <p>
34 This option controls whether or not keys like <key>a</key>,
35 <key>b</key>, and <key>c</key> should be spoken when pressed.
36 </p>
37 <p>
38 Default value: checked
39 </p>
40 </section>
41 <section id="keyecho_enable_numeric">
42 <title>Enable numeric keys</title>
43 <p>
44 This option controls whether or not keys like <key>1</key>,
45 <key>2</key>, and <key>3</key> should be spoken when pressed.
46 </p>
47 <p>
48 Default value: checked
49 </p>
50 </section>
51 <section id="keyecho_enable_punctuation">
52 <title>Enable punctuation keys</title>
53 <p>
54 This option controls whether or not keys like <key>%</key>,
55 <key>;</key>, and <key>?</key> should be spoken when pressed.
56 </p>
57 <p>
58 Default value: checked
59 </p>
60 </section>
61 <section id="keyecho_enable_space">
62 <title>Enable space</title>
63 <p>
64 This option controls whether or not <key>Space</key> should be
65 spoken when pressed.
66 </p>
67 <p>
68 Default value: checked
69 </p>
70 </section>
71 <section id="keyecho_enable_modifier">
72 <title>Enable modifier keys</title>
73 <p>
74 This option controls whether or not <key>Shift</key>, <key>Ctrl</key>,
75 <key>Alt</key> and <key>Meta</key> should be spoken when pressed.
76 </p>
77 <p>
78 Default value: checked
79 </p>
80 </section>
81 <section id="keyecho_enable_function">
82 <title>Enable function keys</title>
83 <p>
84 This option controls whether or not <key>F1</key> through <key>F12</key>
85 should be spoken when pressed.
86 </p>
87 <p>
88 Default value: checked
89 </p>
90 </section>
91 <section id="keyecho_enable_action">
92 <title>Enable action keys</title>
93 <p>
94 This option controls whether or not <key>BackSpace</key>, <key>Delete
95 </key>, <key>Return</key>, <key>Esc</key>, <key>Tab</key>, <key>Page
96 Up</key>, <key>Page Down</key>, <key>Home</key>, and <key>End</key>
97 should be spoken when pressed.
98 </p>
99 <p>
100 Default value: checked
101 </p>
102 </section>
103 <section id="keyecho_enable_navigation">
104 <title>Enable navigation keys</title>
105 <p>
106 This option controls whether or not <key>Left</key>, <key>Right</key>,
107 <key>Up</key>, and <key>Down</key> should be spoken when pressed. This
108 option also applies to any key combination in which <key>Orca
109 Modifier</key> is being held down, for instance when flat review is
110 being used.
111 </p>
112 <p>
113 Default value: not checked
114 </p>
115 </section>
116 <section id="keyecho_enable_diacritical">
117 <title>Enable non-spacing diacritical keys</title>
118 <p>
119 This option controls whether or not "dead keys" used to generate
120 accented letters should be spoken when pressed.
121 </p>
122 <p>
123 Default value: not checked
124 </p>
125 </section>
126 </section>
127 <section id="characterecho">
128 <title>Enable echo by character</title>
129 <p>
130 Enabling this option causes Orca to echo the character
131 you just typed.
132 </p>
133 <p>
134 While echo by character seems quite similar to the key echo of
135 alphabetic, numeric, and punctuation keys, there are important differences,
136 especially with respect to accented letters and other symbols for which
137 there is no dedicated key:
138 </p>
139 <list>
140 <item>
141 <p>
142 Key echo causes <app>Orca</app> to announce what you just <em>
143 pressed</em>.
144 </p>
145 </item>
146 <item>
147 <p>
148 Character echo causes <app>Orca</app> to announce what was just
149 <em>inserted</em>.
150 </p>
151 </item>
152 </list>
153 <p>
154 Thus to have accented characters spoken as you type them, you should
155 enable character echo.
156 </p>
157 <p>
158 Default value: not checked
159 </p>
160 <note style="tip">
161 <title>Enabling both key echo and character echo</title>
162 <p>
163 If you like key echo and you frequently type accented characters,
164 consider enabling both. <app>Orca</app>'s character echo logic
165 attempts to filter out characters which were spoken as a result
166 of key echo, thus minimizing the likelihood of "double speaking"
167 as you type.
168 </p>
169 </note>
170 </section>
171 <section id="wordandsentenceecho">
172 <title>Enable echo by word and Enable echo by sentence</title>
173 <p>
174 Checking the <gui>Enable echo by word</gui> checkbox causes
175 <app>Orca</app> to echo the word you just typed. Similarly,
176 checking the <gui>Enable echo by sentence</gui> checkbox causes
177 <app>Orca</app> to echo the sentence you just typed.
178 </p>
179 <p>
180 Default value: not checked
181 </p>
182 </section>
183 </page>