summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoanmarie Diggs <joanmarie.diggs@gmail.com>2009-08-07 21:48:48 -0400
committerJoanmarie Diggs <joanmarie.diggs@gmail.com>2009-08-09 14:26:42 -0400
commitbdd7c9aaaed4a7ba729b59ff5c8c4788e82b84d6 (patch)
treec6dc87481f2194834f240675c6fb5dda330d0f11
parent3c376c233cb359e3b54c61d78a6db647fd5d28b4 (diff)
downloadgnome-user-docs-bdd7c9aaaed4a7ba729b59ff5c8c4788e82b84d6.tar.gz
gnome-user-docs-bdd7c9aaaed4a7ba729b59ff5c8c4788e82b84d6.tar.xz
gnome-user-docs-bdd7c9aaaed4a7ba729b59ff5c8c4788e82b84d6.zip
Fix for bgo#591119 - The Orca documentation needs to be updated
This includes two updated screenshots of the Preferences dialog, the new key and character echo settings, and all of the new settings found on the Speech page.
-rw-r--r--gnome2-accessibility-guide/C/ChangeLog7
-rw-r--r--gnome2-accessibility-guide/C/figures/KeyEcho_Tab.pngbin39657 -> 53439 bytes
-rw-r--r--gnome2-accessibility-guide/C/figures/Speech_Tab.pngbin79243 -> 87316 bytes
-rw-r--r--gnome2-accessibility-guide/C/low-vision.xml61
4 files changed, 60 insertions, 8 deletions
diff --git a/gnome2-accessibility-guide/C/ChangeLog b/gnome2-accessibility-guide/C/ChangeLog
index e48ce3c..b979b82 100644
--- a/gnome2-accessibility-guide/C/ChangeLog
+++ b/gnome2-accessibility-guide/C/ChangeLog
@@ -1,3 +1,10 @@
+2009-07-19 Joanmarie Diggs <joanmarie.diggs@gmail.com>
+
+ * low-vision.xml:
+ * figures/KeyEcho_Tab.png:
+ * figures/Speech_Tab.png:
+ Updated documentation for new features in Orca (bgo#591119)
+
2009-07-08 Willie Walker <william.walker@sun.com>
* low-vision.xml: remove duplicate line (bgo#586646)
diff --git a/gnome2-accessibility-guide/C/figures/KeyEcho_Tab.png b/gnome2-accessibility-guide/C/figures/KeyEcho_Tab.png
index d643fdd..154cab2 100644
--- a/gnome2-accessibility-guide/C/figures/KeyEcho_Tab.png
+++ b/gnome2-accessibility-guide/C/figures/KeyEcho_Tab.png
Binary files differ
diff --git a/gnome2-accessibility-guide/C/figures/Speech_Tab.png b/gnome2-accessibility-guide/C/figures/Speech_Tab.png
index d954020..fe5ec6d 100644
--- a/gnome2-accessibility-guide/C/figures/Speech_Tab.png
+++ b/gnome2-accessibility-guide/C/figures/Speech_Tab.png
Binary files differ
diff --git a/gnome2-accessibility-guide/C/low-vision.xml b/gnome2-accessibility-guide/C/low-vision.xml
index 858d212..9063636 100644
--- a/gnome2-accessibility-guide/C/low-vision.xml
+++ b/gnome2-accessibility-guide/C/low-vision.xml
@@ -1356,30 +1356,65 @@ You can quickly toggle this behavior by pressing <keycombo><keycap>Orca_Modifier
</section>
<section>
-<title>Speak Progress Bar Updates</title>
+<title>Speak Blank Lines</title>
+<para>
+Some users desire to hear "blank" when navigating to a blank line in a document. Other users do not. If the "speak blank lines" check box is selected, <application>Orca</application> will speak blank lines.
+</para>
+</section>
+
+<section>
+<title>Speak multicase strings as words</title>
+<para>
+When working with code, one often comes across a "word" consisting of several words with alternating case, such as "MultiCaseString." Speech synthesizers do not always pronounce such multicase strings correctly. Checking the <guilabel>Speak multicase strings as words</guilabel> checkbox will cause <application>Orca</application> to break a word like "MultiCaseString" into separate words ("Multi," "Case," and "String") prior to passing it along to the speech synthesizer.
+</para>
+</section>
+
+<section>
+<title>Speak tutorial messages</title>
+<para>
+When moving from component to component in an interface, this option will provide spoken tutorial messages for how to work with the component.
+</para>
+</section>
+
+<section>
+<title>Speak object mnemonics</title>
+<para>
+This option will cause <application>Orca</application> to announce the mnemonic associated with the object with focus (such as "Alt O" for the <guilabel>OK</guilabel> button).
+</para>
+</section>
+
+<section>
+<title>Break speech into chunks between pauses</title>
<para>
-If this setting is enabled, <application>Orca</application> will periodically announce the status of progress bars. How often the announcement is made is determined by the value chosen in the <guilabel>Update Interval</guilabel> spin button. Note that this spin button is only available if the "Speak progress bar updates" checkbox has been checked.
+Depending on the enabled speech settings, <application>Orca</application> may have quite a bit to say about a particular object such as its name, its role, its state, its mnemonic, its tutorial message, and so on. Checking the <guilabel>Break speech into chunks between pauses</guilabel> checkbox will cause <application>Orca</application> to insert brief pauses in between each of these pieces of information.
+</para>
+</section>
+
+<section>
+<title>Speak child position</title>
+<para>
+Checking the <guilabel>Speak child position</guilabel> checkbox will cause <application>Orca</application> to announce the position of the focused item in menus and lists (e.g. "9 of 16").
</para>
</section>
<section>
<title>Speak Indentation and Justification</title>
<para>
-When working with code or editing other documents it is often desirable to be aware of justification and indentation. Selecting the "Speak indentation and justification" check box will cause <application>Orca</application> to provide this information.
+When working with code or editing other documents it is often desirable to be aware of justification and indentation. Selecting the <guilabel>Speak indentation and justification</guilabel> check box will cause <application>Orca</application> to provide this information.
</para>
</section>
<section>
-<title>Speak Blank Lines</title>
+<title>Speak Progress Bar Updates</title>
<para>
-Some users desire to hear "blank" when navigating to a blank line in a document. Other users do not. If the "speak blank lines" check box is selected, <application>Orca</application> will speak blank lines.
+If this setting is enabled, <application>Orca</application> will periodically announce the status of progress bars. How often the announcement is made is determined by the value chosen in the update interval spin button. Note that this spin button is only available if the <guilabel>Speak progress bar updates</guilabel> checkbox has been checked.
</para>
</section>
<section>
-<title>Speak tutorial messages</title>
+<title>Restrict progress bar updates to</title>
<para>
-When moving from component to component in an interface, this option will provide spoken tutorial messages for how to work with the component.
+This setting controls which progress bars should be spoken, assuming the <guilabel>Speak progress bar updates</guilabel> checkbox has been checked. The choices are All, Application, and Window. Choosing All will result in <application>Orca</application> speaking updates for all progress bars, regardless of where the progress bars are located. Choosing Application will result in <application>Orca</application> speaking updates from progress bars in the active application, even if they are not in the active window. Choosing Window will result in <application>Orca</application> only speaking updates for progress bars in the active window. The default value is Application.
</para>
</section>
@@ -1496,7 +1531,7 @@ The key echo page allows you to specify the behavior of <application>Orca</appli
<section>
<title>Enable Key Echo</title>
<para>
-The first control on the key echo page is the "Enable key echo" check box. When this box is selected, six additional check boxes become available. These are: "Enable alphanumeric and punctuation keys", "Enable modifier keys", "Enable locking keys", "Enable function keys", "Enable action keys", and "Enable navigation keys".
+The first control on the key echo page is the "Enable key echo" check box. When this box is selected, seven additional check boxes become available. These are: "Enable alphanumeric and punctuation keys", "Enable modifier keys", "Enable locking keys", "Enable function keys", "Enable action keys", "Enable navigation keys", and "Enable non-spacing diacritical keys".
</para>
<para>
The alphanumeric and function key groups are relatively self explanatory.
@@ -1513,6 +1548,16 @@ The action keys group consists of keys that perform some logical action, such as
<para>
The navigation keys group include the four arrow keys as well as any key combination in which the Orca Modifier key is being held down. The latter is designed to prevent <application>Orca</application> from echoing flat review commands.
</para>
+<para>
+Non-spacing diacritical keys are those "dead keys" used to generate accented letters.
+</para>
+</section>
+
+<section>
+<title>Enable Echo by Character</title>
+<para>
+The next toggle on the key echo page is the "Enable echo by character" check box, used to echo the character you just typed. While echo by character seems quite similar to the key echo of alphanumeric and punctuation keys, there are important differences, especially with respect to accented letters and other symbols for which there is no dedicated key. Key echo causes <application>Orca</application> to announce what you just pressed; character echo causes it to announce what was inserted. The "Echo by character" control is always available, regardless of whether any of the key echo options are checked.
+</para>
</section>
<section>