orca wiki import

svn path=/trunk/; revision=1014

1 files changed, 269 insertions, 0 deletions

diff --git a/gnome2-accessibility-guide/C/orca.xml b/gnome2-accessibility-guide/C/orca.xml
index 5f9ba22..626c14f 100644
--- a/gnome2-accessibility-guide/C/orca.xml
+++ b/gnome2-accessibility-guide/C/orca.xml
@@ -731,5 +731,274 @@ X Window System DISPLAY of where to put the zoomer window. Written in the form "
 </section>
 </section>
 </section>
+
+<section>
+<title>Key Bindings Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata 
+fileref="figures/KeyBindings_Tab.png" 
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Key Bindings Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+The key bindings page allows you to examine and modify the key bindings for <application>Orca</application>.
+</para>
+
+<section>
+<title>Orca Modifier Key(s)</title>
+<para>
+The first control on the key bindings page allows you to examine which key (or keys) acts as the "<application>Orca</application> modifier." The <application>Orca</application> modifier is the key that you press and hold in conjunction with other keys to give commands to <application>Orca</application>. For  desktop keyboards, the Orca modifier defaults to <keycap>Insert</keycap>. For laptop keyboards, the <application>Orca</application> modifier defaults to the <keycap>Caps Lock</keycap> key.
+</para>
+<note>
+<para>
+You cannot modify the <application>Orca</application> modifier key(s) using the Configuration GUI at this time.
+</para>
+</note>
+</section>
+
+<section>
+<title>Key Bindings Table</title>
+<para>
+The key bindings table provides a list of <application>Orca</application> operations and the keys that are bound to them.
+</para>
+<para>
+The "Function" column header is a description of the <application>Orca</application> operation to be performed.
+</para>
+<para>
+The "Key Binding" header is the primary way to invoke the function from the keyboard. Note that the function description may include the word "Orca". This indicates that the <application>Orca</application> modifier key should be held down along with the other keys.
+</para>
+<para>
+The "Alternate" header provides an alternate mechanism for invoking the function from the keyboard.
+</para>
+<para>
+To modify either the "Key Binding" or the "Alternate" bindings, arrow to the cell and press <keycap>Return</keycap>. Then, press a key combination and press <keycap>Return</keycap> to confirm the new combination. When you do so, the new keystroke will be saved and the check box in the last column (the "Modified" column) will indicate that the key binding has been modified.
+</para>
+<para>
+To undo a modified keybinding, merely arrow to the modified column, uncheck the checkbox, and press the "Apply" button <keycombo><keycap>Alt</keycap><keycap>A</keycap></keycombo>.
+</para>
+<para>
+Beneath the list of <application>Orca</application> keybindings, you will find a group of "unbound" commands:
+</para>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata 
+fileref="figures/KeyBindings_Tab_Unbound.png" 
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Key Bindings Page showing the 'unbound' group of commands
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+These are commands which we feel will be very useful for some users, but not needed by most users. Rather than "use up" a keystroke for such commands, we have left them unassigned.  You can assign a keystroke to any of these unbound commands by following the procedure outlined above. In addition, you can unbind any bound command in a similar fashion: press <keycap>Return</keycap> to edit the keybinding, and when prompted for the new keybinding, press <keycap>Delete</keycap> or <keycap>Backspace</keycap>. You will be told that the key binding has been removed. Press <keycap>Return</keycap> to confirm.
+</para>
+</section>
+</section>
+
+<section>
+<title>Pronunciation Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata 
+fileref="figures/Pronunciation_Tab.png" 
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Pronunciation Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+Sometimes your speech synthesizer just doesn't say the right thing for a given string. You might prefer to hear "laughing out loud" rather than "LOL." Or there may be a name or a technical term which the synthesizer mispronounces. The pronunciation page is where you can add, edit, and delete <application>Orca</application>'s pronunciation dictionary entries. Because the pronunciation page is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>, you can customize your entries on an as-needed basis for each application you use.
+</para>
+
+<section>
+<title>Add a new dictionary entry</title>
+<procedure>
+<step>
+<para>
+Press the <guibutton>New Entry</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>N</keycap></keycombo>).
+</para>
+</step>
+<step>
+<para>
+Type the text of the new entry and press <keycap>Return</keycap> to finish editing the actual string.
+</para>
+</step>
+<step>
+<para>
+Move to the Replacement String column and press <keycap>Return</keycap> to begin editing.
+</para>
+</step>
+<step>
+<para>
+Type the text that you would like to have spoken instead and press <keycap>Return</keycap> to finish editing the replacement string.
+</para>
+</step>
+</procedure>  
+</section>
+
+<section>
+<title>Edit an existing dictionary entry</title>
+<procedure>
+<step>
+<para>
+Move to the cell you wish to edit and press <keycap>Return</keycap> to begin editing.
+</para>
+</step>
+<step>
+<para>
+Make your changes and then press <keycap>Return</keycap> to finish editing.
+</para>
+</step>
+</procedure>  
+</section>
+
+<section>
+<title>Delete an existing dictionary entry</title>
+<procedure>
+<step>
+<para>
+Move to the entry you wish to delete.
+</para>
+</step>
+<step>
+<para>
+Press the Delete button or <keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>.
+</para>
+</step>
+</procedure>  
+</section>
+</section>
+
+<section>
+<title>Text Attributes Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata 
+fileref="figures/TextAttributes_Tab.png" 
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Text Attributes Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+<application>Orca</application> will speak known text attribute information about an object when you press <keycombo><keycap>Insert</keycap><keycap>F</keycap></keycombo> (desktop layout) or <keycombo><keycap>Caps_Lock</keycap><keycap>F</keycap></keycombo> (laptop layout). Because the number of text attributes is large, and not everyone cares about every attribute, the "Text Attributes" tab of the configuration
+GUI allows you to customize which text attributes <application>Orca</application> will present.
+</para>
+<para>
+On this tab is a text attribute list, where each row consists of four columns:
+</para>
+<itemizedlist>
+<listitem>
+<para>
+The name of the text attribute.
+</para>
+</listitem>
+<listitem>
+<para>
+A checkbox which the user can set to indicate whether this text attribute should be spoken or not.
+</para>
+</listitem>
+<listitem>
+<para>
+A checkbox which the user can set to indicate whether this text attribute should be "underlined" on the braille display.
+</para>
+</listitem>
+<listitem>
+<para>
+An editable "Present unless" string value. By default, not all text attributes will have this set. If present, what it means (assuming the user wants this text attribute presented) is that the value of the attribute will only be presented if it is <emphasis>not</emphasis> this value.
+</para>
+<para>
+For example, by default the "underline" text attribute has a value of "none." If the user has this attribute checked and the user types
+<keycombo><keycap>Orca_Modifier</keycap><keycap>F</keycap></keycombo> and the text in question is not underlined, then this
+attribute is not spoken. If you always want this attribute to be spoken irrespective of whether the text is underlined, then the
+attribute should be checked and the "Present unless" value cleared.
+</para>
+</listitem>
+<listitem>
+<para>
+There is also a <guibutton>Reset</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>R</keycap></keycombo>) which will set the list values back to their initial state when the dialog was first displayed.
+</para>
+</listitem>
+</itemizedlist>
+<para>
+When you initially display the text attribute pane, all your checked attributes are put at the top of the list. They are given in the order that they will be spoken and brailled.
+</para>
+<para>
+If you decide to check others or adjust the order, there are four buttons to help you do this:
+</para>
+<itemizedlist>
+<listitem>
+<para>
+<guibutton>Move to top</guibutton> (<keycombo><keycap>Alt</keycap><keycap>T</keycap></keycombo>) - moves the selected attribute to the top of the list.
+</para>
+</listitem>
+<listitem>
+<para>
+<guibutton>Move up one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>U</keycap></keycombo>) - moves the selected attribute up one row.
+</para>
+</listitem>
+<listitem>
+<para>
+<guibutton>Move down one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>) - moves the selected attribute down one row.
+</para>
+</listitem>
+<listitem>
+<para>
+<guibutton>Move to bottom</guibutton> (<keycombo><keycap>Alt</keycap><keycap>B</keycap></keycombo>) - moves the selected attribute to the bottom of the list.
+</para>
+</listitem>
+</itemizedlist>
+<para>
+Beneath these push buttons is the Braille Indicator group of radio buttons. Here you can select the cell or cells to be used to indicate text which has at least one of the specified attributes. Your choices are:
+</para>
+<itemizedlist>
+<listitem>
+<para>
+None (the default)
+</para>
+</listitem>
+<listitem>
+<para>
+Dot 7
+</para>
+</listitem>
+<listitem>
+<para>
+Dot 8
+</para>
+</listitem>
+<listitem>
+<para>
+Dots 7 and 8
+</para>
+</listitem>
+</itemizedlist>
+<para>
+Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>.
+</para>
+</section>
+
 </section>
 </chapter>