gnome-user-docs r858 - trunk/gnome2-accessibility-guide/C
- From: vpalexander svn gnome org
- To: svn-commits-list gnome org
- Subject: gnome-user-docs r858 - trunk/gnome2-accessibility-guide/C
- Date: Wed, 21 May 2008 16:48:26 +0000 (UTC)
Author: vpalexander
Date: Wed May 21 16:48:26 2008
New Revision: 858
URL: http://svn.gnome.org/viewvc/gnome-user-docs?rev=858&view=rev
Log:
general formatting and Orca edits
Modified:
trunk/gnome2-accessibility-guide/C/enable.xml
trunk/gnome2-accessibility-guide/C/general.xml
trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml
trunk/gnome2-accessibility-guide/C/legal.xml
trunk/gnome2-accessibility-guide/C/low-vision.xml
Modified: trunk/gnome2-accessibility-guide/C/enable.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/enable.xml (original)
+++ trunk/gnome2-accessibility-guide/C/enable.xml Wed May 21 16:48:26 2008
@@ -6,19 +6,13 @@
<procedure>
<step>
<para>
-Choose
-<menuchoice>
-<guimenuitem>System</guimenuitem>
-<guimenuitem>Preferences</guimenuitem>
-<guimenuitem>Assistive Technologies</guimenuitem>
-</menuchoice>.
+Choose <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Assistive Technologies</guimenuitem></menuchoice>.
</para>
</step>
<step>
<para>
Select <guilabel>Enable assistive technologies
-</guilabel> and then press
-<guibutton>Close and Log Out</guibutton>.
+</guilabel> and then press <guibutton>Close and Log Out</guibutton>.
</para>
</step>
<step>
Modified: trunk/gnome2-accessibility-guide/C/general.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/general.xml (original)
+++ trunk/gnome2-accessibility-guide/C/general.xml Wed May 21 16:48:26 2008
@@ -119,9 +119,7 @@
<listitem>
<para>
If you need to use the <application>
-Screen Reader and Magnifier</application>, include
-<literal>gail</literal> and <literal>atk-bridge
-</literal>.
+Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.
</para>
</listitem>
<listitem>
@@ -137,7 +135,7 @@
</listitem>
<listitem>
<para>
-<application>On-Screen Keyboard</application> can operate without <literal>gail</literal> and <literal>atk-bridge</literal> but with a reduced feature set.
+<application>On-Screen Keyboard</application> can operate without <literal>gail</literal> and <literal>atk-bridge</literal>, but with a reduced feature set.
</para>
</listitem>
</itemizedlist>
@@ -218,12 +216,8 @@
</para>
<note>
<para>
-The gestures must be contained in a single line in the
-<filename>
-AccessKeyMouseEvents
-</filename>
-file without line breaks. The formatting of
-this guide might display the examples in the following sections across multiple lines.
+The gestures must be contained in a single line in the <filename>AccessKeyMouseEvents
+</filename> file without line breaks. The formatting of this guide might display the examples in the following sections across multiple lines.
</para>
</note>
@@ -292,8 +286,7 @@
file to associate motion gestures with assistive technologies.
</para>
<para>
-If the <literal>dwellmouselistener</literal> GtkModule is loaded, alternative pointing devices are temporarily latched to the core pointer. This means that if the user moves the alternative pointing device, the onscreen
-pointer moves.
+If the <literal>dwellmouselistener</literal> GtkModule is loaded, alternative pointing devices are temporarily latched to the core pointer. This means that if the user moves the alternative pointing device, the on-screen pointer moves.
</para>
<para>
For example, the following line starts
@@ -407,9 +400,7 @@
Give focus to the next element or control if the <keycap>Tab</keycap> key has a specific purpose in a control. For example, if you press <keycap>Tab</keycap> in a text box, the system inserts a tab space.
</para>
<para>
-To give focus to the previous element or control, press
-<keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap>
-<keycap>Tab</keycap></keycombo>.
+To give focus to the previous element or control, press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo>.
</para>
</entry>
</row>
@@ -582,7 +573,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Open a popup menu for the element that has focus (if a popup menu exists).
+Open a popup menu for the element that has focus (if a popup menu exists for that element).
</para>
</entry>
</row>
@@ -626,12 +617,10 @@
</entry>
<entry valign="top">
<para>
-Temporarily hides all windows and gives focus to the desktop background.
+Temporarily hide all windows and give focus to the desktop background.
</para>
<para>
-To restore the windows, press <keycombo><keycap>
-Ctrl</keycap><keycap>Alt</keycap><keycap>D</keycap>
-</keycombo> again.
+To restore the windows, press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>D</keycap></keycombo> again.
</para>
<para>
You can customize this keyboard shortcut.
@@ -647,8 +636,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Display a popup window with icons that represent the desktop background and the panels. Press and hold
-<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> and continue to press <keycap>Tab</keycap> to switch the focus between the desktop background and the panels.
+Display a popup window with icons that represent the desktop background and the panels. Press and hold <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> and continue to press <keycap>Tab</keycap> to switch the focus between the desktop background and the panels.
</para>
<para>
You can customize this keyboard shortcut.
@@ -675,7 +663,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-When the desktop background or a desktop background object has focus, gives focus to a neighboring desktop background object.
+Give focus to a neighboring desktop background object (if the desktop has focus).
</para>
</entry>
</row>
@@ -688,7 +676,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-When the desktop background has focus, gives focus to the desktop background object whose name starts with the specified sequence of characters.
+If the desktop background has focus, give focus to the desktop background object whose name starts with the specified sequence of characters.
</para>
</entry>
</row>
@@ -764,7 +752,7 @@
</entry>
<entry valign="top">
<para>
-Gives focus to a panel. This keyboard shortcut displays a popup window with icons that represent the desktop background, panels, and drawers. Press and hold
+Give focus to a panel. This keyboard shortcut displays a popup window with icons that represent the desktop background, panels, and drawers. Press and hold
<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> and continue to press <keycap>Tab</keycap> to switch the focus between the desktop background, panels, and drawers.
</para>
<para>
@@ -780,7 +768,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next object on the panel.
+Give focus to the next object on the panel.
</para>
</entry>
</row>
@@ -792,7 +780,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the <guimenu>Applications</guimenu> menu when the Menu Panel has focus. Continue to press <keycap>F10</keycap> to switch focus between the <guimenu>Applications</guimenu> menu and the window list.
+Open the <guimenu>Applications</guimenu> menu when the Menu Panel has focus. Continue to press <keycap>F10</keycap> to switch focus between the <guimenu>Applications</guimenu> menu and the window list.
</para>
</entry>
</row>
@@ -804,7 +792,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Activates a panel object, for example, open a menu or start a launcher.
+Activate a panel object; for example, open a menu or start a launcher (icon shortcut).
</para>
</entry>
</row>
@@ -816,7 +804,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the panel object popup menu.
+Open the panel object popup menu.
</para>
</entry>
</row>
@@ -853,8 +841,7 @@
</listitem>
<listitem>
<para>
-Press <keycombo><keycap>Shift</keycap><keycap>F10
-</keycap></keycombo> to open the panel object popup menu.
+Press <keycombo><keycap>Shift</keycap><keycap>F10</keycap></keycombo> to open the panel object popup menu.
</para>
</listitem>
<listitem>
@@ -865,7 +852,7 @@
</listitem>
<listitem>
<para>
-Use the keyboard shortcuts that are listed in the following table to perform the move operation.
+Use the keyboard shortcuts that are listed in the following table to perform the move operation:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -888,18 +875,17 @@
</entry>
<entry valign="top">
<para>
-Moves the object left and right on a horizontal panel or up and down on a vertical panel.
+Move the object left/right on a horizontal panel, or up/down on a vertical panel.
</para>
</entry>
</row>
<row>
<entry colname="colspec0" valign="top">
-<para><keycap>Shift</keycap> +
-arrow keys</para>
+<para><keycap>Shift</keycap> + arrow keys</para>
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the object and pushes any objects that you encounter in front of the object.
+Move the object with focus, swapping positions with any other objects encountered.
</para>
</entry>
</row>
@@ -910,7 +896,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the object and swaps positions with any objects that you encounter in the move.
+Move the object, swapping positions with any other objects that you encounter in the move.
</para>
</entry>
</row>
@@ -922,7 +908,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the object to the next panel.
+Move the object to the next panel.
</para>
</entry>
</row>
@@ -933,7 +919,7 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Completes the move operation.</para>
+<para>Complete the move operation.</para>
</entry>
</row>
</tbody>
@@ -942,7 +928,7 @@
</listitem>
</orderedlist>
<para>
-The following examples demonstrate the effect of different move operations on the objects in a panel.
+The following examples demonstrate the effect of different move operations on the objects in a panel:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -970,7 +956,7 @@
</imageobject>
<textobject>
<phrase>
-Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon.
+Portion of a panel with three objects displayed in the following order from left to right: <application>Geyes</application> icon, <application>Volume Control</application> icon, and <application>Help</application> icon.
</phrase>
</textobject>
</mediaobject>
@@ -978,7 +964,7 @@
</entry>
<entry valign="top">
<para>
-Shows a panel with three panel objects before a move operation takes place.
+Show a panel with three panel objects before a move operation takes place.
</para>
</entry>
</row>
@@ -992,7 +978,7 @@
</imageobject>
<textobject>
<phrase>
-Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon.
+Portion of a panel with three objects displayed in the following order from left to right: <application>Geyes</application> icon, <application>Volume Control</application> icon, and <application>Help</application> icon.
</phrase>
</textobject>
</mediaobject>
@@ -1015,7 +1001,7 @@
</imageobject>
<textobject>
<phrase>
-Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon.
+Portion of a panel with three objects displayed in the following order from left to right: <application>Geyes</application> icon, <application>Volume Control</application> icon, and <application>Help</application> icon.
</phrase>
</textobject>
</mediaobject>
@@ -1023,7 +1009,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Shows the effect of using using <keycap>Shift</keycap> + arrow keys to move the <application>Geyes</application> panel application on the panel. You can use the
+Shows the effect of using <keycap>Shift</keycap> + arrow keys to move the <application>Geyes</application> panel application on the panel. You can use the
<keycap>Shift</keycap> + arrow keys to push the <application>Volume Control</application>
and <application>Help</application> panel objects ahead of the object that you are moving.
</para>
@@ -1039,7 +1025,7 @@
</imageobject>
<textobject>
<phrase>
-Portion of a panel with three objects displayed in the following order from left to right: Volume Control icon, Help icon, and geyes icon.
+Portion of a panel with three objects displayed in the following order from left to right: <application>Volume Control</application> icon, <application>Help</application> icon, and <application>Geyes</application> icon.
</phrase>
</textobject>
</mediaobject>
@@ -1057,7 +1043,7 @@
</informaltable>
<note>
<para>
-Panel applications that are <guilabel>Locked</guilabel> cannot be moved. To unlock a panel application, use the <guimenu>panel object</guimenu> menu and unselect <guimenuitem>Lock to Panel</guimenuitem>.
+Panel applications that are <guilabel>Locked</guilabel> cannot be moved. To unlock a panel application, use the <guimenu>panel object</guimenu> menu and deselect the <guimenuitem>Lock to Panel</guimenuitem> option.
</para>
</note>
</section>
@@ -1095,7 +1081,7 @@
</entry>
<entry valign="top">
<para>
-Opens or closes the drawer that has focus.
+Open or close the drawer that has focus.
</para>
</entry>
</row>
@@ -1105,7 +1091,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Navigates into the drawer that has focus.
+Navigate into the drawer that has focus.
</para>
</entry>
</row>
@@ -1117,7 +1103,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the drawer and gives focus to the drawer object on the panel.
+Close the drawer and give focus to the drawer object on the panel.
</para>
</entry>
</row>
@@ -1145,7 +1131,7 @@
<secondary>for menus on panels</secondary>
</indexterm>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate menus on panels.
+The following table lists the keyboard shortcuts that you can use to navigate menus on panels:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1170,7 +1156,7 @@
</entry>
<entry valign="top">
<para>
-Opens the menu that has focus.
+Open the menu that has focus.
</para>
</entry>
</row>
@@ -1179,7 +1165,7 @@
<para>arrow keys</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Navigates the menu.</para>
+<para>Navigate the menu.</para>
</entry>
</row>
<row>
@@ -1189,7 +1175,7 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Selects a menu item.</para>
+<para>Select a menu item.</para>
</entry>
</row>
<row>
@@ -1198,7 +1184,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the popup menu associated with a menu item (if one exists).
+Open the popup menu associated with a menu item (if one exists).
</para>
</entry>
</row>
@@ -1209,7 +1195,7 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Closes a menu.</para>
+<para>Close a menu.</para>
</entry>
</row>
</tbody>
@@ -1250,7 +1236,7 @@
</entry>
<entry valign="top">
<para>
-Activates the panel application control that has focus, if applicable. Not all panel applications contain controls that you can activate. If the panel application does not contain a control that you can activate,
+Activate the panel application control that has focus, if applicable. Not all panel applications contain controls that you can activate. If the panel application does not contain a control that you can activate,
the <keycap>spacebar</keycap> does nothing.
</para>
</entry>
@@ -1261,7 +1247,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Navigates the controls on the panel application.
+Navigate the controls on the panel application.
</para>
</entry>
</row>
@@ -1272,7 +1258,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the panel application popup menu. To navigate the menu, use the standard keyboard shortcuts for navigating menus. See <xref linkend="keynav-24"/> for information
+Open the panel application popup menu. To navigate the menu, use the standard keyboard shortcuts for navigating menus. See <xref linkend="keynav-24"/> for information
about how to navigate menus.
</para>
</entry>
@@ -1292,7 +1278,7 @@
<para>
A workspace is a discrete area in which you
can work. You can have many workspaces on your desktop and you can switch from one workspace to another. Each workspace can
-contain different windows and processes. The following table lists the keyboard shortcuts that you can use to navigate workspaces.
+contain different windows and processes. The following table lists the keyboard shortcuts that you can use to navigate workspaces:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1316,7 +1302,7 @@
</entry>
<entry valign="top">
<para>
-Gives focus to the next or previous workspace. This keyboard shortcut displays a popup window with icons that represent the workspaces. Press and hold <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> and continue to press the arrow keys to switch the focus between the workspaces.
+Give focus to the next or previous workspace. This keyboard shortcut displays a popup window with icons that represent the workspaces. Press and hold <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap></keycombo> and continue to press the arrow keys to switch the focus between the workspaces.
</para>
<para>
You can customize this keyboard shortcut.
@@ -1331,7 +1317,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the window that has focus to the next or previous workspace.
+Move the window that has focus to the next or previous workspace.
</para>
<para>
You can customize this keyboard shortcut.
@@ -1366,7 +1352,7 @@
a window</secondary>
</indexterm>
<para>
-Before you can use or modify a window, you must give focus to the window. The following table lists the keyboard shortcuts that you can use to give focus to a window.
+Before you can use or modify a window, you must give focus to the window. The following table lists the keyboard shortcuts that you can use to give focus to a window:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1390,7 +1376,7 @@
</entry>
<entry valign="top">
<para>
-Displays a popup window with icons that represent each window. Press and hold <keycap>Alt</keycap> and continue to press <keycap>Tab</keycap> to move through the windows until you reach the window you want to have focus.
+Display a popup window with icons that represent each window. Press and hold <keycap>Alt</keycap> and continue to press <keycap>Tab</keycap> to move through the windows until you reach the window you want to have focus.
</para>
</entry>
</row>
@@ -1401,7 +1387,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Raises each window in turn until you reach the window to which you want to give focus.
+Raise each window in turn until you reach the window you want.
</para>
</entry>
</row>
@@ -1418,7 +1404,7 @@
</indexterm>
<para>
When a window has focus, you can perform various actions on the window. The following table lists the keyboard shortcuts that
-you can use to control the window that has focus.
+you can use to control the window that has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1442,7 +1428,7 @@
</entry>
<entry valign="top">
<para>
-Opens the <guimenu>Window</guimenu> Menu.
+Open the <guimenu>Window</guimenu> menu.
</para>
</entry>
</row>
@@ -1453,7 +1439,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the window.
+Close the window.
</para>
</entry>
</row>
@@ -1468,7 +1454,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Minimizes the window.
+Minimize the window.
</para>
</entry>
</row>
@@ -1479,7 +1465,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Maximizes the window.
+Maximize the window.
</para>
</entry>
</row>
@@ -1490,7 +1476,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Restores a maximized window to the original size of the window.
+Restore a maximized window to its original size.
</para>
</entry>
</row>
@@ -1506,7 +1492,7 @@
<secondary>to move a window</secondary>
</indexterm>
<para>
-When a window has focus, you can move the window around the screen. The following table lists the keyboard shortcuts that you can use to move a window.
+When a window has focus, you can move the window around the screen. The following table lists the keyboard shortcuts that you can use to move a window:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1530,7 +1516,7 @@
</entry>
<entry valign="top">
<para>
-Starts the move operation. The mouse pointer changes to a cross.
+Start the move operation. The mouse pointer changes to a cross.
</para>
</entry>
</row>
@@ -1540,7 +1526,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the window 10 pixels at a time in the direction of the arrow key.
+Move the window 10 pixels at a time in the direction of the arrow key.
</para>
</entry>
</row>
@@ -1551,7 +1537,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the window one pixel at a time in the direction of the arrow key.
+Move the window one pixel at a time in the direction of the arrow key.
</para>
</entry>
</row>
@@ -1562,7 +1548,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the window in the direction of the arrow key to align it with the edge of the nearest window, panel or screen edge.
+Move the window in the direction of the arrow key and align it with the edge of the nearest window, panel or screen edge.
</para>
</entry>
</row>
@@ -1574,7 +1560,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Completes the move operation and leaves the window in the current position.
+Complete the move operation, leaving the window in the current position.
</para>
</entry>
</row>
@@ -1586,7 +1572,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Cancels the move operation and restores the window to the original position.
+Cancel the move operation, restoring the window to its original position.
</para>
</entry>
</row>
@@ -1604,7 +1590,7 @@
<para>
When a window has focus, you can increase or
decrease the size of the window. The following table lists the keyboard shortcuts
-that you can use to resize the window that has focus.
+that you can use to resize the window that has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1627,7 +1613,7 @@
<keycap>F8</keycap></keycombo></para>
</entry>
<entry valign="top">
-<para>Starts the resize operation.</para>
+<para>Start the resize operation.</para>
</entry>
</row>
<row>
@@ -1636,7 +1622,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Resizes the window in the direction of the arrow key.
+Resize the window in the direction of the arrow key.
</para>
</entry>
</row>
@@ -1648,7 +1634,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Completes the resize operation and leaves the window at the current size.
+Complete the resize operation, leaving the window at the current size.
</para>
</entry>
</row>
@@ -1660,7 +1646,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Cancels the resize operation and restores the window to the original size.
+Cancel the resize operation, restoring the window to its original size.
</para>
</entry>
</row>
@@ -1680,7 +1666,7 @@
two or more panes. <application>Help Browser</application> is an example of an application that uses paned windows.
</para>
<para>
-The following table describes the keyboard shortcuts that you can use to navigate paned/split windows.
+The following table describes the keyboard shortcuts that you can use to navigate paned/split windows:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1705,7 +1691,7 @@
</entry>
<entry valign="top">
<para>
-Gives focus to the next pane. The system gives focus to the control that last had focus in the pane.
+Give focus to the next pane. The system gives focus to the control that last had focus in the pane.
</para>
</entry>
</row>
@@ -1717,7 +1703,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the first resize handle in the window. The resize handle is displayed between the panes and enables you to resize the panes. Press <keycap>F8</keycap> again to give focus to the next resize handle.
+Give focus to the first resize handle in the window. The resize handle is displayed between the panes and enables you to resize the panes. Press <keycap>F8</keycap> again to give focus to the next resize handle.
</para>
</entry>
</row>
@@ -1725,7 +1711,7 @@
</tgroup>
</informaltable>
<para>
-When the resize handle has focus, you can use the keyboard shortcuts that are listed in the following table to modify the paned window.
+When the resize handle has focus, you can use the keyboard shortcuts that are listed in the following table to modify the paned window:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1748,7 +1734,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the resize handle by a small amount.
+Move the resize handle by a small amount.
</para>
</entry>
</row>
@@ -1759,7 +1745,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the resize handle by a large amount.
+Move the resize handle by a large amount.
</para>
</entry>
</row>
@@ -1771,7 +1757,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Contracts the pane to the minimum size allowed.
+Contract the pane to the minimum size allowed.
</para>
<para>
For vertical panes, reduces the size of the pane to the left of the resize handle to the minimum size allowed.
@@ -1789,7 +1775,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Expands the pane to the maximum size allowed.
+Expand the pane to the maximum size allowed.
</para>
<para>
For vertical panes, increases the size of the pane to the left of the resize handle to the maximum size allowed.
@@ -1807,7 +1793,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Sets the position of the resize handle and returns the focus to the last control that had focus.
+Set the position of the resize handle and return focus to the last control that had focus.
</para>
</entry>
</row>
@@ -1819,7 +1805,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Resets the position of the resize handle to the original position and returns the focus to the last control that had focus.
+Reset the position of the resize handle to the original position and return focus to the last control that had focus.
</para>
</entry>
</row>
@@ -1874,14 +1860,14 @@
<title>Essential Keyboard Shortcuts for NavigatingApplications</title>
<anchor id="keynav-22"/>
<para>
-Since there are so many applications that you can use in the GNOME Desktop, this manual does not describe all the custom keyboard shortcuts that you can use with each individual applications. However, the basic keyboard shortcuts are common to all applications.
+Since there are so many applications that you can use in the GNOME Desktop, this manual does not describe all the custom keyboard shortcuts that you can use with each individual application. However, the basic keyboard shortcuts are common to all applications.
</para>
<para>
Access keys are another way to quickly navigate applications with the keyboard.
An access key is identified by an underlined letter on a menu or control. In some cases, you must press <keycap>Alt</keycap> in combination with the access key to perform an action.
</para>
<para>
-The following table lists the essential keyboard shortcuts that you can use to navigate applications.
+The following table lists the essential keyboard shortcuts that you can use to navigate applications:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -1906,7 +1892,7 @@
</entry>
<entry valign="top">
<para>
-Opens the first menu on the application menubar.
+Open the first menu on the application menubar.
</para>
</entry>
</row>
@@ -1917,7 +1903,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the menu that is associated with the access key.
+Open the menu that is associated with the access key.
</para>
</entry>
</row>
@@ -1927,7 +1913,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the menu item that is associated with the access key.
+Select the menu item that is associated with the access key.
</para>
</entry>
</row>
@@ -1938,7 +1924,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Switches focus between the menus on the menubar.
+Switch focus between the menus on the menubar.
</para>
</entry>
</row>
@@ -1949,7 +1935,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves focus into a menu.
+Move focus into a menu.
</para>
</entry>
</row>
@@ -1961,7 +1947,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the open menu and gives focus to the control that had focus before the menubar.
+Close the open menu and give focus to the control that had focus before the menubar.
</para>
</entry>
</row>
@@ -1972,7 +1958,7 @@
</entry>
<entry colname="colspec1">
<para>
-Opens the file selector dialog.
+Open the file selector dialog.
</para>
</entry>
</row>
@@ -1983,7 +1969,7 @@
</entry>
<entry colname="colspec1">
<para>
-Opens the Save dialog.
+Open the Save dialog.
</para>
</entry>
</row>
@@ -1994,8 +1980,8 @@
</entry>
<entry colname="colspec1">
<para>
-Opens a Location dialog to enable you to type
-the name of the file that you want to open or save.
+Open a Location dialog, enabling you to type
+the name of a file that you want to open or save.
</para>
</entry>
</row>
@@ -2011,7 +1997,7 @@
<secondary>for dialogs</secondary>
</indexterm>
<para>
-The following table lists the essential keyboard shortcuts that you can use to navigate dialogs.
+The following table lists the essential keyboard shortcuts that you can use to navigate dialogs:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2035,7 +2021,7 @@
</entry>
<entry valign="top">
<para>
-Activates or selects a control.
+Activate or select a control.
</para>
</entry>
</row>
@@ -2047,7 +2033,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next control.
+Give focus to the next control.
</para>
</entry>
</row>
@@ -2058,8 +2044,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-<-- standard control name ... -->
-If a notebook header/tabstrip has focus, moves to the next page/tabbed section of the dialog.
+Move to the next page/tabbed section of the dialog.
</para>
</entry>
</row>
@@ -2070,7 +2055,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-If a notebook header/tabstrip has focus, moves to the previous page/tabbed section of the dialog.
+Move to the previous page/tabbed section of the dialog.
</para>
</entry>
</row>
@@ -2082,7 +2067,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the dialog.
+Close and/or cancel the dialog.
</para>
</entry>
</row>
@@ -2094,7 +2079,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Performs the default action for the dialog. The default action will usually apply any changes and close the dialog.
+Perform the default action for the dialog. The default action will usually apply any changes and close the dialog.
</para>
</entry>
</row>
@@ -2112,7 +2097,7 @@
</indexterm>
<para>
By default, the file manager operates in
-<guilabel>Spatial</guilabel> mode. This mode uses separate windows for each folder. Another mode, called <guilabel>Browser</guilabel> mode, reuses the same window for each folder.
+<guilabel>Spatial</guilabel> mode. This mode uses separate windows for each folder. Conversely, <guilabel>Browser</guilabel> mode will reuse the same window for each folder.
</para>
<note>
<para>
@@ -2125,7 +2110,7 @@
<section id="keynav-spatial">
<title>Navigating Folders</title>
<para>
-The following table describes the keyboard shortcuts that enable you to navigate folders in the file manager.
+The following table describes the keyboard shortcuts that enable you to navigate folders in the file manager:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2148,7 +2133,7 @@
</entry>
<entry valign="top">
<para>
-Selects the next or previous file or folder in the direction of the arrow key.
+Select the next or previous file or folder in the direction of the arrow key.
</para>
</entry>
</row>
@@ -2159,7 +2144,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next or previous file or folder but does not select the item. This allows multiple files to be selected.
+Give focus to the next or previous file or folder but do not select the item. This allows multiple, non-contiguous blocks of files to be selected.
</para>
</entry>
</row>
@@ -2171,7 +2156,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the focused file or folder.
+Open the focused file or folder.
</para>
</entry>
</row>
@@ -2182,7 +2167,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the item that currently has focus.
+Select the item that currently has focus.
</para>
</entry>
</row>
@@ -2194,7 +2179,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the first file or folder that starts with the specified sequence of characters.
+Select the first file or folder that starts with the specified sequence of characters.
</para>
</entry>
</row>
@@ -2206,7 +2191,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the first file or folder within the current folder.
+Select the first file or folder within the current folder.
</para>
</entry>
</row>
@@ -2218,7 +2203,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the last file or folder within the current folder.
+Select the last file or folder within the current folder.
</para>
</entry>
</row>
@@ -2230,7 +2215,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Opens the current folder's parent folder.
+Open the current folder's parent folder.
</para>
</entry>
</row>
@@ -2244,10 +2229,7 @@
<anchor id="keynav-21"/>
<para>
When operating in <guilabel>Browser</guilabel> mode, the file manager window
-contains several components, with keyboard shortcuts defined to navigate each component.
-</para>
-<para>
-The following table describes the keyboard shortcuts that enable you to navigate between the components.
+contains several components, with keyboard shortcuts defined to navigate each component:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2272,7 +2254,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Switches focus between the side pane and the view pane.
+Switch focus between the side pane and the view pane.
</para>
</entry>
</row>
@@ -2283,7 +2265,7 @@
</entry>
<entry valign="top">
<para>
-Opens the side pane popup menu.
+Open the side pane popup menu.
</para>
</entry>
</row>
@@ -2330,7 +2312,7 @@
</entry>
<entry colname="colspec1">
<para>
-Switches to caret navigation mode.
+Switch to caret navigation mode.
</para>
</entry>
</row>
@@ -2340,7 +2322,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves one character to the left.
+Move one character to the left.
</para>
</entry>
</row>
@@ -2350,7 +2332,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves one character to the right.
+Move one character to the right.
</para>
</entry>
</row>
@@ -2360,7 +2342,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves up one line.
+Move up one line.
</para>
</entry>
</row>
@@ -2370,7 +2352,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves down one line.
+Move down one line.
</para>
</entry>
</row>
@@ -2380,7 +2362,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves to the beginning of the previous word.
+Move to the beginning of the previous word.
</para>
</entry>
</row>
@@ -2390,7 +2372,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves to the end of the next word.
+Move to the end of the next word.
</para>
</entry>
</row>
@@ -2402,7 +2384,7 @@
</entry>
<entry colname="colspec1">
<para>
-Scrolls up one page of content.
+Scroll up one page of content.
</para>
</entry>
</row>
@@ -2414,7 +2396,7 @@
</entry>
<entry colname="colspec1">
<para>
-Scrolls down one page of content.
+Scroll down one page of content.
</para>
</entry>
</row>
@@ -2426,7 +2408,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves to the beginning of the current line.
+Move to the beginning of the current line.
</para>
</entry>
</row>
@@ -2438,7 +2420,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves to the end of the current line.
+Move to the end of the current line.
</para>
</entry>
</row>
@@ -2448,7 +2430,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves from the current position to the destination position, selecting all text between the two positions.
+Move from the current position to the destination position, selecting all text between the two positions.
</para>
</entry>
</row>
@@ -2460,7 +2442,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves focus to the next focusable control.
+Move focus to the next focusable control.
</para>
</entry>
</row>
@@ -2471,7 +2453,7 @@
</entry>
<entry colname="colspec1">
<para>
-Moves focus to the previous focusable control.
+Move focus to the previous focusable control.
</para>
</entry>
</row>
@@ -2483,7 +2465,7 @@
</entry>
<entry colname="colspec1">
<para>
-Activates a button or submits a form.
+Activate a button or submit a form.
</para>
</entry>
</row>
@@ -2505,7 +2487,7 @@
<secondary>for menus</secondary>
</indexterm>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate menus.
+The following table lists the keyboard shortcuts that you can use to navigate menus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2524,12 +2506,12 @@
<tbody>
<row>
<entry valign="top">
-<para><keycap>up arrow</keycap> and <keycap>down
-arrow</keycap></para>
+<para><keycap>up arrow</keycap> and <keycap>down arrow</keycap>
+</para>
</entry>
<entry valign="top">
<para>
-Gives focus to the next or previous menu item on a menu.
+Give focus to the next or previous menu item on a menu.
</para>
</entry>
</row>
@@ -2541,10 +2523,10 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-If the menu item that has focus is a submenu, opens the submenu and gives focus to the first menu item on the submenu.
+If the menu item that has focus is a submenu, open the submenu and give focus to the first menu item on the submenu.
</para>
<para>
-If the menu item that has focus is not a submenu, opens the next menu on the menubar.
+If the menu item that has focus is not a submenu, open the next menu on the menubar.
</para>
</entry>
</row>
@@ -2556,10 +2538,10 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-If the menu item that has focus is a submenu item, switches the focus back to the submenu.
+If the menu item that has focus is a submenu item, switch the focus back to the submenu.
</para>
<para>
-If the menu item that has focus is not a submenu item, opens the previous menu on the menubar.
+If the menu item that has focus is not a submenu item, open the previous menu on the menubar.
</para>
</entry>
</row>
@@ -2571,7 +2553,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the focused menu item and closes the open menus.
+Select the focused menu item and close the open menus.
</para>
</entry>
</row>
@@ -2581,7 +2563,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the menu item that is associated with the access key and closes the menu.
+Select the menu item that is associated with the access key and close the menu.
</para>
</entry>
</row>
@@ -2593,7 +2575,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the focused menu item and closes the menu except when the menu item is a check box or radio button.
+Select the focused menu item and close the menu except when the menu item is a check box or radio button.
</para>
</entry>
</row>
@@ -2605,7 +2587,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the menu.
+Close the menu.
</para>
</entry>
</row>
@@ -2637,7 +2619,7 @@
</screenshot>
</figure>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate buttons.
+The following table lists the keyboard shortcuts that you can use to navigate buttons:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2662,7 +2644,7 @@
</entry>
<entry valign="top">
<para>
-Activates the button that has focus. This is the equivalent of clicking on the button.
+Activate the button that has focus. This is the equivalent of clicking on the button.
</para>
</entry>
</row>
@@ -2674,7 +2656,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Activates the button that has focus or, if no button has focus, performs the default action for the dialog.
+Activate the button that has focus or, if no button has focus, perform the default action for the dialog.
</para>
</entry>
</row>
@@ -2707,7 +2689,7 @@
</screenshot>
</figure>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate a set of radio buttons.
+The following table lists the keyboard shortcuts that you can use to navigate a set of radio buttons:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2730,7 +2712,7 @@
</entry>
<entry valign="top">
<para>
-Selects the next or previous radio button and deselects the other radio buttons in the group.
+Select the next or previous radio button and deselect the other radio buttons in the group.
</para>
</entry>
</row>
@@ -2763,7 +2745,7 @@
</screenshot>
</figure>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate a check box.
+The following table lists the keyboard shortcuts that you can use to navigate a check box:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2788,7 +2770,7 @@
</entry>
<entry valign="top">
<para>
-Selects or deselects the check box.
+Select or deselect the check box.
</para>
</entry>
</row>
@@ -2821,7 +2803,7 @@
</screenshot>
</figure>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate a single line text box.
+The following table lists the keyboard shortcuts that you can use to navigate a single line text box:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2846,7 +2828,7 @@
</entry>
<entry valign="top">
<para>
-Positions the cursor one character to the left.
+Position the cursor one character to the left.
</para>
</entry>
</row>
@@ -2858,7 +2840,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor one character to the right.
+Position the cursor one character to the right.
</para>
</entry>
</row>
@@ -2869,7 +2851,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the start of the current word. Press and hold <keycap>Ctrl</keycap> and continue to press <keycap>left arrow</keycap> to position the cursor at the start of the previous word.
+Position the cursor at the start of the current word. Press and hold <keycap>Ctrl</keycap> and continue to press <keycap>left arrow</keycap> to position the cursor at the start of the previous word.
</para>
</entry>
</row>
@@ -2880,7 +2862,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the end of the current word. Press and hold <keycap>Ctrl</keycap> and continue to press <keycap>right arrow</keycap> to position the cursor at the end of the next word.
+Position the cursor at the end of the current word. Press and hold <keycap>Ctrl</keycap> and continue to press <keycap>right arrow</keycap> to position the cursor at the end of the next word.
</para>
</entry>
</row>
@@ -2916,7 +2898,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects one character at a time to the left or right of the cursor.
+Select one character at a time to the left or right of the cursor.
</para>
</entry>
</row>
@@ -2929,7 +2911,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects one word at a time to the left or right of the cursor.
+Select one word at a time to the left or right of the cursor.
</para>
</entry>
</row>
@@ -2940,7 +2922,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all text to the left of the cursor.
+Select all text to the left of the cursor.
</para>
</entry>
</row>
@@ -2951,7 +2933,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all text to the right of the cursor.
+Select all text to the right of the cursor.
</para>
</entry>
</row>
@@ -2962,7 +2944,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all text in the text box.
+Select all text in the text box.
</para>
</entry>
</row>
@@ -2970,7 +2952,7 @@
</tgroup>
</informaltable>
<para>
-In addition to the keyboard shortcuts listed in the previous table, use the keyboard shortcuts in the following table to navigate multi-line text boxes.
+In addition to the keyboard shortcuts listed in the previous table, use the keyboard shortcuts in the following table to navigate multi-line text boxes:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -2995,7 +2977,7 @@
</entry>
<entry valign="top">
<para>
-Positions the cursor at the top of the current view. Press <keycap>Page Up</keycap> again to position the cursor at the top of the previous view.
+Position the cursor at the top of the current view. Press <keycap>Page Up</keycap> again to position the cursor at the top of the previous view.
</para>
</entry>
</row>
@@ -3007,7 +2989,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the end of the current view. Press <keycap>Page Down</keycap>
+Position the cursor at the end of the current view. Press <keycap>Page Down</keycap>
again to position the cursor at the end of the previous view.
</para>
</entry>
@@ -3019,7 +3001,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the start of the current paragraph. Press and hold <keycap>Ctrl</keycap> and continue to press the <keycap>up arrow</keycap> key to position the cursor at the start of the previous
+Position the cursor at the start of the current paragraph. Press and hold <keycap>Ctrl</keycap> and continue to press the <keycap>up arrow</keycap> key to position the cursor at the start of the previous
paragraph.
</para>
</entry>
@@ -3031,7 +3013,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the end of the current paragraph. Press and hold <keycap>Ctrl</keycap> and continue to press the <keycap>down arrow</keycap> key to position the cursor at the end of the next
+Position the cursor at the end of the current paragraph. Press and hold <keycap>Ctrl</keycap> and continue to press the <keycap>down arrow</keycap> key to position the cursor at the end of the next
paragraph.
</para>
</entry>
@@ -3043,7 +3025,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor one view width to the left.
+Position the cursor one view width to the left.
</para>
</entry>
</row>
@@ -3054,7 +3036,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor one view width to the right.
+Position the cursor one view width to the right.
</para>
</entry>
</row>
@@ -3065,7 +3047,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the start of the text box.
+Position the cursor at the start of the text box.
</para>
</entry>
</row>
@@ -3076,7 +3058,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Positions the cursor at the end of the text box.
+Position the cursor at the end of the text box.
</para>
</entry>
</row>
@@ -3087,7 +3069,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next control on the dialog.
+Give focus to the next control on the dialog.
</para>
</entry>
</row>
@@ -3098,7 +3080,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the start of the current view. Press and hold <keycap>Shift</keycap> and continue to press <keycap>Page Up</keycap> to extend the selection to the start of the previous view.
+Select the text to the start of the current view. Press and hold <keycap>Shift</keycap> and continue to press <keycap>Page Up</keycap> to extend the selection to the start of the previous view.
</para>
</entry>
</row>
@@ -3109,7 +3091,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the end of the current view. Press and hold <keycap>Shift</keycap> and continue to press <keycap>Page Down</keycap> to extend the selection to the end of the next view.
+Select the text to the end of the current view. Press and hold <keycap>Shift</keycap> and continue to press <keycap>Page Down</keycap> to extend the selection to the end of the next view.
</para>
</entry>
</row>
@@ -3120,7 +3102,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the start of the line.
+Select the text to the start of the line.
</para>
</entry>
</row>
@@ -3131,7 +3113,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the end of the line.
+Select the text to the end of the line.
</para>
</entry>
</row>
@@ -3143,7 +3125,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the start of the paragraph, then to the start of the previous paragraph.
+Select the text to the start of the paragraph, then to the start of the previous paragraph.
</para>
</entry>
</row>
@@ -3155,7 +3137,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the end of the paragraph, then to the end of the next paragraph.
+Select the text to the end of the paragraph, then to the end of the next paragraph.
</para>
</entry>
</row>
@@ -3167,7 +3149,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the start of the text box.
+Select the text to the start of the text box.
</para>
</entry>
</row>
@@ -3179,7 +3161,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the text to the end of the text box.
+Select the text to the end of the text box.
</para>
</entry>
</row>
@@ -3211,7 +3193,7 @@
</screenshot>
</figure>
<para>
-The keyboard shortcuts that you use to navigate the text box area of a spin box are listed in <xref linkend="keynav-28"/>. The following table lists the keyboard shortcuts that you can use to navigate the up and down arrows in the spin box.
+The keyboard shortcuts that you use to navigate the text box area of a spin box are listed in <xref linkend="keynav-28"/>. The following table lists the keyboard shortcuts that you can use to navigate the up and down arrows in the spin box:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3230,12 +3212,13 @@
<tbody>
<row>
<entry valign="top">
-<para><keycap>up arrow</keycap> or <keycap>down arrow
-</keycap></para>
+<para>
+<keycap>up arrow</keycap> or <keycap>down arrow</keycap>
+</para>
</entry>
<entry valign="top">
<para>
-Increases or decreases the value of the spin box by a small amount.
+Increase or decrease the value of the spin box by a small amount.
</para>
</entry>
</row>
@@ -3246,7 +3229,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Increases or decreases the value of the spin box by a large amount.
+Increase or decrease the value of the spin box by a large amount.
</para>
</entry>
</row>
@@ -3280,7 +3263,7 @@
</screenshot>
</figure>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate a drop-down list.
+The following table lists the keyboard shortcuts that you can use to navigate a drop-down list:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3329,7 +3312,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the previous list item.
+Select the previous list item.
</para>
</entry>
</row>
@@ -3341,7 +3324,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the next list item.
+Select the next list item.
</para>
</entry>
</row>
@@ -3353,7 +3336,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Closes the list without changing the selection.
+Close the list without changing the selection.
</para>
</entry>
</row>
@@ -3383,15 +3366,16 @@
format="PNG"/>
</imageobject>
<textobject>
-<phrase>Sample drop-down combination box.
-Contains a text box and an arrow button that you click to display the drop-down list.</phrase>
+<phrase>
+Sample drop-down combination box. Contains a text box and an arrow button that you click to display the drop-down list.
+</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<para>
When the text box has focus, use the keyboard shortcuts that are listed in <xref linkend="keynav-28"/> to navigate the text box area. When the text box has focus,
-you can also use the keyboard shortcuts in the following table to navigate the drop-down list area.
+you can also use the keyboard shortcuts in the following table to navigate the drop-down list area:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3416,7 +3400,7 @@
</entry>
<entry valign="top">
<para>
-Selects the previous item from the drop-down list without displaying the list.
+Select the previous item from the drop-down list without displaying the list.
</para>
</entry>
</row>
@@ -3428,7 +3412,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the next item from the drop-down list without displaying the list.
+Select the next item from the drop-down list without displaying the list.
</para>
</entry>
</row>
@@ -3439,14 +3423,16 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Opens the drop-down list.</para>
+<para>
+Open the drop-down list.
+</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
-When the drop-down list has focus, you can use the keyboard shortcuts that are listed in the following table to navigate the drop-down list.
+When the drop-down list has focus, you can use the keyboard shortcuts that are listed in the following table to navigate the drop-down list:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3471,7 +3457,7 @@
</entry>
<entry valign="top">
<para>
-Selects the previous list item.
+Select the previous list item.
</para>
</entry>
</row>
@@ -3483,7 +3469,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the next list item.
+Select the next list item.
</para>
</entry>
</row>
@@ -3495,7 +3481,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the first item in the list.
+Select the first item in the list.
</para>
</entry>
</row>
@@ -3507,7 +3493,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the last item in the list.
+Select the last item in the list.
</para>
</entry>
</row>
@@ -3519,7 +3505,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the item at the top of the current list view.
+Select the item at the top of the current list view.
</para>
</entry>
</row>
@@ -3531,7 +3517,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the item at the bottom of the current list view.
+Select the item at the bottom of the current list view.
</para>
</entry>
</row>
@@ -3543,7 +3529,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Accepts the current selection and closes the drop-down list.
+Accept the current selection and close the drop-down list.
</para>
</entry>
</row>
@@ -3554,7 +3540,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Scrolls to the left of the list, if required.
+Scroll to the left of the list, if required.
</para>
</entry>
</row>
@@ -3565,7 +3551,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Scrolls to the right of the list, if required.
+Scroll to the right of the list, if required.
</para>
</entry>
</row>
@@ -3599,7 +3585,7 @@
</screenshot>
</figure>
<para>
-The following table describes the keyboard shortcuts that you can use to navigate a slider.
+The following table describes the keyboard shortcuts that you can use to navigate a slider:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3623,7 +3609,7 @@
</entry>
<entry valign="top">
<para>
-Moves the slider left or up by a small amount.
+Move the slider left or up by a small amount.
</para>
</entry>
</row>
@@ -3634,7 +3620,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the slider right or down by a small amount.
+Move the slider right or down by a small amount.
</para>
</entry>
</row>
@@ -3646,7 +3632,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the slider left or up by a large amount.
+Move the slider left or up by a large amount.
</para>
</entry>
</row>
@@ -3658,7 +3644,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the slider right or down by a large amount.
+Move the slider right or down by a large amount.
</para>
</entry>
</row>
@@ -3670,7 +3656,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the slider to the maximum value.
+Move the slider to the maximum value.
</para>
</entry>
</row>
@@ -3682,7 +3668,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Moves the slider to the minimum value.
+Move the slider to the minimum value.
</para>
</entry>
</row>
@@ -3707,7 +3693,7 @@
</imageobject>
<textobject>
<phrase>
-Editing profile dialog from the GNOME <application>Terminal</application> application. Contains six tabbed sections.
+Editing profile dialog from the GNOME <application>Terminal</application> application; contains six tabbed sections.
</phrase>
</textobject>
</mediaobject>
@@ -3718,7 +3704,7 @@
called panels, pages, or tabs, and are sometimes collectively referred to as a tabstrip or notebook header. Each individual tab is identified by a text label.
</para>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate the tabbed sections of a window or dialog when a tabstrip has focus.
+The following table lists the keyboard shortcuts that you can use to navigate the tabbed sections of a window or dialog when a tabstrip has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3743,7 +3729,7 @@
</entry>
<entry valign="top">
<para>
-Gives focus to the previous tabbed section.
+Give focus to the previous tabbed section.
</para>
</entry>
</row>
@@ -3755,7 +3741,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next tabbed section.
+Give focus to the next tabbed section.
</para>
</entry>
</row>
@@ -3767,7 +3753,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the first control in the active section.
+Give focus to the first control in the active section.
</para>
</entry>
</row>
@@ -3776,7 +3762,7 @@
</informaltable>
<para>
The following table lists the keyboard shortcuts that you can use to navigate a
-window or dialog when a control within a section has focus.
+window or dialog when a control within a section has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3803,7 +3789,7 @@
</entry>
<entry valign="top">
<para>
-Gives focus to the previous section.
+Give focus to the previous section.
</para>
<para>
This keyboard shortcut does not work if the focused control uses <keycombo><keycap>Ctrl</keycap><keycap>Page Up</keycap></keycombo> for another purpose.
@@ -3820,7 +3806,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next section.
+Give focus to the next section.
</para>
<para>
This keyboard shortcut does not work if the focused control uses <keycombo><keycap>Ctrl</keycap><keycap>Page Down</keycap></keycombo> for another purpose.
@@ -3834,7 +3820,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next control outside the sections.
+Give focus to the next control outside the sections.
</para>
</entry>
</row>
@@ -3850,7 +3836,7 @@
<secondary>for lists</secondary>
</indexterm>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate multi-column lists when a column header has focus.
+The following table lists the keyboard shortcuts that you can use to navigate multi-column lists when a column header has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3869,12 +3855,13 @@
<tbody>
<row>
<entry valign="top">
-<para><keycap>left arrow</keycap> or <keycap>right
-arrow</keycap></para>
+<para>
+<keycap>left arrow</keycap> or <keycap>right arrow</keycap>
+</para>
</entry>
<entry valign="top">
<para>
-Gives focus to the previous or next column header.
+Give focus to the previous or next column header.
</para>
</entry>
</row>
@@ -3886,7 +3873,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Activates the header. This action usually sorts the list by the column header.
+Activate the header. This action usually sorts the list by the column header.
</para>
</entry>
</row>
@@ -3898,7 +3885,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the list contents.
+Give focus to the list contents.
</para>
</entry>
</row>
@@ -3906,7 +3893,7 @@
</tgroup>
</informaltable>
<para>
-The following table lists the keyboard shortcuts that you can use to navigate lists when the contents of the list has focus.
+The following table lists the keyboard shortcuts that you can use to navigate lists when the list area has focus:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -3929,7 +3916,7 @@
</entry>
<entry valign="top">
<para>
-Selects the next or previous row or column.
+Select the next or previous row or column.
</para>
</entry>
</row>
@@ -3941,7 +3928,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the top row of the list contents that are currently in view. Press <keycap>Page Up</keycap> again to select the top row of the previous view.
+Select the top row of the list contents that are currently in view. Press <keycap>Page Up</keycap> again to select the top row of the previous view.
</para>
</entry>
</row>
@@ -3953,7 +3940,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects the bottom row of the list contents that are currently in view. Press <keycap>Page Down</keycap> again to select the bottom row of the next view.
+Select the bottom row of the list contents that are currently in view. Press <keycap>Page Down</keycap> again to select the bottom row of the next view.
</para>
</entry>
</row>
@@ -3964,7 +3951,9 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Selects the first row in the list.</para>
+<para>
+Select the first row in the list.
+</para>
</entry>
</row>
<row>
@@ -3974,7 +3963,9 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Selects the last row in the list.</para>
+<para>
+Select the last row in the list.
+</para>
</entry>
</row>
<row>
@@ -3984,10 +3975,10 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-For lists that support multi-line selections, adds the next or previous row or column to the current selection.
+For lists that support multi-line selections, add the next or previous row or column to the current selection.
</para>
<para>
-For lists that only allow single line selections, selects the next or previous row or column.
+For lists that only allow single line selections, select the next or previous row or column.
</para>
</entry>
</row>
@@ -3998,7 +3989,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all the rows between the current selection and the top row of the view.
+Select all the rows between the current selection and the top row of the view.
</para>
</entry>
</row>
@@ -4009,7 +4000,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all the rows between the current selection and the bottom row of the view.
+Select all the rows between the current selection and the bottom row of the view.
</para>
</entry>
</row>
@@ -4020,7 +4011,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all the rows between the current selection and the first row in the list.
+Select all the rows between the current selection and the first row in the list.
</para>
</entry>
</row>
@@ -4031,18 +4022,19 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Selects all the rows between the current selection and the last row in the list.
+Select all the rows between the current selection and the last row in the list.
</para>
</entry>
</row>
<row>
<entry colname="colspec0" valign="top">
-<para><keycap>Ctrl</keycap> +
-arrow keys</para>
+<para>
+<keycap>Ctrl</keycap> + arrow keys
+</para>
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the next row or column but does not extend the selection. Further items can be selected by pressing <keycap>spacebar</keycap>.
+Give focus to the next row or column without extending the selection. Further items can be selected by pressing <keycap>spacebar</keycap>.
</para>
</entry>
</row>
@@ -4053,7 +4045,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the top row in the view but does not extend the selection.
+Give focus to the top row in the view without extending the selection.
</para>
</entry>
</row>
@@ -4064,7 +4056,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the bottom row in the view but does not extend the selection.
+Give focus to the bottom row in the view without extending the selection.
</para>
</entry>
</row>
@@ -4075,7 +4067,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the first row in the list but does not extend the selection.
+Give focus to the first row in the list without extending the selection.
</para>
</entry>
</row>
@@ -4086,7 +4078,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the last row in the list but does not extend the selection.
+Give focus to the last row in the list without extending the selection.
</para>
</entry>
</row>
@@ -4098,7 +4090,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Activates the item(s).
+Activate the item(s).
</para>
</entry>
</row>
@@ -4109,7 +4101,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-For lists that support multi-line selections, selects all rows in the list.
+Select all rows (for lists that support multi-line selections).
</para>
</entry>
</row>
@@ -4120,7 +4112,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Gives focus to the column header, if applicable.
+Give focus to the column header, if applicable.
</para>
</entry>
</row>
@@ -4142,14 +4134,16 @@
<imagedata fileref="figures/tree.png" format="PNG"/>
</imageobject>
<textobject>
-<phrase>Categories tree from the <application>gedit</application> Preferences dialog. Contains three subcategories.</phrase>
+<phrase>
+Categories tree from the <application>gedit</application> preferences dialog; contains three subcategories.
+</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<para>
To navigate trees, you can use the same keyboard shortcuts that are listed in
-<xref linkend="keynav-34"/>. In addition, the following table lists the keyboard shortcuts you can use for the tree items.
+<xref linkend="keynav-34"/>. In addition, the following table lists the keyboard shortcuts you can use for the tree items:
</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
@@ -4172,7 +4166,7 @@
</entry>
<entry valign="top">
<para>
-Expands the focused item.
+Expand the focused item.
</para>
</entry>
</row>
@@ -4182,7 +4176,7 @@
</entry>
<entry colname="colspec1" valign="top">
<para>
-Collapses the focused item.
+Collapse the focused item.
</para>
</entry>
</row>
@@ -4193,7 +4187,9 @@
</para>
</entry>
<entry colname="colspec1" valign="top">
-<para>Selects the parent item.</para>
+<para>
+Select the parent item.
+</para>
</entry>
</row>
<row>
@@ -4202,7 +4198,7 @@
</entry>
<entry colname="colspec1">
<para>
-Displays a search dialog allowing you to type the name of the tree item that you want to find. Not all trees support searching.
+Display a search dialog, allowing you to type the name of the tree item that you want to find. Not all trees support searching.
</para>
</entry>
</row>
@@ -4219,15 +4215,14 @@
<secondary>customizing</secondary>
</indexterm>
<para>
-Use the <application>Keyboard Shortcuts</application> preference tool to display the default keyboard shortcuts that you use to navigate the GNOME Desktop. You can customize the default keyboard shortcuts to meet your requirements. You can also create hot keys,
-keyboard shortcuts which start applications.
+Use the <application>Keyboard Shortcuts</application> preference tool to display the default keyboard shortcuts that you use to navigate the GNOME Desktop. You can customize the default keyboard shortcuts to meet your requirements. You can also create hot keys (keyboard shortcuts which start applications).
</para>
<para>
To start the <application>Keyboard Shortcuts
</application> preference tool, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences
</guisubmenu><guimenuitem>Keyboard Shortcuts
</guimenuitem></menuchoice>. The <guilabel>
-Desktop shortcuts</guilabel> table lists the keyboard shortcut that is associated with each action.
+Desktop shortcuts</guilabel> table lists the keyboard shortcuts that are associated with each action.
</para>
<section id="keynav-49">
Modified: trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml (original)
+++ trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml Wed May 21 16:48:26 2008
@@ -20,11 +20,7 @@
<bookinfo>
<abstract role="description">
<para>
-The GNOME Accessibility Guide is for users, system
-administrators, and anyone who is interested in how the
-GNOME Desktop supports people with disabilities and
-addresses the requirements of Section 508 of the U.S.
-Rehabilitation Act.
+The GNOME Accessibility Guide is for users, system administrators, and anyone else who is interested in how the GNOME Desktop supports people with disabilities. This guide also addresses the requirements of Section 508 of the U.S. Rehabilitation Act.
</para>
</abstract>
<copyright>
@@ -249,4 +245,4 @@
then uncomment <index/> line below -->
<!-- <index/> -->
-</book>
\ No newline at end of file
+</book>
Modified: trunk/gnome2-accessibility-guide/C/legal.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/legal.xml (original)
+++ trunk/gnome2-accessibility-guide/C/legal.xml Wed May 21 16:48:26 2008
@@ -1,77 +1,31 @@
<legalnotice id="legalnotice">
-
<para>
-Permission is granted to copy, distribute and/or modify
-this document under the terms of the GNU Free
-Documentation License (GFDL), Version 1.1 or any later
-version published by the Free Software Foundation with
-no Invariant Sections, no Front-Cover Texts, and no
-Back-Cover Texts. You can find a copy of the GFDL
-<ulink type="help" url="ghelp:fdl"> here</ulink> or in
-the file COPYING-DOCS distributed with this manual.
+Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL
+<ulink type="help" url="ghelp:fdl"> here</ulink> or in the file COPYING-DOCS distributed with this manual.
</para>
-
<para>
-This manual is part of a collection of GNOME manuals
-distributed under the GFDL. If you want to distribute
-this manual separately from the collection, you can do
-so by adding a copy of the license to the manual, as
+This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as
described in Section 6 of the license.
</para>
-
<para>
-Many of the names used by companies to distinguish
-their products and services are claimed as trademarks.
-Where those names appear in any GNOME documentation,
-and the members of the GNOME Documentation Project are
-made aware of those trademarks, then the names are in
-capital letters or initial capital letters.
+Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.
</para>
-
<para>
-DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE
-PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION
-LICENSE WITH THE FURTHER UNDERSTANDING THAT:
-
+DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:
<orderedlist>
<listitem>
<para>
-DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT
-WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
-INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE
-DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE
-OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE
-OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY,
-ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED
-VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY
-DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY
-RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
-CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING,
-REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY
-CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE
-OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS
-AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND
+DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY
+RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND
</para>
</listitem>
-
<listitem>
<para>
-UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY,
-WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR
-OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY
-CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR
-MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF
-ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY
-DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION,
-DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER
-FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
-LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT
-AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH
-PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF
-SUCH DAMAGES.
+UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR
+MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION,
+DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.
</para>
</listitem>
</orderedlist>
</para>
-</legalnotice>
\ No newline at end of file
+</legalnotice>
Modified: trunk/gnome2-accessibility-guide/C/low-vision.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/low-vision.xml (original)
+++ trunk/gnome2-accessibility-guide/C/low-vision.xml Wed May 21 16:48:26 2008
@@ -1,60 +1,31 @@
<chapter id="low-vision">
<title>Low Vision or Blindness</title>
-
<para>
-From low vision to blindness, the range of visual
-limitations is broad. Symptoms of low vision include
-dimness, haziness, extreme far-/near-sightedness,
-color blindness, and tunnel vision, among others.
-People with these disabilities are
-concerned with being able to see text or images on a
-computer screen and being able to perform tasks that
-require eye-hand coordination, such as moving a
-computer mouse. Text size and color can make a big
-difference in legibility for people with low vision.
+From low vision to blindness, the range of visual limitations is broad. Symptoms of low vision include dimness, haziness, extreme far-/near-sightedness, color blindness, and tunnel vision, among others. People with these disabilities are concerned with being able to see text or images on a computer screen and being able to perform tasks that
+require eye-hand coordination, such as moving a computer mouse. Text size and color can make a big difference in legibility for people with low vision.
</para>
-
<para>
-The technologies that can assist those with low vision
-or blindness are:
+The technologies that can assist those with low vision or blindness are:
</para>
<itemizedlist>
<listitem>
<para>
-<emphasis>
-Screen Magnifier
-</emphasis>
- - this is like a magnifying glass. People using them
-are able to control what area of the computer screen
-they want enlarged, and can move the magnifier to view
-different areas of the screen. They are also known as
-screen enlargers or large print programs.
+<emphasis>Screen Magnifier</emphasis> - this is like a magnifying glass. People using them
+are able to control what area of the computer screen they want enlarged, and can move the magnifier to view different areas of the screen. They are also known as screen enlargers or large print programs.
</para>
</listitem>
-
<listitem>
<para>
-<emphasis>
-Screen Reader
-</emphasis>
- - this makes on-screen information available as
-synthesized speech and/or a refreshable Braille display.
-They generally only translate text-based information.
-Graphics and other non-textual objects can be
+<emphasis>Screen Reader</emphasis> - this makes on-screen information available as
+synthesized speech and/or a refreshable Braille display. They generally only translate text-based information. Graphics and other non-textual objects can be
translated if there is alternative text
describing the item. They are also known as
blind access utilities or screen reviewers.
</para>
</listitem>
-
<listitem>
<para>
-<emphasis>
-Desktop Appearance Enhancement
-</emphasis>
- - users can configure the desktop to be easy to read;
-for example, by increasing text size and using high
-contrast themes.
+<emphasis>Desktop Appearance Enhancement</emphasis> - users can configure the desktop to be easy to read; for example, by increasing text size and using high-contrast themes.
</para>
</listitem>
</itemizedlist>
@@ -67,104 +38,66 @@
<indexterm>
<primary>Orca</primary>
</indexterm>
-
<para>
-The <application>Orca Screen Reader and Magnifier
-</application> application enables users with limited
-vision or no vision to use the GNOME Desktop and
-associated applications. <application>Orca</application>
-provides the following functionality:
+The <application>Orca Screen Reader and Magnifier</application> application enables users with limited or no vision to use the GNOME Desktop and associated applications. <application>Orca</application> provides the following functionality:
</para>
-
<itemizedlist>
<listitem>
<para>
Screen Reader
</para>
-
<para>
-The screen reader enables non-visual access to standard
-applications in the GNOME Desktop, using speech and
-Braille output.
+The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and Braille output.
</para>
</listitem>
-
<listitem>
<para>
Magnifier
</para>
-
<para>
-The magnifier provides automated focus tracking and
-full-screen magnification to aid low-vision users.
+The magnifier provides automated focus tracking and full-screen magnification to aid low-vision users.
</para>
</listitem>
</itemizedlist>
-
<para>
-The following sections provide information about Orca
-and how to use it.
+The following sections provide information about <application>Orca</application> and how to use it.
</para>
<section>
<title>Introduction to Orca</title>
<section>
<title>What is Orca?</title>
-
<para>
-Orca is a flexible, extensible, and powerful assistive
-technology for people with visual impairments. Using
-various combinations of speech synthesis, Braille and
-magnification, Orca helps provide access to applications
-and toolkits that support the AT-SPI (e.g., the GNOME
-Desktop). Orca is also free open source software.
+Orca is a flexible, extensible, and powerful assistive technology for people with visual impairments. Using various combinations of speech synthesis, Braille and magnification, Orca helps provide access to applications
+and toolkits that support the AT-SPI (e.g., the GNOME Desktop). <application>Orca</application> is also free open source software.
</para>
</section>
<section>
<title>Why the name Orca?</title>
-
<para>
-One of the first DOS screen readers was Flipper, made by
-Omnichron Corporation in Berkeley, CA. It was named
-Flipper in part because the blind wife of the programmer
-envisioned computers as being programmed by flipping
-switches (an accurate image of a bygone era). Then came
-another DOS screen reader, this one from Henter-Joyce in
-Florida - "Jobs Access With Speech" (or JAWS). And so
-on....
+One of the first DOS screen readers was Flipper, made by Omnichron Corporation in Berkeley, CA. It was named Flipper in part because the blind wife of the programmer
+envisioned computers as being programmed by flipping switches (an accurate image of a bygone era). Then came another DOS screen reader, this one from Henter-Joyce in
+Florida - "Jobs Access With Speech" (or JAWS). And so on....
</para>
-
<para>
-Although no obvious connection exists between blindness
-and creatures from the sea, there is certainly a naming
-tradition for screen-reader software. Hence Orca, which
-is a lot tougher-sounding than Nemo, Ariel, Willy,
-or Mr. Limpet.
+Although no obvious connection exists between blindness and creatures from the sea, there is certainly a naming tradition for screen-reader software. Hence <application>Orca</application>, which is a lot tougher-sounding than Nemo, Ariel, Willy, or Mr. Limpet.
</para>
</section>
<section>
<title>What's the schedule?</title>
-
<para>
-Orca is part of the GNOME platform and Orca's releases
-are coupled with the releases of the GNOME platform.
+<application>Orca</application> is part of the GNOME platform and <application>Orca</application>'s releases are coupled with the releases of the GNOME platform.
</para>
</section>
<section>
<title>How do I request a new feature?</title>
<para>
-<ulink url="http://bugzilla.gnome.org/buglist.cgi?
-query=product:orca+">
-Bugs</ulink> and feature/enhancement requests (RFEs)
-should be reported to the
-<ulink url="http://bugzilla.gnome.org";>
-GNOME Bug Tracking System
-</ulink>. Patches are always welcome, and instructions
-for creating patches can be found in the
-<ulink url="http://developer.gnome.org/tools/svn.html";>
+<ulink url="http://bugzilla.gnome.org/buglist.cgi?query=product:orca+";>Bugs</ulink> and feature/enhancement requests (RFEs)
+should be reported to the <ulink url="http://bugzilla.gnome.org";>GNOME Bug Tracking System
+</ulink>. Patches are always welcome, and instructions for creating patches can be found in the <ulink url="http://developer.gnome.org/tools/svn.html";>
GNOME Introduction to Subversion (SVN)
</ulink>.
</para>
@@ -172,31 +105,18 @@
<section>
<title>Where is the discussion list?</title>
-
<para>
-You can get in touch with developers and other users by
-<ulink url="mailto:orca-list gnome org">
-sending an e-mail
-</ulink> to the
-<ulink url="http://mail.gnome.org/mailman/listinfo/
-orca-list">
-Orca mailing list</ulink>
-(
-<ulink url="http://mail.gnome.org/archives/orca-list";>
-Archives
-</ulink>).
+You can get in touch with developers and other users by <ulink url="mailto:orca-list gnome org">sending an e-mail</ulink> to the <ulink url="http://mail.gnome.org/mailman/listinfo/orca-list";>Orca mailing list</ulink>
+(
+<ulink url="http://mail.gnome.org/archives/orca-list";>Archives</ulink>).
</para>
</section>
<section>
<title>Is Braille supported?</title>
<para>
-Yes! Braille is supported via BrlTTY and it is tightly
-integrated with Orca. BrlTTY offers support for nearly
-every refreshable Braille display known to man. Please
-refer to the
-<ulink url="ghelp:orca#braille">
-Braille page
+Yes! Braille is supported via BrlTTY and it is tightly integrated with Orca. BrlTTY offers support for nearly every refreshable Braille display known to man. Refer to the
+<ulink url="ghelp:orca#braille">Braille page
</ulink> for more information.
</para>
</section>
@@ -204,70 +124,44 @@
<section>
<title>Are Grade 2 Braille contractions supported?</title>
<para>
-Yes, Orca fully supports contracted Braille output.
+Yes, <application>Orca</application> fully supports contracted Braille output.
</para>
</section>
<section>
<title>What voices are available?</title>
<para>
-Orca provides interfaces to both
-<userinput>gnome-speech</userinput> and
-<userinput>emacspeak</userinput> speech services. As
-such, the available voices for Orca are only restricted
-by the speech engines supported by the available speech
-services. For free speech engines, you typically have a
-choice of the eSpeak, Festival, and FreeTTS speech
-engines. For commercial engines, you have a choice of
-additional engines such as Fonix DECtalk, Loquendo,
-Eloquence, Cepstral and IBMTTS, with others on the way.
-Periodically check the <userinput>gnome-speech
-</userinput> package for more progress in this area.
+<application>Orca</application> provides interfaces to both <userinput>gnome-speech</userinput> and <userinput>emacspeak</userinput> speech services. As such, the available voices for <application>Orca</application> are only restricted by the speech engines supported by the available speech services. For free speech engines, you typically have a choice of the eSpeak, Festival, and FreeTTS speech engines. For commercial engines, you have a choice of
+additional engines such as Fonix DECtalk, Loquendo, Eloquence, Cepstral and IBMTTS, with others on the way. Periodically check the <userinput>gnome-speech</userinput> package for more progress in this area.
</para>
</section>
<section>
<title>What languages are supported?</title>
<para>
-The
-<ulink url="http://l10n.gnome.org/teams";>
-GNOME translation teams</ulink> are composed of many
-passionate volunteers from around the world. These teams
-do a great job and keep an up-to-date status report.
-Please see the
-<ulink url="http://l10n.gnome.org/module/orca";>
-Orca translation status page</ulink> for the large
-number of languages into which Orca has been translated.
+The <ulink url="http://l10n.gnome.org/teams";>
+GNOME translation teams</ulink> are composed of many passionate volunteers from around the world. These teams do a great job and keep an up-to-date status report. See the <ulink url="http://l10n.gnome.org/module/orca";>
+Orca translation status page</ulink> for the large number of languages into which <application>Orca</application> has been translated.
</para>
<para>
Note: support for a language also depends on
-the speech synthesis engine also supporting the same
-language.
+the speech synthesis engine also supporting the same language.
</para>
</section>
<section>
<title>How well does magnification work?</title>
<para>
-Orca currently uses the
-<userinput>gnome-mag</userinput>
-magnification service.
-<userinput>gnome-mag</userinput> has incorporated
-support for smoother full-screen magnification, which
-relies upon newer extensions in the X Window System
-server. These extensions do not always function well on
-all platforms, so smooth full-screen magnification may
-not always work.
+<application>Orca</application> currently uses the <userinput>gnome-mag</userinput>
+magnification service. <userinput>gnome-mag</userinput> has incorporated support for smoother full-screen magnification, which
+relies upon newer extensions in the X Window System server. These extensions do not always function well on all platforms, so smooth full-screen magnification may not always work.
</para>
</section>
<section>
<title>How is web access coming along?</title>
<para>
-Orca targets the Firefox web browser (version 3) for
-providing accessible web browsing. Both the Orca and
-Firefox teams are fully dedicated in this cooperative
-effort.
+<application>Orca</application> targets the <application>Firefox</application> web browser (version 3) for providing accessible web browsing. Both the <application>Orca</application> and <application>Firefox</application> teams are fully dedicated in this cooperative effort.
</para>
</section>
</section>
@@ -277,87 +171,43 @@
<section>
<title>Initial Setup</title>
<para>
-When you run Orca for the first time, it will
-automatically enter setup mode. If you want to run setup
+When you run <application>Orca</application> for the first time, it will automatically enter setup mode. If you want to run setup
at some later point, you can pass the
-<userinput>--setup</userinput> option to Orca the next
-time you run it. Furthermore, while Orca is running,
-you can press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Space</keycap>
-</keycombo> to bring up the Orca setup window. Finally,
-Orca provides a text setup utility that you can start
-by passing the
-<userinput>--text-setup</userinput> option to Orca. All
-of these options will create a
-<userinput>~/.orca/user-settings.py</userinput> file
-that holds your preferences and will also enable the
-accessibility infrastructure. You need to log out and
-log back in for the new settings to take effect.
+<userinput>--setup</userinput> option to <application>Orca</application> the next
+time you run it. Furthermore, while <application>Orca</application> is running,
+you can press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up the <application>Orca</application> setup window. Finally, <application>Orca</application> provides a text setup utility that you can start by passing the
+<userinput>--text-setup</userinput> option to <application>Orca</application>. All of these options will create a <userinput>~/.orca/user-settings.py</userinput> file that holds your preferences and will also enable the accessibility infrastructure. You need to log out and log back in for the new settings to take effect.
</para>
</section>
<section>
<title>How do I run Orca?</title>
<para>
-Run Orca by typing <userinput>orca</userinput> in a
-terminal session window. You can do so from a virtual
-console window if you do not yet have access to the GUI.
-With the GUI installed you can also press
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>F2</keycap>
-</keycombo> to bring up the Run dialog and then enter
-<userinput>orca</userinput>
-as the command (followed by any optional parameters).
-Orca will automatically enter text setup mode if you run
-it from a virtual console window or your GUI
-environment is not yet set up for accessibility.
+Run <application>Orca</application> by typing <userinput>orca</userinput> in a terminal session window. You can do so from a virtual
+console window if you do not yet have access to the GUI. With the GUI installed you can also press <keycombo><keycap>Alt</keycap>
+<keycap>F2</keycap></keycombo> to bring up the Run dialog and then enter <userinput>orca</userinput> as the command (followed by any optional parameters). <application>Orca</application> will automatically enter text setup mode if you run it from a virtual console window or your GUI environment is not yet set up for accessibility.
</para>
</section>
<section>
<title>Quitting Orca</title>
<para>
-To quit Orca, press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Q</keycap>
-</keycombo>.
-A confirmation dialog will appear. Select Yes to quit.
-If the system seems unresponsive, you can try a few
-things:
+To quit <application>Orca</application>, press <keycombo><keycap>Insert</keycap>
+<keycap>Q</keycap></keycombo>. A confirmation dialog will appear. Select <guilabel>Yes</guilabel> to quit. If the system seems unresponsive, you can try a few things:
</para>
<itemizedlist>
<listitem>
<para>
-Run <userinput>orca --quit</userinput> from a terminal
-window, such as a virtual console: press
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>Alt</keycap>
-<keycap>F1</keycap>
-</keycombo> (on most Linux platforms) to get to a
-virtual console, enter your commands, and then use
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>F7</keycap>
-</keycombo>
-to get back to the desktop. This will kill the Orca
-process and reclaim system resources. You can then
-rerun Orca using the previously outlined methods.
+Run <userinput>orca --quit</userinput> from a terminal window, such as a virtual console; press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>F1</keycap>
+</keycombo> (on most Linux platforms) to get to a virtual console, enter your commands, and then use <keycombo><keycap>Alt</keycap>
+<keycap>F7</keycap></keycombo> to get back to the desktop. This will kill the <application>Orca</application> process and reclaim system resources. You can then
+rerun <application>Orca</application> using the previously outlined methods.
</para>
<para>
-Press
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>Alt</keycap>
-<keycap>Backspace</keycap>
-</keycombo>
-to end your login session and get back to the
-graphical login prompt (not implemented in all
-Linux distributions).
+Press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>Backspace</keycap>
+</keycombo> to end your login session and get back to the graphical login prompt (not implemented in all Linux distributions).
</para>
</listitem>
</itemizedlist>
@@ -370,28 +220,18 @@
<section>
<title>How do I define my own keybindings?</title>
<para>
-You can redefine your key bindings for Orca
-in two main ways. The first way is to choose between the
-Desktop and Laptop layouts, which can be selected on the
-General page of the Orca Configuration GUI (press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Space</keycap>
-</keycombo>
-to bring up Orca Preferences). For more refined
+You can redefine your key bindings for <application>Orca</application> in two main ways. The first way is to choose between the
+Desktop and Laptop layouts, which can be selected on the General page of the <application>Orca</application> configuration dialog (press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up Orca Preferences). For more refined
control, you can set individual key bindings
-on the Key Bindings page of the Orca Configuration
+on the Key Bindings page of the <application>Orca</application> configuration
dialog.
</para>
</section>
<section>
-<title>Use a keyboard command to make Orca speak or
-Braille-output the current date and time</title>
+<title>Use a keyboard command to make Orca speak or Braille-output the current date and time</title>
<para>
-Place the following lines in
-<userinput>~/.orca/orca-customizations.py</userinput>.
-If this file doesn't exist yet, go ahead and create it.
+Place the following lines in <userinput>~/.orca/orca-customizations.py</userinput>. If this file doesn't exist yet, go ahead and create it.
</para>
<screen>
<![CDATA[
@@ -431,13 +271,7 @@
</screen>
<para>
-Note that in this case
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>D</keycap>
-</keycombo>
-will be used to report current information about the
-time and date.
+Note that in this case <keycombo><keycap>Insert</keycap><keycap>D</keycap></keycombo> will be used to report current information about the time and date.
</para>
</section>
@@ -445,132 +279,78 @@
<title>How do I set up my own custom scripts?</title>
<para>
Create an empty file named
-<userinput>~/.orca/orca-scripts/__init__.py</userinput>
-and place your custom scripts in
+<userinput>~/.orca/orca-scripts/__init__.py</userinput> and place your custom scripts in
<userinput>~/.orca/orca-scripts</userinput>
-, Orca will pick up any scripts from there before
-looking in the installed area.
+, <application>Orca</application> will pick up any scripts from there before looking in the installed area.
</para>
</section>
<section>
<title>Orca Configuration</title>
<para>
-The Orca Configuration dialog allows you to customize
-the behavior and features of Orca, such as speech,
-Braille, and magnification. For example, you can select
-which speech synthesis engine you want to use, whether
-Braille is enabled or not, and which magnification
-preferences
-you want. You can select between laptop/desktop keyboard
-layouts and you can also examine
-and modify the existing keyboard layout with granular
-control. To bring up the Orca Configuration dialog,
-press
-<keycombo>
-<keycap><ORCA MODIFIER></keycap>
-<keycap>Space</keycap>
-</keycombo>, where
-<userinput><ORCA MODIFIER></userinput> is
-<keycap>Insert</keycap>
-when you use the desktop key bindings, and
-<keycap>Caps Lock</keycap>
-when you use the laptop key bindings.
+The <application>Orca</application> configuration dialog allows you to customize
+the behavior and features of <application>Orca</application>, such as speech, Braille, and magnification. For example, you can select which speech synthesis engine you want to use, whether
+Braille is enabled or not, and which magnification preferences you want. You can select between Laptop/Desktop keyboard
+layouts and you can also examine and modify the existing keyboard layout with granular
+control. To bring up the <application>Orca</application> configuration dialog, press
+<keycombo><keycap><ORCA MODIFIER></keycap><keycap>Space</keycap></keycombo>, where <userinput><ORCA MODIFIER></userinput> is <keycap>Insert</keycap>
+when you use the Desktop key bindings, and
+<keycap>Caps Lock</keycap> when you use the Laptop key bindings.
</para>
<para>
-The Orca Configuration dialog is a multi-tab
+The <application>Orca</application> configuration dialog is a multi-tab
container for several pages, each of which is
described in the following sections.
</para>
<section>
<title>General Page</title>
-<para>The General page allows you to customize general
-aspects of Orca. These include the following:
+<para>The General page allows you to customize general aspects of <application>Orca</application>. These include the following:
</para>
<section>
<title>Keyboard Layout</title>
<para>
-The keyboard layout section lets you choose between a small keyboard layout (laptop) or large keyboard layout with a numeric keypad (desktop). If you choose Laptop the Orca system key is CapsLock; for the Desktop layout
-the Orca system key is Insert.
+The keyboard layout section lets you choose between a small keyboard layout (Laptop) or large keyboard layout with a numeric keypad (Desktop). If you choose Laptop the <application>Orca</application> system key is CapsLock; for the Desktop layout the system key is Insert.
</para>
</section>
<section>
<title>Show Orca Main Window</title>
<para>
-The Orca main window provides you with a graphical way
-to display the Orca Configuration dialog (also obtained
-by <keycombo><keycap>Insert</keycap>
-<keycap>Space</keycap></keycombo>). Many users do not like the Orca main window because it shows up in the window manager's tab order when you press
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>Tab</keycap>
-</keycombo> to switch windows. By deselecting the <guilabel>Show Orca Main Window</guilabel> option, you can tell Orca to not show the Orca main window.
+The <application>Orca</application> main window provides you with a graphical way
+to display the <application>Orca</application> configuration dialog (also obtained by <keycombo><keycap>Insert</keycap>
+<keycap>Space</keycap></keycombo>). Many users do not like the <application>Orca</application> main window because it shows up in the window manager's tab order when you press <keycombo><keycap>Alt</keycap>
+<keycap>Tab</keycap></keycombo> to switch windows. By deselecting the <guilabel>Show Orca Main Window</guilabel> option, you can tell <application>Orca</application> to not show its main window.
</para>
</section>
<section>
<title>Quit Orca without Confirmation</title>
<para>
-Normally when you press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Q</keycap>
-</keycombo>
-or press the
-<guibutton>Quit</guibutton>
-button in the Orca main window, Orca will pop up a
-confirmation dialog asking you if you want to quit.
-Unchecking this option prevents the confirmation
-window from appearing.
+Normally when you press <keycombo><keycap>Insert</keycap><keycap>Q</keycap></keycombo> or press the <guibutton>Quit</guibutton> button in the <application>Orca</application> main window, a confirmation dialog will prompt if you really want to quit. Unchecking this option prevents the confirmation window from appearing.
</para>
</section>
<section>
<title>Disable gksu keyboard grab</title>
<para>
-When running system administration commands from the
-launch menu, many distributions use an application
-known as
-<application>gksu</application>
-to authorize the user to run these commands (
-<application>gksu</application>
-is the dialog that asks you for your password). When it
-runs,
-<application>gksu</application>
-enables what is known as a "keyboard grab," which is a
-feature to prevent keyboard actions from going to any
-other application on the desktop, including Orca. The
-result of a keyboard grab is that Orca will not receive
-any keyboard events, preventing Orca from functioning
-normally.
-</para>
-<para>By selecting the
-<guibutton>Disable gksu Keyboard Grab</guibutton>
-button, you will turn off the keyboard grab behavior,
-allowing Orca to function normally with system
-administration applications.
+When running system administration commands from the launch menu, many distributions use an application known as <application>gksu</application> to authorize the user to run these commands (<application>gksu</application> is the dialog that asks you for your password). When it runs, <application>gksu</application> enables what is known as a "keyboard grab," which is a
+feature to prevent keyboard actions from going to any other application on the desktop, including <application>Orca</application>. The result of a keyboard grab is that <application>Orca</application> will not receive any keyboard events, preventing <application>Orca</application> from functioning normally.
+</para>
+<para>
+By selecting the <guibutton>Disable gksu Keyboard Grab</guibutton> button, you will turn off the keyboard grab behavior,
+allowing <application>Orca</application> to function normally with system administration applications.
</para>
<note>
<para>
The keyboard grab is a security attempt by
-<application>gksu</application>to prevent nefarious
-applications from "sniffing" the keyboard and obtaining
-your password. Please be advised that disabling
-<application>gksu</application>'s keyboard grab feature
-can expose you to such nefarious behavior.
+<application>gksu</application> to prevent malicious applications from "sniffing" the keyboard and obtaining your password. Please be advised that disabling <application>gksu</application>'s keyboard grab feature can expose you to such nefarious behavior.
</para>
-
<para>
-If you do not feel comfortable with this, you can always
-use the root account for system administration purposes.
-To do so, you need to enable the root account for login,
-and then log out and back in again as root whenever you
-want to perform a system administration command.
+If you do not feel comfortable with this, you can always use the root account for system administration purposes. To do so, you need to enable the root account for login, and then log out and back in again as root whenever you want to perform a system administration command.
</para>
</note>
</section>
@@ -578,16 +358,7 @@
<section>
<title>Present Tooltips</title>
<para>
-When checked, this option will tell Orca to present
-information about tooltips when they appear as the
-result of mouse hovering. Specific actions to force
-tooltips to appear, such as pressing
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>F1</keycap>
-</keycombo>
-when an object has focus, will always result in tooltips
-being presented, regardless of this setting.
+When checked, this option will tell <application>Orca</application> to present information about tooltips when they appear as the result of mouse hovering. Specific actions to force tooltips to appear, such as pressing <keycombo><keycap>Ctrl</keycap><keycap>F1</keycap></keycombo> when an object has focus, will always result in tooltips being presented, regardless of this setting.
</para>
</section>
</section>
@@ -595,40 +366,25 @@
<section>
<title>Speech Page</title>
<para>
-The speech page allows you to customize how Orca uses
-speech synthesis.
+The speech page allows you to customize how <application>Orca</application> uses speech synthesis.
</para>
<section>
<title>Enable Speech</title>
<para>
-The first control of note on the speech page is the
-<guilabel>Enable Speech</guilabel> check box. This
-check box toggles whether or not Orca will make use of
-a speech synthesizer. This option, along with the
-ability to enable Braille and magnifier support, allows
-Orca to be tailored to meet the specific needs of a
-wide variety of users.
+The first control of note on the speech page is the <guilabel>Enable Speech</guilabel> check box. This check box toggles whether or not <application>Orca</application> will make use of a speech synthesizer. This option, along with the ability to enable Braille and magnifier support, allows <application>Orca</application> to be tailored to meet the specific needs of a wide variety of users.
</para>
</section>
<section>
<title>Speech System and Speech Synthesizer</title>
<para>
-The next two controls deal with selecting the speech
-system and synthesizer. Orca provides support for a
-growing number of speech systems. At the time of this
-writing these include GNOME-speech, Emacspeak, and an
-experimental backend for Speech Dispatcher. Depending
-on how your machine is configured, you may have all or
-none of these options. Typically, you will only have
-GNOME-speech available.
+The next two controls deal with selecting the speech system and synthesizer. <application>Orca</application> provides support for a growing number of speech systems. At the time of this writing these include GNOME-speech, Emacspeak, and an
+experimental backend for Speech Dispatcher. Depending on how your machine is configured, you may have all or none of these options. Typically, you will only have GNOME-speech available.
</para>
<para>
-First, determine which speech system you would like to
-use - GNOME-speech works best at this time. After making
-your selection, tab to the speech synthesizer combo box
+First, determine which speech system you would like to use - GNOME-speech works best at this time. After making your selection, tab to the speech synthesizer combo box
and choose from the list of available synthesizers.
</para>
</section>
@@ -636,63 +392,36 @@
<section>
<title>Voice Settings</title>
<para>
-If your synthesizer supports it, Orca can utilize
-multiple voices in order to identify special cases
-within an application, such as hyperlinks or uppercase
-text. The voice settings and person combo boxes can be
-adjusted to customize these settings to your liking.
-For example, assume you were using Fonix DECtalk and
-wanted the Betty voice to denote uppercase. To
-accomplish this, you could do the following:
+If your synthesizer supports it, <application>Orca</application> can utilize multiple voices in order to identify special cases within an application, such as hyperlinks or uppercase text. The voice settings and person combo boxes can be
+adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote uppercase. To accomplish this, you could do the following:
</para>
<orderedlist numeration='arabic'>
<listitem>
<para>
-Tab to the voice settings combo box, and press the
-down arrow until the uppercase voice is selected.
+Tab to the voice settings combo box, and press the down arrow until the uppercase voice is selected.
</para>
</listitem>
<listitem>
<para>
-Tab to the person combo box, and press the down arrow
-to choose the Betty voice.
+Tab to the person combo box, and press the down arrow to choose the Betty voice.
</para>
</listitem>
</orderedlist>
<para>
-The next three sliders in the tab order allow adjustment
-of the synthesizer's rate, pitch and volume,
-respectively.
+The next three sliders in the tab order allow adjustment of the synthesizer's rate, pitch and volume, respectively.
</para>
<para>
-Note that you can quickly raise/lower the pitch by
-pressing
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Up Arrow</keycap>
-</keycombo> and
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Down Arrow</keycap>
-</keycombo>. You can also modify the speaking rate by
-pressing
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Left Arrow</keycap>
-</keycombo> and
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Right Arrow</keycap>
-</keycombo>.
+Note that you can quickly raise/lower the pitch by pressing <keycombo><keycap>Insert</keycap><keycap>Up Arrow</keycap></keycombo> and <keycombo><keycap>Insert</keycap>
+<keycap>Down Arrow</keycap></keycombo>. You can also modify the speaking rate by pressing
+<keycombo><keycap>Insert</keycap><keycap>Left Arrow</keycap></keycombo> and <keycombo>
+<keycap>Insert</keycap><keycap>Right Arrow</keycap></keycombo>.
</para>
</section>
<section>
<title>Punctuation Level</title>
<para>
-The <guilabel>Punctuation Level</guilabel> radio button
-group is used to adjust the amount of punctuation
-spoken by the synthesizer. The available levels are
+The <guilabel>Punctuation Level</guilabel> radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are
None, Some, Most and All.
</para>
</section>
@@ -700,65 +429,38 @@
<section>
<title>Verbosity</title>
<para>
-The Verbosity setting determines the amount of
-information that will be spoken in certain situations.
-For example, if it is set to <guilabel>Verbose
-</guilabel>, the synthesizer
-will speak shortcut keys for items in pull-down menus.
-When it is set to <guilabel>Brief</guilabel>,
-these shortcut keys are not announced.
+The Verbosity setting determines the amount of information that will be spoken in certain situations. For example, if it is set to <guilabel>Verbose</guilabel>, the synthesizer
+will speak shortcut keys for items in pull-down menus. When it is set to <guilabel>Brief</guilabel>, these shortcut keys are not announced.
</para>
</section>
<section>
<title>Table Row Speech</title>
<para>
-The table row speech option determines the way in which
-Orca will read items within tables. The available
+The table row speech option determines the way in which <application>Orca</application> will read items within tables. The available
settings are <guilabel>Speak Current Row
-</guilabel> or <guilabel>Speak Current Cell</guilabel>.
-The ability to adjust this behavior can be useful in
-many situations. For example, consider the process of
-browsing email messages in Evolution. In this instance
-it may be preferable to set table speech to
-<guilabel>Speak Current Row</guilabel>, so
-arrowing through the list of messages causes all
-relevant info, such as the sender, subject, and whether
-the message has attachments, is read automatically.
-While the current row setting is active, it is still
-possible to read individual cells by using the left and
-right arrows.
+</guilabel> or <guilabel>Speak Current Cell</guilabel>. The ability to adjust this behavior can be useful in many situations. For example, consider the process of
+browsing email messages in Evolution. In this instance it may be preferable to set table speech to <guilabel>Speak Current Row</guilabel>, so arrowing through the list of messages causes all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically.
+While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
</para>
<para>
-Note that you can quickly toggle this behavior by
-pressing
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>F11</keycap>
-</keycombo>.
+Note that you can quickly toggle this behavior by pressing <keycombo><keycap>Insert</keycap><keycap>F11</keycap></keycombo>.
</para>
</section>
<section>
<title>Speak Indentation</title>
<para>
-When working with code or editing documents, it is
-often desirable to be aware of justification as well as
-indentation. Selecting the
-<guilabel>Speak Indentation and Justification</guilabel>
-check box will cause Orca to provide this information.
+When working with code or editing documents, it is often desirable to be aware of justification as well as 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>
<para>
-Some users desire to hear the word "blank" when
-navigating through empty lines in a document. Other
-users do not. If the
+Some users desire to hear the word "blank" when navigating through empty lines in a document. Other users do not. If the
<guilabel>Speak Blank Lines</guilabel>
-check box is selected, Orca will announce any blank
-lines.
+check box is selected, <application>Orca</application> will announce any blank lines.
</para>
</section>
</section>
@@ -766,25 +468,14 @@
<section>
<title>Braille Page</title>
<para>
-The Braille page allows you to customize various
-aspects of Braille output. Orca does not automatically
-start BrlTTY - you typically need to do this yourself,
-and it usually occurs during OS startup.
+The Braille page allows you to customize various aspects of Braille output. <application>Orca</application> does not automatically start BrlTTY - you typically need to do this yourself, and it usually occurs during OS startup.
</para>
<section>
<title>Enable Braille Support</title>
<para>
The first control on the Braille page is the
-<guilabel>Enable Braille Support</guilabel> check box.
-This toggles whether or not Orca will make use of a
-Braille display. This option, along with the ability
-to enable Braille and magnifier support, allows
-Orca to be tailored to meet the needs of a wide variety
-of users. By default, this check box is enabled. If
-BrlTTY is not running, Orca will recover gracefully and
-will not communicate with the Braille display. If you
-configure BrlTTY later on, you need to restart Orca in
+<guilabel>Enable Braille Support</guilabel> check box. This toggles whether or not <application>Orca</application> will make use of a Braille display. This option, along with the ability to enable Braille and magnifier support, allows <application>Orca</application> to be tailored to meet the needs of a wide variety of users. By default, this check box is enabled. If BrlTTY is not running, <application>Orca</application> will recover gracefully and will not communicate with the Braille display. If you configure BrlTTY later on, you need to restart <application>Orca</application> in
order for it to use Braille.
</para>
</section>
@@ -792,42 +483,27 @@
<section>
<title>Enable Braille Monitor</title>
<para>
-Orca's Braille monitor provides an on-screen
-representation of what takes place on the Braille
-display. This feature is mostly for demonstration
-purposes, but is also useful for Orca developers who do
-not have access to a Braille display.
+<application>Orca</application>'s Braille monitor provides an on-screen representation of what takes place on the Braille display. This feature is mostly for demonstration
+purposes, but is also useful for <application>Orca</application> developers who do not have access to a Braille display.
</para>
</section>
<section>
<title>Abbreviated Role Names</title>
<para>
-The <guilabel>Abbreviated Role Names</guilabel> check
-box determines the manner in which role names are
-displayed and can be used to help conserve real estate
-on the Braille display. This option is best explained by
-example:
+The <guilabel>Abbreviated Role Names</guilabel> check box determines the manner in which role names are displayed and can be used to help conserve real estate on the Braille display. This option is best explained by example:
</para>
<para>
-Let us assume that a slider had focus, and that the
-abbreviated role names box was not checked. In that
-case, the word "slider" would be shown on the display,
-to reflect the fact that the current control was indeed
-a slider. If the abbreviated role names box was checked,
-the word "slider" would be abbreviated to "sldr".
+Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In that case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed
+a slider. If the abbreviated role names box was checked, the word "slider" would be abbreviated to "sldr".
</para>
</section>
<section>
<title>Verbosity</title>
<para>
-The <guilabel>Verbosity</guilabel> radio button group
-determines the amount of information that will be
-output to Braille in certain situations. For example, if
-it is set to Verbose, keyboard shortcut and role name
-information is displayed. This information is not
-displayed in Brief mode.
+The <guilabel>Verbosity</guilabel> radio button group determines the amount of information that will be output to Braille in certain situations. For example, if it is set to Verbose, keyboard shortcut and role name
+information is displayed. This information is not displayed in Brief mode.
</para>
</section>
</section>
@@ -835,8 +511,7 @@
<section>
<title>Key Echo Page</title>
<para>
-The Key Echo page allows you to specify the behavior
-of Orca when pressing keys on the page and whether
+The Key Echo page allows you to specify the behavior of <application>Orca</application> when pressing keys on the page and whether
words are spoken as you complete them.
</para>
@@ -844,25 +519,13 @@
<title>Enable Key Echo</title>
<para>
The first control on the key echo page is the
-<guilabel>Enable Key Echo</guilabel> check box. When
-this box is checked, five additional check boxes become
-available. These are
-<guilabel>Enable Alphanumeric and Punctuation Keys
-</guilabel>,
-<guilabel>Enable Modifier Keys</guilabel>,
-<guilabel>Enable Locking Keys</guilabel>,
-<guilabel>Enable Function Keys</guilabel>, and
-<guilabel>Enable Action Keys</guilabel>.
+<guilabel>Enable Key Echo</guilabel> check box. When this box is checked, five additional check boxes become available. These are <guilabel>Enable Alphanumeric and Punctuation Keys</guilabel>, <guilabel>Enable Modifier Keys</guilabel>, <guilabel>Enable Locking Keys</guilabel>, <guilabel>Enable Function Keys</guilabel>, and <guilabel>Enable Action Keys</guilabel>.
</para>
<para>
-The alphanumeric and punctuation option determines if
-letter, number and punctuation characters are echoed as
-you type them.
+The alphanumeric and punctuation option determines if letter, number and punctuation characters are echoed as you type them.
</para>
-
<para>
-Modifier keys are those such as
-<keycap>Shift</keycap>,
+Modifier keys are those such as <keycap>Shift</keycap>,
<keycap>Control</keycap>, and
<keycap>Alt</keycap>.
</para>
@@ -875,13 +538,11 @@
</para>
<para>
-Enabling function key echo will announce F1 - F12 when
-they are pressed.
+Enabling function key echo will announce F1 - F12 when they are pressed.
</para>
<para>
-The action keys group consists of keys that perform
-some logical action, as
+The action keys group consists of keys that perform some logical action, as
<keycap>Backspace</keycap>,
<keycap>Return</keycap> and
<keycap>Tab</keycap>.
@@ -892,17 +553,11 @@
<title>Enable Echo by Word</title>
<para>
The last toggle on the Key Echo page is the
-<guilabel>Enable Echo by Word</guilabel> check box. This
-option is always available, regardless of whether any
-of the key echo options are checked. When enabled,
-whole words are spoken as typing progresses.
+<guilabel>Enable Echo by Word</guilabel> check box. This option is always available, regardless of whether any of the key echo options are checked. When enabled, whole words are spoken as typing progresses.
</para>
<para>
-In summary, the Key Echo scheme can offer a great
-deal of flexibility. For example, one user might choose
-to enable all Key Echo options, while another might
-prefer to use word echo, but only have locking keys
+In summary, the Key Echo scheme can offer a great deal of flexibility. For example, one user might choose to enable all Key Echo options, while another might prefer to use word echo, but only have locking keys
announced.
</para>
</section>
@@ -911,21 +566,13 @@
<section>
<title>Magnifier Page</title>
<para>
-The magnifier page allows you to enable/disable
-magnification and specify how magnification is
-performed.
+The magnifier page allows you to enable/disable magnification and specify how magnification is performed.
</para>
<section>
<title>Enable Magnifier</title>
<para>
-The first control on the magnifier page is the
-<guilabel>Enable Magnifier</guilabel> check box. This
-toggles whether or not Orca will provide
-magnification. This option, along with the ability to
-enable speech and Braille support, allow Orca to
-be tailored to meet the needs of a wide variety of
-users.
+The first control on the magnifier page is the <guilabel>Enable Magnifier</guilabel> check box. This toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and Braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
</para>
</section>
@@ -1000,73 +647,46 @@
<section>
<title>Key Bindings Page</title>
<para>
-The key bindings page allows you to examine and
-modify the key bindings for Orca.
+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 "Orca
-modifier" (Orca system key). The Orca modifier is the
-key that you press and hold in conjunction with other
-keys to give commands to Orca. For desktop keyboards,
-the Orca modifier defaults to
-<keycap>Insert</keycap>.
-For laptop keyboards, the Orca modifier defaults to the
-<keycap>Caps Lock</keycap> key.
+The first control on the Key Bindings page allows you to examine which key (or keys) acts as the "Orca modifier" (<application>Orca</application> system key). 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 modifier defaults to <keycap>Insert</keycap>.
+For Laptop keyboards, the modifier defaults to the <keycap>Caps Lock</keycap> key.
</para>
<para>
-You cannot modify the Orca modifier key(s) using
-the Configuration dialog at this time.
+You cannot modify the <application>Orca</application> modifier key(s) using the configuration dialog at this time.
</para>
</section>
<section>
<title>Key Bindings Table</title>
<para>
-The key bindings table provides a list of Orca
+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 Ora operation to be performed.
+The "Function" column header is a description of the 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 Orca modifier key should be held down
-along with the other key(s).
+invoke the function from the keyboard. Note that the function description may include the word <literal>Orca</literal>. This indicates that the <application>Orca</application> modifier key should be held down along with the other key(s).
</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
-<guilabel>Modified</guilabel> column will indicate that
-the key binding has been modified.
+"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 <guilabel>Modified</guilabel> column will indicate that the key binding has been modified.
</para>
-
<para>
-To undo a modified keybinding, arrow to the modified
-column, uncheck the checkbox, and press the
-<guibutton>Apply</guibutton> button (
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>A</keycap>
-</keycombo>).
+To undo a modified keybinding, arrow to the modified column, uncheck the checkbox, and press the <guibutton>Apply</guibutton> button (<keycombo><keycap>Alt</keycap>
+<keycap>A</keycap></keycombo>).
</para>
</section>
</section>
@@ -1074,29 +694,17 @@
<section>
<title>Text Attributes Page</title>
<para>
-Orca will speak known text attribute information
-about an object when you press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>F</keycap>
-</keycombo> (
-<keycombo>
-<keycap>Caps Lock</keycap>
-<keycap>F</keycap>
-</keycombo>
-for laptop systems).
+<application>Orca</application> will speak known text attribute information about an object when you press
+<keycombo><keycap>Insert</keycap>
+<keycap>F</keycap></keycombo> (<keycombo>
+<keycap>Caps Lock</keycap><keycap>F</keycap>
+</keycombo> for Laptop systems).
</para>
-
<para>
-Because the number of text attributes is large, and
-not everyone cares about every attribute, the "Text
-Attributes" tab of the Configuration dialog allows you
-to customize which text attributes Orca will present.
+Because the number of text attributes is large, and not everyone cares about every attribute, the "Text Attributes" tab of the <application>Orca</application> configuration dialog allows you to customize which text attributes will be presented.
</para>
-
<para>
-On this tab is a text attribute list, where each row
-consists of three columns:
+On this tab is a text attribute list, where each row consists of three columns:
</para>
<orderedlist numeration='arabic'>
<listitem>
@@ -1111,46 +719,25 @@
<listitem>
<para>
An editable "Spoken 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 spoken) is that the value of the
-attribute will only be spoken if it's a different value
-than this value.
+default, not all text attributes will have this set. If present, what it means (assuming the user wants this text attribute spoken) is that the value of the attribute will only be spoken if it's a different value than this value.
</para>
</listitem>
</orderedlist>
<para>
For example, by default the "underline" text
-attribute has a value of "none". If the user has this
-attribute checked and the user presses
-<keycombo>
-<keycap>Insert</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 regardless of whether the
-text is underlined, then the attribute should be
-checked and the "Spoken unless" value cleared.
+attribute has a value of "none". If the user has this attribute checked and the user presses <keycombo><keycap>Insert</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 regardless of whether the text is underlined, then the attribute should be checked and the "Spoken unless" value cleared.
</para>
<para>
-There is also a <guibutton>Reset</guibutton> button (
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>R</keycap>
-</keycombo>) that will set the
-list values back to their initial state when the dialog
-was first displayed.
+There is also a <guibutton>Reset</guibutton> button (<keycombo><keycap>Alt</keycap>
+<keycap>R</keycap></keycombo>) that will set the list values back to their initial state when the dialog was first displayed.
</para>
-
<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 output to Braille.
+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 output to Braille.
</para>
<para>
-If you decide to check others or wish to adjust the
-order, there are four buttons to help you do this:
+If you decide to check others or wish to adjust the order, there are four buttons to help you do this:
</para>
<itemizedlist>
<listitem>
@@ -1158,8 +745,7 @@
<keycombo>
<keycap>Alt</keycap>
<keycap>T</keycap>
-</keycombo>) - moves the selected attribute to the top
-of the list.
+</keycombo>) - moves the selected attribute to the top of the list.
</para>
</listitem>
<listitem>
@@ -1183,22 +769,16 @@
<keycombo>
<keycap>Alt</keycap>
<keycap>B</keycap>
-</keycombo>) - moves the selected attribute to the
-bottom of the list.
+</keycombo>) - moves the selected attribute to the bottom of the list.
</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 is
-started when you give a particular application focus
-and press
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Ctrl</keycap>
-<keycap>Space</keycap>
-</keycombo>.</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 is
+started when you give a particular application focus and press <keycombo>
+<keycap>Insert</keycap><keycap>Ctrl</keycap>
+<keycap>Space</keycap></keycombo>.
+</para>
</section>
</section>
</section>
@@ -1208,63 +788,43 @@
<section>
<title>Accessible Applications</title>
<para>
-Orca is designed to work with applications and toolkits
-that support the Assistive Technology Service Provider
-Interface (AT-SPI). This includes the GNOME Desktop and
-its applications, OpenOffice, Firefox, and the Java
-platform. Some applications work better than others,
-however, and the Orca community continually works to
-provide superior access to more and more applications.
+<application>Orca</application> is designed to work with applications and toolkits
+that support the Assistive Technology Service Provider Interface (AT-SPI). This includes the GNOME Desktop and its bundled applications: OpenOffice, Firefox, and the Java platform. Some applications work better than others, however, and the <application>Orca</application> community continually works to provide superior access to more and more applications.
</para>
</section>
<section>
<title>Using Adobe's Acrobat Reader</title>
<para>
-We are currently working on a script for Adobe's
-Acrobat Reader, and the initial version has been
-contributed to Orca v2.17.5. Note that there is still
-work to do, and we are very encouraged by Adobe's
-commitment to accessibility.
+We are currently working on a script for Adobe's Acrobat Reader, and the initial version has been contributed to <application>Orca</application> v2.17.5. Note that there is still work to do, and we are very encouraged by Adobe's commitment to accessibility.
</para>
<section>
<title>Installation</title>
<para>
-If you get Adobe Acrobat Reader directly from the
-<ulink url='http://www.adobe.com/products/acrobat/
-readstep2.html'>Adobe site</ulink>,
+If you get Adobe Acrobat Reader directly from the <ulink url='http://www.adobe.com/products/acrobat/readstep2.html'>Adobe site</ulink>,
you may find that the software will not
-launch. The symptoms: If launched from the Applications
-menu, it appears that nothing has happened. If launched
-from a terminal window, you receive a long series of
-syntax error messages. Should this occur, you will need
-to edit your /usr/bin/acroread file as described in this
-<ulink url='http://ubuntuforums.org/showthread.php
+launch. If launched from the Applications
+menu, it may appear that nothing has happened, or if launched from a terminal window you may receive a long series of
+syntax error messages. Should this occur, you will need to edit your /usr/bin/acroread file as described in this <ulink url='http://ubuntuforums.org/showthread.php
?t=233514'>Ubuntu forum thread</ulink>.
</para>
<para>
-If you instead choose to install Acrobat Reader from
-your distribution's packages, be sure to install both
-acroread and acroread-plugins. Without the plugins
-package, you will not have the access to the "Reading"
-category in the
-<menuchoice>
+If you instead choose to install Acrobat Reader from your distribution's packages, be sure to install both <application>acroread</application> and <application>acroread-plugins</application>. Without the plugins
+package, you will not have the access to the "Reading" category in the <menuchoice>
<guimenuitem>Edit-</guimenuitem>
<guimenuitem>Preferences</guimenuitem>
</menuchoice> dialog.
</para>
<para>
Note: If you use Ubuntu and cannot locate the
-acroread package, you will likely need to edit your
-/etc/apt/sources.list to include the 'multiverse'
-repository. Then run
+<application>acroread</application> package, you will likely need to edit your
+/etc/apt/sources.list to include the 'multiverse' repository. Then run
<userinput>apt-get update</userinput>.
-Having done so, you should then be able to install both
-acroread and acroread-plugins.
+Having done so, you should then be able to install both <application>acroread</application> and <application>acroread-plugins</application>.
</para>
</section>
-
+ <--- 5/21/08 vpa // here --->
<section>
<title>Enabling Accessibility and Caret Navigation</title>
<para>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
