[orca] Start of the doc rewrite. A work in progress. Not "hooked up" yet.
- From: Joanmarie Diggs <joanied src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [orca] Start of the doc rewrite. A work in progress. Not "hooked up" yet.
- Date: Wed, 15 Dec 2010 15:34:42 +0000 (UTC)
commit 85b6a347a2991a0a6efd8e53cb6d185a7304ef45
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date: Wed Dec 15 10:33:36 2010 -0500
Start of the doc rewrite. A work in progress. Not "hooked up" yet.
configure.in | 1 +
help/C/commands.page | 47 ++++
help/C/commands_bookmarks.page | 60 +++++
help/C/commands_braille.page | 40 +++
help/C/commands_chat.page | 52 ++++
help/C/commands_controlling_orca.page | 83 ++++++
help/C/commands_debugging.page | 61 +++++
help/C/commands_find.page | 79 ++++++
help/C/commands_flat_review.page | 180 +++++++++++++
help/C/commands_live_regions.page | 58 ++++
help/C/commands_magnifier.page | 59 ++++
help/C/commands_mouse.page | 61 +++++
help/C/commands_reading.page | 220 +++++++++++++++
help/C/commands_speech_settings.page | 65 +++++
help/C/commands_structural_navigation.page | 280 ++++++++++++++++++++
help/C/commands_table.page | 57 ++++
help/C/commands_time_date_notifications.page | 60 +++++
help/C/commands_where_am_i.page | 91 +++++++
help/C/figures/orca-logo.png | Bin 0 -> 2265 bytes
help/C/howto_bookmarks.page | 18 ++
help/C/howto_documents.page | 24 ++
help/C/howto_flat_review.page | 19 ++
help/C/howto_key_bindings.page | 155 +++++++++++
help/C/howto_keyboard_layout.page | 63 +++++
help/C/howto_learn_modes.page | 77 ++++++
help/C/howto_mouse_review.page | 19 ++
help/C/howto_notifications.page | 19 ++
help/C/howto_orca_find.page | 19 ++
help/C/howto_profiles.page | 135 ++++++++++
help/C/howto_reading_web.page | 21 ++
help/C/howto_setting_up_orca.page | 80 ++++++
help/C/howto_tables.page | 21 ++
help/C/howto_text_attributes.page | 48 ++++
help/C/howto_text_setup.page | 193 ++++++++++++++
help/C/howto_the_orca_modifier.page | 79 ++++++
help/C/howto_toggling_caps_lock.page | 34 +++
help/C/howto_web_forms.page | 22 ++
help/C/howto_whereami.page | 21 ++
help/C/index.page | 36 +++
help/C/introduction.page | 197 ++++++++++++++
help/C/preferences.page | 65 +++++
help/C/preferences_braille.page | 99 +++++++
help/C/preferences_chat.page | 68 +++++
help/C/preferences_gekco.page | 84 ++++++
help/C/preferences_general.page | 167 ++++++++++++
help/C/preferences_key_bindings.page | 86 ++++++
help/C/preferences_key_echo.page | 123 +++++++++
help/C/preferences_magnifier.page | 353 +++++++++++++++++++++++++
help/C/preferences_pronunciation.page | 101 +++++++
help/C/preferences_speech.page | 335 +++++++++++++++++++++++
help/C/preferences_structural_navigation.page | 65 +++++
help/C/preferences_text_attributes.page | 131 +++++++++
help/Makefile.am | 58 ++++
53 files changed, 4589 insertions(+), 0 deletions(-)
---
diff --git a/configure.in b/configure.in
index bfb563d..55b9594 100644
--- a/configure.in
+++ b/configure.in
@@ -83,6 +83,7 @@ Makefile
docs/Makefile
docs/man/Makefile
po/Makefile.in
+help/Makefile
icons/Makefile
src/Makefile
src/orca/Makefile
diff --git a/help/C/commands.page b/help/C/commands.page
new file mode 100644
index 0000000..889ec01
--- /dev/null
+++ b/help/C/commands.page
@@ -0,0 +1,47 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="guide" id="commands">
+ <info>
+ <link type="next" xref="commands_controlling_orca" />
+ <link type="seealso" xref="index" />
+ <title type="sort">4. <app>Orca</app>'s Commands</title>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ <desc>
+ Much of <app>Orca</app>'s functionality consists of commands which
+ enable you to navigate more efficiently and obtain information about
+ the elements displayed on the screen. The guides are designed for those
+ who are already familiar with how to use a screen reader and just need
+ to know what commands are available in <app>Orca</app>.
+ </desc>
+ </info>
+ <title><app>Orca</app>'s Commands</title>
+ <p>
+ Much of <app>Orca</app>'s functionality consists of commands which enable
+ you to navigate more efficiently and obtain information about the elements
+ displayed on the screen. The guides are designed for those who are already
+ familiar with how to use a screen reader and just need to know what commands
+ are available in <app>Orca</app>.
+ </p>
+ <section id="getting_started" style="2column">
+ <title>Getting Started</title>
+ </section>
+ <section id="speech_braille_magnification" style="2column">
+ <title>Speech, Braille, and Magnification</title>
+ </section>
+ <section id="reading_documents" style="2column">
+ <title>Reading Web Pages and Other Documents</title>
+ </section>
+ <section id="reviewing_screen_contents" style="2column">
+ <title>Reviewing and Interacting with Screen Contents</title>
+ </section>
+ <section id="accessing_dynamic_information" style="2column">
+ <title>Accessing Dynamic Information</title>
+ </section>
+ <section id="troubleshooting">
+ <title>Troubleshooting</title>
+ </section>
+</page>
diff --git a/help/C/commands_bookmarks.page b/help/C/commands_bookmarks.page
new file mode 100644
index 0000000..19803e0
--- /dev/null
+++ b/help/C/commands_bookmarks.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_bookmarks">
+ <info>
+ <link type="next" xref="commands_live_regions" />
+ <link type="guide" xref="commands#reviewing_screen_contents" />
+ <link type="seealso" xref="howto_bookmarks" />
+ <title type="sort">4. Bookmarks</title>
+ <title type="link">Bookmarks</title>
+ <desc>
+ commands to bookmark and retrieve objects
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Bookmark Commands</title>
+ <list>
+ <item>
+ <p>
+ Save a bookmark to the numbered slot: <keyseq><key>Orca Modifier</key>
+ <key>Alt</key><key>1</key></keyseq>-<key>6</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ Save the defined bookmarks for the application or page:
+ <keyseq><key>Orca Modifier</key><key>Alt</key><key>B</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Go to a specific, numbered bookmark: <keyseq><key>Orca Modifier</key>
+ <key>1</key></keyseq>-<key>6</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ Go to the previous bookmark for the application or page:
+ <keyseq><key>Orca Modifier</key><key>Shift</key><key>B</key>
+ </keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Go to the next/previous bookmark for the application or page:
+ <keyseq><key>Orca Modifier</key><key>B</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ "Where am I" information for this bookmark relative to the current
+ pointer location: <keyseq><key>Alt</key><key>Shift</key><key>1</key>
+ </keyseq>-<key>6</key>
+ </p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_braille.page b/help/C/commands_braille.page
new file mode 100644
index 0000000..83563de
--- /dev/null
+++ b/help/C/commands_braille.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_braille">
+ <info>
+ <link type="next" xref="commands_magnifier" />
+ <link type="guide" xref="commands#speech_braille_magnification" />
+ <link type="seealso" xref="preferences_braille" />
+ <title type="sort">2. Braille</title>
+ <title type="link">Braille</title>
+ <desc>
+ commands executable on braille displays
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Braille Commands</title>
+ <p>
+ The following commands allow you to control <app>Orca</app> from your
+ refreshable braille display rather than your keyboard:
+ </p>
+ <list>
+ <item><p>Pan braille display to the left: Line Left</p></item>
+ <item><p>Pan braille display to the right: Line Right</p></item>
+ <item><p>Toggle flat review mode: Freeze</p></item>
+ <item><p>Review the word above: Line Up</p></item>
+ <item><p>Review the word below: Line Down</p></item>
+ <item><p>Review bottom left: Bottom Right</p></item>
+ <item><p>Review the home position: Top Left</p></item>
+ <item><p>Contracted braille: Six Dots</p></item>
+ <item><p>Marks the beginning of a text selection: Cut Begin</p></item>
+ <item><p>Marks the end of a text selection: Cut Line</p></item>
+ <item><p>Processes a cursor routing key: Cursor Routing</p></item>
+ <item><p>Returns to object with keyboard focus: Cursor Position</p></item>
+ </list>
+</page>
+
+
diff --git a/help/C/commands_chat.page b/help/C/commands_chat.page
new file mode 100644
index 0000000..95629b2
--- /dev/null
+++ b/help/C/commands_chat.page
@@ -0,0 +1,52 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_chat">
+ <info>
+ <link type="next" xref="commands_debugging" />
+ <link type="guide" xref="commands#accessing_dynamic_information" />
+ <link type="seealso" xref="preferences_chat" />
+ <title type="sort">2. Chat</title>
+ <title type="link">Chat</title>
+ <desc>
+ commands for use with IM and IRC clients
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Chat Commands</title>
+ <p>
+ The following commands can be used to access information in the
+ instant messaging and internet relay chat clients supported by
+ <app>Orca</app>. You will notice that several of these commands
+ are "unbound." Please see <link xref="howto_key_bindings">Modifying
+ Keybindings</link> for information on how to bind these commands to
+ keystrokes.
+ </p>
+ <list>
+ <item>
+ <p>
+ Present previous chat room messages:
+ <keyseq><key>Orca Modifier</key><key>F1</key></keyseq> through <key>F9</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ Enable/disable announcement of room name with messages: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>Enable/disable announcement of buddy typing status: (Unbound)</p>
+ </item>
+ <item>
+ <p>Enable/disable room-specific histories: (Unbound)</p>
+ </item>
+ </list>
+</page>
+
+
+
+
+
diff --git a/help/C/commands_controlling_orca.page b/help/C/commands_controlling_orca.page
new file mode 100644
index 0000000..ffe3725
--- /dev/null
+++ b/help/C/commands_controlling_orca.page
@@ -0,0 +1,83 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_controlling_orca">
+ <info>
+ <link type="next" xref="commands_where_am_i" />
+ <link type="guide" xref="commands#getting_started" />
+ <title type="sort">1. Controlling and Learning to Use Orca</title>
+ <title type="link">Controlling and Learning to Use Orca</title>
+ <desc>
+ commands for interacting with <app>Orca</app>
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title type="link">Controlling and Learning to Use Orca</title>
+ <section id="controlling">
+ <title>Commands for Controlling <app>Orca</app></title>
+ <p>
+ The following commands can be used to get into <app>Orca</app>'s
+ Preferences dialogs, quit <app>Orca</app>, and bypass <app>Orca</app>
+ commands to avoid shortcut conflicts within the application being accessed.
+ </p>
+ <list>
+ <item>
+ <p>
+ <link xref="preferences">Orca Preferences</link> dialog:
+ <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Orca's Preferences dialog for the focused application:
+ <keyseq><key>Ctrl</key><key>Orca Modifier</key><key>Space</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Quit <app>Orca</app>:
+ <keyseq><key>Orca Modifier</key><key>Q</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Pass the next command on to the current application:
+ <keyseq><key>Orca Modifier</key><key>BackSpace</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="learning">
+ <title>Commands for Learning to Use <app>Orca</app></title>
+ <p>
+ Orca has two modes for learning more about <app>Orca</app>'s commands:
+ Learn Mode and List Shortcuts Mode. In Learn Mode, <app>Orca</app> will
+ announce each keystroke you pressed along with any associated
+ <app>Orca</app> command that keystroke is bound to. List Shortcuts Mode
+ provides you with a list of all the <app>Orca</app> commands you can use.
+ </p>
+ <list>
+ <item>
+ <p>
+ Enter learn mode:
+ <keyseq><key>Orca Modifier</key><key>H</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Enter list shortcuts mode:
+ <keyseq><key>Orca Modifier</key><key>H</key></keyseq> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Exit either mode:
+ <keyseq><key>Esc</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/commands_debugging.page b/help/C/commands_debugging.page
new file mode 100644
index 0000000..6432e6c
--- /dev/null
+++ b/help/C/commands_debugging.page
@@ -0,0 +1,61 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_debugging">
+ <info>
+ <link type="guide" xref="commands#troubleshooting" />
+ <title type="sort">1. Debugging</title>
+ <title type="link">Debugging</title>
+ <desc>
+ commands for troubleshooting
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Debugging Commands</title>
+ <list>
+ <item>
+ <p>
+ Report information on the currently active script:
+ <keyseq><key>Ctrl</key><key>Alt</key><key>Orca Modifier</key>
+ <key>Home</key></keyseq>
+ </p>
+ </item>
+ </list>
+ <note style="tip">
+ <p>
+ In order for the next three commands to be of use, <app>Orca</app> needs
+ to be started from a virtual console or via gnome-terminal. Output is sent
+ to the console only (i.e., it is not sent to speech or braille).
+ </p>
+ </note>
+ <list>
+ <item>
+ <p>
+ Print a debug listing of all known applications to the console where
+ <app>Orca</app> is running:
+ <keyseq>
+ <key>Ctrl</key><key>Alt</key><key>Orca Modifier</key><key>End</key>
+ </keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Print debug information about the ancestry of the object with focus:
+ <keyseq>
+ <key>Ctrl</key><key>Alt</key><key>Orca Modifier</key><key>Page Up</key>
+ </keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Print debug information about the hierarchy of the application with focus:
+ <keyseq>
+ <key>Ctrl</key><key>Alt</key><key>Orca Modifier</key><key>Page Down</key>
+ </keyseq>
+ </p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_find.page b/help/C/commands_find.page
new file mode 100644
index 0000000..3a9e440
--- /dev/null
+++ b/help/C/commands_find.page
@@ -0,0 +1,79 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_find">
+ <info>
+ <link type="next" xref="commands_mouse" />
+ <link type="guide" xref="commands#reviewing_screen_contents" />
+ <link type="seealso" xref="howto_orca_find" />
+ <title type="sort">2. Orca Find</title>
+ <title type="link">Orca Find</title>
+ <desc>
+ commands for searching window contents
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Orca Find Commands</title>
+ <p>
+ Orca's Find feature allows you to search for elements displayed on the
+ screen. It is a Flat Review feature. Thus when there is a match, flat
+ review will be activated and moved to that location; focus within the
+ application will not be modified, nor will the caret be repositioned.
+ If you need to accomplish either, please see
+ <link xref="commands_mouse">Orca'a Mouse/Pointer-Related Commands</link>.
+ </p>
+ <list>
+ <item>
+ <p>Open the <app>Orca</app> Find dialog:</p>
+ <list>
+ <item>
+ <p>Desktop:<keyseq><key>KP Delete</key></keyseq></p>
+ </item>
+ <item>
+ <p>Laptop: <keyseq><key>Orca Modifier</key><key>Left Bracket</key></keyseq></p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Move flat review to the next instance of a string:</p>
+ <list>
+ <item>
+ <p>
+ Desktop:
+ <keyseq><key>Orca Modifier</key><key>KP Delete</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop:
+ <keyseq><key>Orca Modifier</key><key>Right Bracket</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Move flat review to the previous instance of a string:</p>
+ <list>
+ <item>
+ <p>
+ Desktop:
+ <keyseq>
+ <key>Orca Modifier</key><key>Shift</key><key>KP Delete</key>
+ </keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop:
+ <keyseq>
+ <key>Orca Modifier</key><key>Ctrl</key><key>Right Bracket</key>
+ </keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_flat_review.page b/help/C/commands_flat_review.page
new file mode 100644
index 0000000..fb629d0
--- /dev/null
+++ b/help/C/commands_flat_review.page
@@ -0,0 +1,180 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_flat_review">
+ <info>
+ <link type="next" xref="commands_find" />
+ <link type="guide" xref="commands#reviewing_screen_contents" />
+ <link type="seealso" xref="howto_flat_review" />
+ <title type="sort">1. Flat Review</title>
+ <title type="link">Flat Review</title>
+ <desc>
+ commands for spatially reviewing windows
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Flat Review Commands</title>
+ <p>
+ Orca's Flat Review commands are designed for spatially reviwing
+ elements displayed on the screen. They also provide a means for
+ reading the current line, word, and character.
+ </p>
+ <section id="line">
+ <title>Commands for Reviewing by Line</title>
+ <list>
+ <item>
+ <p>First line (The "home" position):</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 7</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>U</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Previous line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 7</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>U</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Current line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 8</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Spell current line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 8</key></keyseq> (double-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq> (double-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Phonetically spell current line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 8</key></keyseq> (triple-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq> (triple-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Next line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 9</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>O</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Last line (The "end" position):</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 9</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>O</key></keyseq></p></item>
+ </list>
+ </item>
+ </list>
+ </section>
+ <section id="word">
+ <title>Commands for Reviewing by Word</title>
+ <list>
+ <item><p>Word above:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 4</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>J</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Previous word:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 4</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>J</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Current word:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 5</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Spell current word:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> (double-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Phonetically spell current word:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> (triple-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Next word:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 6</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>L</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Word below:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 6</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>L</key></keyseq></p></item>
+ </list>
+ </item>
+ </list>
+ </section>
+ <section id="character">
+ <title>Commands for Reviewing by Character</title>
+ <list>
+ <item><p>Previous character:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 1</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>M</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Current character:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 2</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Phonetically speak current character:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (double-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Speak unicode value of current character:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)</p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (triple-clicked)</p></item>
+ </list>
+ </item>
+ <item><p>Next character:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>KP 3</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Period</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Last character on current line:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 1</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>M</key></keyseq></p></item>
+ </list>
+ </item>
+ </list>
+ </section>
+ <section id="other">
+ <title>Additional Commands</title>
+ <list>
+ <item><p>Toggle flat review (refreshes the flat review context):</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP Subtract</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>P</key></keyseq></p></item>
+ </list>
+ </item>
+ <item><p>Review current item/widget:</p>
+ <list>
+ <item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 5</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>K</key></keyseq></p></item>
+ </list>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/commands_live_regions.page b/help/C/commands_live_regions.page
new file mode 100644
index 0000000..ddc2106
--- /dev/null
+++ b/help/C/commands_live_regions.page
@@ -0,0 +1,58 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_live_regions">
+ <info>
+ <link type="next" xref="commands_chat" />
+ <link type="guide" xref="commands#accessing_dynamic_information" />
+ <link type="seealso" xref="howto_reading_web" />
+ <title type="sort">1. Live Region</title>
+ <title type="link">Live Regions</title>
+ <desc>
+ commands for accessing web live regions
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0
+ </p>
+ </license>
+ </info>
+ <title>Live Region Commands</title>
+ <list>
+ <item>
+ <p>
+ Monitor live regions:
+ <keyseq><key>Orca Modifier</key><key>Shift</key><key>Backslash</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Advance live region politeness setting: <key>Backslash</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ Set default politeness level to off:
+ <keyseq><key>Shift</key><key>Backslash</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Go to next/previous live region:
+ <keyseq><key>D</key></keyseq>/<keyseq><key>Shift</key><key>D</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Go to last live region which made an announcement:
+ <keyseq><key>Y</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Review live region announcements:
+ <keyseq><key>Orca Modifier</key><key>F1</key></keyseq> through <key>F9</key>
+ </p>
+ </item>
+</list>
+</page>
diff --git a/help/C/commands_magnifier.page b/help/C/commands_magnifier.page
new file mode 100644
index 0000000..b494002
--- /dev/null
+++ b/help/C/commands_magnifier.page
@@ -0,0 +1,59 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_magnifier">
+ <info>
+ <link type="next" xref="commands_reading" />
+ <link type="guide" xref="commands#speech_braille_magnification" />
+ <link type="seealso" xref="preferences_magnifier" />
+ <title type="sort">3. Magnifier Settings</title>
+ <title type="link">Magnifier Settings</title>
+ <desc>
+ commands for customizing <app>Orca</app>'s zoomer
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Magnifier Settings Commands</title>
+ <p>
+ The following commands can be used to customize <app>Orca</app>'s
+ magnification support. You will notice that all of these commands
+ are "unbound." Please see <link xref="howto_key_bindings">Modifying
+ Keybindings</link> for information on how to bind these commands to
+ keystrokes.
+ </p>
+ <list>
+ <item>
+ <p>
+ Enable/disable magnification: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>
+ Increase magnification level: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>
+ Decrease magnification: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>
+ Enable/disable color enhancements: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>
+ Enable/disable mouse enhancements: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>
+ Cycle to the magnifier position: (Unbound)
+ </p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_mouse.page b/help/C/commands_mouse.page
new file mode 100644
index 0000000..ae7d16b
--- /dev/null
+++ b/help/C/commands_mouse.page
@@ -0,0 +1,61 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_mouse">
+ <info>
+ <link type="next" xref="commands_bookmarks" />
+ <link type="guide" xref="commands#reviewing_screen_contents" />
+ <title type="sort">3. Mouse/Pointer-Related</title>
+ <title type="link">Mouse/Pointer-Related</title>
+ <link type="seealso" xref="howto_flat_review" />
+ <link type="seealso" xref="howto_mouse_review" />
+ <desc>
+ commands for manipulating the pointer
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Mouse/Pointer-Related Commands</title>
+ <p>
+ The following commands can be used to manipulate the mouse pointer
+ and read the contents under it. All of the commands are "bound"
+ to keystrokes with one exception: Toggling Mouse Review Mode.
+ Please see <link xref="howto_key_bindings">Modifying Keybindings</link>
+ for information on how to bind this command to a keystroke.
+ </p>
+ <list>
+ <item>
+ <p>Left-click on current item:</p>
+ <list>
+ <item><p>Desktop:<keyseq><key>KP Divide</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>7</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Right-click on current item:</p>
+ <list>
+ <item><p>Desktop:<keyseq><key>KP Multiply</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>8</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Route pointer to current item:</p>
+ <list>
+ <item><p>Desktop:<keyseq><key>Orca Modifier</key><key>KP Divide</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>9</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Move focus into or away from the current mouse over (web only):</p>
+ <list>
+ <item><p>Desktop:<keyseq><key>Orca Modifier</key><key>KP Multiply</key></keyseq></p></item>
+ <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>0</key></keyseq></p></item>
+ </list>
+ </item>
+ <item>
+ <p>Enable/disable mouse review mode: (Unbound)</p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_reading.page b/help/C/commands_reading.page
new file mode 100644
index 0000000..e0ac1d8
--- /dev/null
+++ b/help/C/commands_reading.page
@@ -0,0 +1,220 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_reading">
+ <info>
+ <link type="next" xref="commands_structural_navigation" />
+ <link type="guide" xref="commands#reading_documents" />
+ <link type="seealso" xref="howto_reading_text" />
+ <link type="seealso" xref="howto_text_attributes" />
+ <link type="seealso" xref="howto_whereami" />
+ <title type="sort">1. Reading</title>
+ <title type="link">Reading</title>
+ <desc>
+ commands for accessing document text
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Reading Commands</title>
+ <p>
+ To read the contents of any document, use the application's built-in caret
+ navigation mode. As you navigate within the text of the document, <app>Orca</app>
+ will present your new location. As a result, you are likely already familiar with
+ how to read a document using <app>Orca</app>. However, if you would like to review
+ GNOME's caret navigation commands, please see
+ "<link href="http://library.gnome.org/users/gnome-access-guide/unstable/keynav-52.html";>Caret
+ Navigation Mode</link>" in the
+ <link href="http://library.gnome.org/users/gnome-access-guide/unstable";>GNOME
+ Desktop Accessibility Guide</link>.
+ </p>
+ <p>
+ In addition to the caret navigation commands which are part of GNOME,
+ you can use the following <app>Orca</app> commands to read a docment:
+ </p>
+ <section id="flat_review">
+ <title>Reading Your Current Location</title>
+ <p>
+ The following <app>Orca</app> <link xref="commands_flat_review">Flat
+ Review Commands</link> can be used to read your current location:
+ </p>
+ <list>
+ <item>
+ <p>Read the current line:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 8</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Read the current word:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 5</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Spell the current word:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Phonetically spell the current word:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
+ (triple-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Read the current character:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 2</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Phonetically speak the current character:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Speak the unicode value of current character:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
+ (triple-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ </list>
+ </section>
+ <section id="say_all">
+ <title>Say All</title>
+ <p>
+ Orca's Say All command will cause <app>Orca</app> to speak the
+ entire document beginning from your current location.
+ </p>
+ <list>
+ <item>
+ <p>Desktop: <key>KP Plus</key></p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Semicolon</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="attributes_and_selection">
+ <title>Text Attributes and Selected Text</title>
+ <p>
+ Orca has a dedicated command for obtaining the attributes of the
+ text at the caret location. In addition, if you use <app>Orca</app>'s
+ Where Am I commands from within a text object in which text has been
+ selected, <app>Orca</app> will announce the selected text.
+ </p>
+ <list>
+ <item>
+ <p>
+ Present the text attributes:
+ <keyseq><key>Orca Modifier</key><key>F</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>Perform basic where am I:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <key>KP Enter</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Perform detailed where am I:</p>
+ <list>
+ <item>
+ <p>
+ Desktop: <key>KP Enter</key> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ </list>
+</section>
+</page>
diff --git a/help/C/commands_speech_settings.page b/help/C/commands_speech_settings.page
new file mode 100644
index 0000000..da63a92
--- /dev/null
+++ b/help/C/commands_speech_settings.page
@@ -0,0 +1,65 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_speech_settings">
+ <info>
+ <link type="next" xref="commands_braille" />
+ <link type="guide" xref="commands#speech_braille_magnification" />
+ <link type="seealso" xref="preferences_speech" />
+ <title type="sort">2. Speech Settings</title>
+ <title type="link">Speech</title>
+ <desc>
+ commands for customizing <app>Orca</app>'s output
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Speech Settings Commands</title>
+ <p>
+ The following commands can be used to customize <app>Orca</app>'s
+ speech output. You will notice that a number of these commands are
+ "unbound." Please see <link xref="howto_key_bindings">Modifying
+ Keybindings</link> for information on how to bind these commands
+ to keystrokes.
+ </p>
+ <list>
+ <item>
+ <p>
+ Enable/disable speech: <keyseq><key>Orca Modifier</key><key>S</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Toggle between cell and row reading in a table:
+ <keyseq><key>Orca Modifier</key><key>F11</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Enable/disable speaking of indentation and justification: (Unbound)
+ </p>
+ </item>
+ <item>
+ <p>Cycle to the next spoken punctuation level: (Unbound)</p>
+ </item>
+ <item>
+ <p>Cycle to the next key echo level: (Unbound)</p>
+ </item>
+ <item>
+ <p>Decrease the rate: (Unbound)</p>
+ </item>
+ <item>
+ <p>Increase the rate: (Unbound)</p>
+ </item>
+ <item>
+ <p>Decrease the pitch: (Unbound)</p>
+ </item>
+ <item>
+ <p>Increase the pitch: (Unbound)</p>
+ </item>
+ </list>
+</page>
+
+
diff --git a/help/C/commands_structural_navigation.page b/help/C/commands_structural_navigation.page
new file mode 100644
index 0000000..7e42e06
--- /dev/null
+++ b/help/C/commands_structural_navigation.page
@@ -0,0 +1,280 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_structural_navigation">
+ <info>
+ <link type="next" xref="commands_table" />
+ <link type="guide" xref="commands#reading_documents" />
+ <link type="seealso" xref="howto_reading_web" />
+ <link type="seealso" xref="howto_web_forms" />
+ <title type="sort">2. Structural Navigation</title>
+ <title type="link">Structural Navigation</title>
+ <desc>
+ commands for navigating by elements
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Structural Navigation Commands</title>
+ <p>
+ The following commands can be used to navigate by headings, links,
+ and other elements found in applications for which <app>Orca</app>
+ provides structural navigation support.
+ </p>
+ <list>
+ <item>
+ <p>
+ Enable/disable Structural Navigation keys:
+ <keyseq><key>Orca Modifier</key><key>Z</key></keyseq>
+ </p>
+ </item>
+ </list>
+ <section id="headings">
+ <title>Headings</title>
+ <list>
+ <item>
+ <p>
+ Next and previous heading:
+ <keyseq><key>H</key></keyseq> and
+ <keyseq><key>Shift</key><key>H</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 1:
+ <keyseq><key>1</key></keyseq> and
+ <keyseq><key>Shift</key><key>1</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 2:
+ <keyseq><key>2</key></keyseq> and
+ <keyseq><key>Shift</key><key>2</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 3:
+ <keyseq><key>3</key></keyseq> and
+ <keyseq><key>Shift</key><key>3</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 4:
+ <keyseq><key>4</key></keyseq> and
+ <keyseq><key>Shift</key><key>4</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 5:
+ <keyseq><key>5</key></keyseq> and
+ <keyseq><key>Shift</key><key>5</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous heading at level 6:
+ <keyseq><key>6</key></keyseq> and
+ <keyseq><key>Shift</key><key>6</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="forms">
+ <title>Forms</title>
+ <list>
+ <item>
+ <p>
+ Next and previous form field:
+ <keyseq><key>Orca Modifier</key><key>Tab</key></keyseq> and
+ <keyseq><key>Orca Modifier</key><key>Shift</key><key>Tab</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous button:
+ <keyseq><key>B</key></keyseq> and
+ <keyseq><key>Shift</key><key>B</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous combo box:
+ <keyseq><key>C</key></keyseq> and
+ <keyseq><key>Shift</key><key>C</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous entry:
+ <keyseq><key>E</key></keyseq> and
+ <keyseq><key>Shift</key><key>E</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous radio button:
+ <keyseq><key>R</key></keyseq> and
+ <keyseq><key>Shift</key><key>R</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous checkbox:
+ <keyseq><key>X</key></keyseq> and
+ <keyseq><key>Shift</key><key>X</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous object (to exit field):
+ <keyseq><key>Orca Modifier</key><key>Right</key></keyseq> and
+ <keyseq><key>Orca Modifier</key><key>Left</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="links">
+ <title>Links</title>
+ <list>
+ <item>
+ <p>
+ Next and previous unvisited link:
+ <keyseq><key>U</key></keyseq> and
+ <keyseq><key>Shift</key><key>U</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous visited link:
+ <keyseq><key>V</key></keyseq> and
+ <keyseq><key>Shift</key><key>V</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="lists">
+ <title>Lists</title>
+ <list>
+ <item>
+ <p>
+ Next and previous list:
+ <keyseq><key>L</key></keyseq> and
+ <keyseq><key>Shift</key><key>L</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous list item:
+ <keyseq><key>I</key></keyseq> and
+ <keyseq><key>Shift</key><key>I</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="tables">
+ <title>Tables</title>
+ <list>
+ <item>
+ <p>
+ Next and previous table:
+ <keyseq><key>T</key></keyseq> and
+ <keyseq><key>Shift</key><key>T</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Cell on left:
+ <keyseq><key>Alt</key><key>Shift</key><key>Left</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Cell on right:
+ <keyseq><key>Alt</key><key>Shift</key><key>Right</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Cell above:
+ <keyseq><key>Alt</key><key>Shift</key><key>Up</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Cell below:
+ <keyseq><key>Alt</key><key>Shift</key><key>Down</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ First cell in table:
+ <keyseq><key>Alt</key><key>Shift</key><key>Home</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Last cell in table:
+ <keyseq><key>Alt</key><key>Shift</key><key>End</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="text_blocks">
+ <title>Text Blocks</title>
+ <list>
+ <item>
+ <p>
+ Next and previous paragraph:
+ <keyseq><key>P</key></keyseq> and
+ <keyseq><key>Shift</key><key>P</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous blockquote:
+ <keyseq><key>Q</key></keyseq> and
+ <keyseq><key>Shift</key><key>Q</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous "large object":
+ <keyseq><key>O</key></keyseq> and
+ <keyseq><key>Shift</key><key>O</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="other">
+ <title>Other Elements</title>
+ <list>
+ <item>
+ <p>
+ Next and previous landmark:
+ <keyseq><key>M</key></keyseq> and
+ <keyseq><key>Shift</key><key>M</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous separator:
+ <keyseq><key>S</key></keyseq> and
+ <keyseq><key>Shift</key><key>S</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Next and previous anchor:
+ <keyseq><key>A</key></keyseq> and
+ <keyseq><key>Shift</key><key>A</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/commands_table.page b/help/C/commands_table.page
new file mode 100644
index 0000000..e48a810
--- /dev/null
+++ b/help/C/commands_table.page
@@ -0,0 +1,57 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_table">
+ <info>
+ <link type="next" xref="commands_flat_review" />
+ <link type="guide" xref="commands#reading_documents" />
+ <link type="seealso" xref="howto_tables" />
+ <title type="sort">3. Table Navigation</title>
+ <title type="link">Table Navigation</title>
+ <desc>
+ commands for accessing tabular information
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Table Navigation Commands</title>
+ <p>
+ Orca's support for navigation by table cell is part of its
+ <link xref="commands_structural_navigation#tables">Structural Navigation
+ commands</link>. In addition you can:
+ </p>
+ <list>
+ <item>
+ <p>
+ Set dynamic row headers to current column:
+ <keyseq><key>Orca Modifier</key><key>C</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Set dynamic column headers to current row:
+ <keyseq><key>Orca Modifier</key><key>R</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Clear dynamic row headers:
+ <keyseq><key>Orca Modifier</key><key>C</key></keyseq> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Clear dynamic column headers:
+ <keyseq><key>Orca Modifier</key><key>R</key></keyseq> (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Toggle between cell and row reading in a table:
+ <keyseq><key>Orca Modifier</key><key>F11</key></keyseq>
+ </p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/commands_time_date_notifications.page b/help/C/commands_time_date_notifications.page
new file mode 100644
index 0000000..030930f
--- /dev/null
+++ b/help/C/commands_time_date_notifications.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_time_date_notifications">
+ <info>
+ <link type="next" xref="commands_speech_settings" />
+ <link type="guide" xref="commands#getting_started" />
+ <link type="seealso" xref="howto_notifications" />
+ <title type="sort">4. Time, Date, and Notification</title>
+ <title type="link">Time, Date, and Notification</title>
+ <desc>
+ commands for the getting the time, date, and notification messages
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Time, Date, and Notification Commands</title>
+ <p>
+ The following commands can be used to obtain the current time and date
+ and to review previously-displayed notification messages:
+ </p>
+ <section id="time_and_date">
+ <title>Obtaining the Time and Date</title>
+ <list>
+ <item>
+ <p>
+ Present the time: <keyseq><key>Orca Modifier</key><key>T</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Present the date: <keyseq><key>Orca Modifier</key><key>T</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="notifications">
+ <title>Reviewing Notification Messages</title>
+ <p>
+ Orca has three unbound commands for accessing previously-displayed
+ notification messages. Please see <link xref="howto_key_bindings">Modifying
+ Keybindings</link> for information on how to bind these commands to
+ keystrokes.
+ </p>
+ <list>
+ <item>
+ <p>Present the last (most recent) notification message: (unbound)</p>
+ </item>
+ <item>
+ <p>Present the previous notification message: (unbound)</p>
+ </item>
+ <item>
+ <p>Present list of all notification messages: (unbound)</p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/commands_where_am_i.page b/help/C/commands_where_am_i.page
new file mode 100644
index 0000000..5e26c35
--- /dev/null
+++ b/help/C/commands_where_am_i.page
@@ -0,0 +1,91 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="commands_where_am_i">
+ <info>
+ <link type="next" xref="commands_time_date_notifications" />
+ <link type="guide" xref="commands#getting_started" />
+ <link type="seealso" xref="howto_whereami" />
+ <title type="sort">3. Where Am I</title>
+ <title type="link">Where Am I</title>
+ <desc>
+ commands to learn about your location
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Where Am I Commands</title>
+ <p>
+ Orca's Where Am I commands give you context-senstive details about your
+ present location. For instance, in tables, Where Am I will give you
+ details about the table cell you are in, but in text it will present
+ the current line along with any text which happens to be selected.
+ </p>
+ <list>
+ <item>
+ <p>Perform basic where am I:</p>
+ <list>
+ <item>
+ <p>Desktop: <key>KP Enter</key></p>
+ </item>
+ <item>
+ <p>Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq></p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Perform detailed where am I:</p>
+ <list>
+ <item>
+ <p>Desktop: <key>KP Enter</key> (double-clicked)</p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ </list>
+ <p>
+ In addition to the dedicated Where Am I commands, <app>Orca</app> has
+ two additional commands related to obtaining your present location:
+ </p>
+ <list>
+ <item>
+ <p>Present the title bar:</p>
+ <list>
+ <item>
+ <p>
+ Desktop:<keyseq><key>Orca Modifier</key><key>KP Enter</key></keyseq>
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Slash</key></keyseq>
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Present the status bar:</p>
+ <list>
+ <item>
+ <p>
+ Desktop:<keyseq><key>Orca Modifier</key><key>KP Enter</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ <item>
+ <p>
+ Laptop: <keyseq><key>Orca Modifier</key><key>Slash</key></keyseq>
+ (double-clicked)
+ </p>
+ </item>
+ </list>
+ </item>
+ </list>
+</page>
diff --git a/help/C/figures/orca-logo.png b/help/C/figures/orca-logo.png
new file mode 100644
index 0000000..0f0d058
Binary files /dev/null and b/help/C/figures/orca-logo.png differ
diff --git a/help/C/howto_bookmarks.page b/help/C/howto_bookmarks.page
new file mode 100644
index 0000000..30fe2c0
--- /dev/null
+++ b/help/C/howto_bookmarks.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_bookmarks">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <title type="sort">6. Bookmarks</title>
+ <desc>storing and retrieving objects</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Bookmarks (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_documents.page b/help/C/howto_documents.page
new file mode 100644
index 0000000..0564ee2
--- /dev/null
+++ b/help/C/howto_documents.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_documents">
+ <info>
+ <link type="guide" xref="index#reading"/>
+ <link type="next" xref="howto_text_attributes" />
+ <title type="sort">1. Documents</title>
+ <desc>
+ reading textual information
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Documents (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+ <p>
+ This document will include SayAll
+ </p>
+</page>
diff --git a/help/C/howto_flat_review.page b/help/C/howto_flat_review.page
new file mode 100644
index 0000000..300d71f
--- /dev/null
+++ b/help/C/howto_flat_review.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_flat_review">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <link type="next" xref="howto_orca_find" />
+ <title type="sort">2. Flat Review</title>
+ <desc>examining a window spatially</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Flat Review (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_key_bindings.page b/help/C/howto_key_bindings.page
new file mode 100644
index 0000000..e150d29
--- /dev/null
+++ b/help/C/howto_key_bindings.page
@@ -0,0 +1,155 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_key_bindings">
+ <info>
+ <link type="guide" xref="index#getting_started"/>
+ <link type="next" xref="howto_profiles" />
+ <title type="sort">8. Keybindings</title>
+ <desc>binding, rebinding, and unbinding commands</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Keybindings</title>
+ <p>
+ Orca has many commands, some of which are bound to a keystroke, others
+ of which are unbound. You can bind, rebind, and unbind <app>Orca</app>'s
+ commands by following the steps below.</p>
+ <section id="binding">
+ <title>Binding an Unbound Command</title>
+ <p>To add a keystroke to an unbound command:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link> dialog
+ by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>Move to the <gui>Key Bindings</gui> page.</p>
+ </item>
+ <item>
+ <p>
+ Arrow to the cell which contains the command you want to assign a
+ keystroke to.
+ </p>
+ </item>
+ <item>
+ <p>
+ Arrow once to the right. This will place focus in the <gui>Key
+ Binding</gui> column. Press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Press the desired key combination.</p></item>
+ <item>
+ <p>
+ Press <key>Return</key> to confirm the new combination. The new
+ keystroke will be saved and the check box in the last column (the
+ <gui>Modified</gui> column) will indicate that the key binding
+ has been modified.
+ </p>
+ </item>
+ <item>
+ <p>Press the <gui>Apply</gui> button.</p>
+ </item>
+ </steps>
+ </section>
+ <section id="rebinding">
+ <title>Changing Existing Bindings</title>
+ <p>To change either the key binding or the alternate binding:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link> dialog by
+ pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>Move to the <gui>Key Bindings</gui> page.</p>
+ </item>
+ <item>
+ <p>
+ Arrow to the cell which contains the binding you which to change and press
+ <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Press the desired key combination.</p>
+ </item>
+ <item>
+ <p>
+ Press <key>Return</key> to confirm the new combination. The new
+ keystroke will be saved and the check box in the last column (the
+ <gui>Modified</gui> column) will indicate that the key binding has
+ been modified.
+ </p>
+ </item>
+ <item>
+ <p>Press the <gui>Apply</gui> button.</p>
+ </item>
+ </steps>
+ </section>
+ <section id="restoring">
+ <title>Restoring Original Bindings</title>
+ <p>To restore a modified key binding:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link>
+ dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+ </keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>Move to the <gui>Key Bindings</gui> page.</p>
+ </item>
+ <item>
+ <p>Arrow to the modified column associated with the key binding.</p>
+ </item>
+ <item>
+ <p>Uncheck the checkbox by pressing <key>Space</key>.</p>
+ </item>
+ <item>
+ <p>Press the <gui>Apply</gui> button.</p>
+ </item>
+ </steps>
+ </section>
+ <section id="unbinding">
+ <title>Unbinding Bound Commands</title>
+ <p>To unbind any bound command:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link>
+ dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+ </keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>Move to the <gui>Key Bindings</gui> page.</p>
+ </item>
+ <item>
+ <p>
+ Arrow to the cell which contains the binding you which to delete
+ and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>
+ When prompted for the new keybinding, press <key>Delete</key> or
+ <key>BackSpace</key>. You will be told that the key binding has
+ been removed.
+ </p>
+ </item>
+ <item>
+ <p>Press <key>Return</key> to confirm.</p>
+ </item>
+ <item>
+ <p>Press the <gui>Apply</gui> button.</p>
+ </item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/howto_keyboard_layout.page b/help/C/howto_keyboard_layout.page
new file mode 100644
index 0000000..9e773a4
--- /dev/null
+++ b/help/C/howto_keyboard_layout.page
@@ -0,0 +1,63 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_keyboard_layout">
+ <info>
+ <link type="guide" xref="index#getting_started"/>
+ <link type="next" xref="howto_toggling_caps_lock" />
+ <title type="sort">6. Keyboard Layout</title>
+ <desc>selecting the Desktop or Laptop layout</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Keyboard Layout</title>
+ <p>
+ Orca has two keyboard layouts: Desktop and Laptop. The layout you choose
+ impacts which key is used as the Orca Modifier.
+ </p>
+ <list>
+ <item>
+ <p>
+ If you are using the Laptop layout, the default Orca Modifier will be
+ <key>CapsLock</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ If you are using the Desktop layout, the Orca Modifier will be both
+ <key>Insert</key> and <key>KeyPad Insert</key>, the latter being the
+ same key as <key>KeyPad 0</key>.
+ </p>
+ </item>
+ </list>
+ <p>
+ The layout also determines the keystrokes associated with a number of
+ <app>Orca</app>'s commands, especially in the areas of Flat Review,
+ Where Am I, and Say All.
+ </p>
+ <p>
+ If you want to change your keyboard layout, you can do so by performing
+ the following steps:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link> dialog
+ by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Move to the <gui>Keyboard Layout</gui> group of radio buttons.
+ </p>
+ </item>
+ <item>
+ <p>Arrow to the desired layout.</p>
+ </item>
+ <item>
+ <p>Press the <gui>Apply</gui> button.</p>
+ </item>
+ </steps>
+</page>
diff --git a/help/C/howto_learn_modes.page b/help/C/howto_learn_modes.page
new file mode 100644
index 0000000..1075b0b
--- /dev/null
+++ b/help/C/howto_learn_modes.page
@@ -0,0 +1,77 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_learn_modes">
+ <info>
+ <link type="guide" xref="index#getting_started" />
+ <link type="next" xref="howto_keyboard_layout" />
+ <title type="sort">5. The "Learn" Modes</title>
+ <desc>
+ discovering <app>Orca</app>'s commands
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>The "Learn" Modes</title>
+ <p>
+ Orca has two modes for learning more about <app>Orca</app>'s commands:
+ Learn Mode and List Shortcuts Mode. In Learn Mode, <app>Orca</app>
+ will announce each keystroke you pressed along with any associated
+ <app>Orca</app> command that keystroke is bound to. List Shortcuts
+ Mode provides you with a list of all the <app>Orca</app> commands
+ you can use.
+ </p>
+ <section id="learn_mode">
+ <title>Using Learn Mode</title>
+ <p>To use <app>Orca</app>'s Learn Mode:</p>
+ <steps>
+ <item>
+ <p>
+ Get into Learn Mode by pressing <keyseq><key>Orca Modifier</key>
+ <key>H</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press any key or keystroke. <app>Orca</app> will announce the
+ keys and any associated command.
+ </p>
+ </item>
+ <item>
+ <p>Press <key>Esc</key> to exit Learn Mode.</p>
+ </item>
+ </steps>
+ </section>
+ <section id="list_shortcuts_mode">
+ <title>Using List Shortcuts Mode</title>
+ <p>To use <app>Orca</app>'s List Shortcuts Mode:</p>
+ <steps>
+ <item>
+ <p>
+ Get into List Shortcuts Mode by pressing <keyseq><key>Orca
+ Modifier</key><key>H</key></keyseq> twice quickly.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press <key>1</key> if you want a list of shortcuts that apply
+ <app>Orca</app>-wide, or press <key>2</key> if you want a list
+ of shortcuts that are specifically for the application with focus.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press <key>Up</key> or <key>Down</key> to examine the contents
+ of the list.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press <key>Esc</key> to exit List Shortcuts Mode.
+ </p>
+ </item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/howto_mouse_review.page b/help/C/howto_mouse_review.page
new file mode 100644
index 0000000..30aab01
--- /dev/null
+++ b/help/C/howto_mouse_review.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_mouse_review">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <link type="next" xref="howto_notifications" />
+ <title type="sort">4. Mouse Review</title>
+ <desc>using the pointer to examine the screen</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Mouse Review (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_notifications.page b/help/C/howto_notifications.page
new file mode 100644
index 0000000..ed30e2a
--- /dev/null
+++ b/help/C/howto_notifications.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_notifications">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <link type="next" xref="howto_bookmarks" />
+ <title type="sort">5. Notifications</title>
+ <desc>reading previously-received messages</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Notifications (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_orca_find.page b/help/C/howto_orca_find.page
new file mode 100644
index 0000000..f4e570b
--- /dev/null
+++ b/help/C/howto_orca_find.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_orca_find">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <link type="next" xref="howto_mouse_review" />
+ <title type="sort">3. Orca Find</title>
+ <desc>searching a window for objects</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Orca Find (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_profiles.page b/help/C/howto_profiles.page
new file mode 100644
index 0000000..af587a5
--- /dev/null
+++ b/help/C/howto_profiles.page
@@ -0,0 +1,135 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_profiles">
+ <info>
+ <link type="guide" xref="index#getting_started"/>
+ <link type="next" xref="howto_documents" />
+ <title type="sort">9. Profiles</title>
+ <desc>maintaining multiple configurations</desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Profiles</title>
+ <p>
+ Orca's profiles allow you to save and load multiple configurations so
+ that you can quickly access the settings you need.
+ </p>
+ <section id="save">
+ <title>Saving a New Profile</title>
+ <p>To save a new profile:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences"><link xref="preferences">Orca
+ Preferences</link></link> dialog box.
+ </p>
+ </item>
+ <item>
+ <p>Change whatever settings you wish.</p>
+ </item>
+ <item>
+ <p>
+ On the <gui>General</gui> page, press the <gui>Save As</gui> button.
+ </p>
+ </item>
+ <item>
+ <p>
+ In the resulting <gui>Save Profile As</gui> dialog box, type the new
+ profile name.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press the <gui>OK</gui> button in the <gui>Save Profile As</gui>
+ dialog box.
+ </p>
+ </item>
+ </steps>
+ </section>
+ <section id="load">
+ <title>Loading an Existing Profile</title>
+ <p>To load an existing profile:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences"><link xref="preferences">Orca
+ Preferences</link></link> dialog box.
+ </p>
+ </item>
+ <item>
+ <p>
+ On the <gui>General</gui> page, select the profile to load from
+ the <gui>Active Profile</gui> combo box.
+ </p>
+ </item>
+ <item>
+ <p>Press the <gui>Load</gui> button.</p>
+ </item>
+ <item>
+ <p>
+ You will be asked to confirm. Press the <gui>Yes</gui> button.
+ </p>
+ </item>
+ <item>
+ <p>Press the <gui>OK</gui> button.</p>
+ </item>
+ </steps>
+ </section>
+ <section id="overwrite">
+ <title>Changing an Existing Profile</title>
+ <p>To make changes to an existing profile:</p>
+ <steps>
+ <item>
+ <p>
+ Follow the steps described above to load the profile you wish to change.
+ </p>
+ </item>
+ <item>
+ <p>Follow the steps described above to save a new profile.</p>
+ </item>
+ <item>
+ <p>
+ When prompted for the new profile name, type the same name as current
+ profile. When you press the <gui>OK</gui> button, you will told there
+ is a name conflict.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press the <gui>Yes</gui> button to confirm you wish to overwrite the
+ existing profile with the new settings.
+ </p>
+ </item>
+ </steps>
+ </section>
+ <section id="startup">
+ <title>Changing the <gui>Start-up Profile</gui></title>
+ <p>To change the profile which is loaded when you start <app>Orca</app>:</p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences"><link xref="preferences">Orca
+ Preferences</link></link> dialog box.
+ </p>
+ </item>
+ <item>
+ <p>
+ On the <gui>General</gui> page, select the profile to load from the
+ <gui>Start-up Profile</gui> combo box.
+ </p>
+ </item>
+ <item>
+ <p>Press the <gui>OK</gui> button.</p>
+ </item>
+ <item>
+ <p>
+ The next time you launch <app>Orca</app>, the newly-selected profile
+ will be used.
+ </p>
+ </item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/howto_reading_web.page b/help/C/howto_reading_web.page
new file mode 100644
index 0000000..18d3de4
--- /dev/null
+++ b/help/C/howto_reading_web.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_reading_web">
+ <info>
+ <link type="guide" xref="index#reading"/>
+ <link type="next" xref="howto_web_forms" />
+ <title type="sort">3. Web Pages</title>
+ <desc>
+ navigating content displayed in browsers
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Web Pages (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_setting_up_orca.page b/help/C/howto_setting_up_orca.page
new file mode 100644
index 0000000..6cad527
--- /dev/null
+++ b/help/C/howto_setting_up_orca.page
@@ -0,0 +1,80 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_setting_up_orca">
+<info>
+ <link type="seealso" xref="preferences" />
+ <link type="guide" xref="index#getting_started" />
+ <link type="next" xref="howto_the_orca_modifier" />
+ <title type="sort">3. Orca Configuration</title>
+ <title type="link">Configuration</title>
+ <desc>
+ setting up <app>Orca</app> initially and in the future
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Orca Configuration</title>
+ <section id="initial_setup">
+ <title>Initial Setup</title>
+ <p>
+ When you run <app>Orca</app> for the first time, it will automatically
+ enter setup mode. Depending on your active session's configuration,
+ one of two things will occur:
+ </p>
+ <list>
+ <item>
+ <p>
+ If accessibility support has already been enabled for your
+ session, you will be placed in the <app>Orca</app>
+ <link xref="preferences">Preferences</link> dialog box where
+ you can customize <app>Orca</app> completely and then use it
+ immediately.
+ </p>
+ </item>
+ <item>
+ <p>
+ If accessibility support has not already been enabled for your
+ session, <app>Orca</app>'s <link xref="howto_text_setup">text-based
+ setup</link> will be launched instead. The text-based setup allows
+ you to configure the most fundamental settings and enable
+ accessibility support for your session. You will need to log out
+ and log back in for the new settings to take effect.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="configuring_orca">
+ <title>Configuring <app>Orca</app> in the Future</title>
+ <p>
+ If you want to configure <app>Orca</app> in the future, you can do one
+ of the following:
+ </p>
+ <list>
+ <item>
+ <p>
+ Pass the <cmd>--setup</cmd> option to <app>Orca</app> the next
+ time you run it to automatically be placed in the <link
+ xref="preferences">Preferences</link> dialog box.
+ </p>
+ </item>
+ <item>
+ <p>
+ Pass the <cmd>--text-setup</cmd> option to <app>Orca</app> to
+ re-run <app>Orca</app>'s <link xref="howto_text_setup">text-based
+ setup</link>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Preferences</link> dialog
+ box by pressing the <gui>Preferences</gui> button in the <app>Orca</app>
+ main window or by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+ </keyseq> from within any accessible application.
+ </p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/howto_tables.page b/help/C/howto_tables.page
new file mode 100644
index 0000000..ceee4bd
--- /dev/null
+++ b/help/C/howto_tables.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_tables">
+ <info>
+ <link type="guide" xref="index#reading"/>
+ <link type="next" xref="howto_whereami" />
+ <title type="sort">A5 Tables</title>
+ <desc>
+ accessing document tables efficiently
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Tables (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/howto_text_attributes.page b/help/C/howto_text_attributes.page
new file mode 100644
index 0000000..66cc1e3
--- /dev/null
+++ b/help/C/howto_text_attributes.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_text_attributes">
+ <info>
+ <link type="guide" xref="index#reading"/>
+ <link type="next" xref="howto_reading_web" />
+ <title type="sort">2. Obtaining Text Attribute Information</title>
+ <desc>
+ obtaining formatting details
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Text Attributes (FINISH ME)</title>
+ <section>
+ <title>Obtaining Formatting Information</title>
+ <p>
+ When you press <keyseq><key>Orca Modifier</key><key>F</key>
+ </keyseq>, <app>Orca</app> will speak known text attribute
+ information about an object. In addition, <app>Orca</app>
+ will optionally indicate text attributes in braille by
+ "underlining" them as you navigate a document.
+ </p>
+ <p>
+ Because the number of text attributes is large, and not everyone cares
+ about every attribute, the <link xref="preferences_text_attributes">
+ Text Attributes page of the preferences dialog</link> allows you to
+ customize which text attributes <app>Orca</app> will present in speech,
+ along with the order in which they should be presented, and which ones
+ <app>Orca</app> will indicate in braille.
+ </p>
+ <p>
+ Because the <link xref="preferences_text_attributes">Text Attributes
+ page</link> is also part of the application-specific settings, you can
+ customize text attribute presentation on an as-needed basis for each
+ application you use.
+ </p>
+ </section>
+ <section>
+ <title>Identifying Misspelled Words</title>
+ <p>
+ WRITE ME
+ </p>
+ </section>
+</page>
diff --git a/help/C/howto_text_setup.page b/help/C/howto_text_setup.page
new file mode 100644
index 0000000..0f681d5
--- /dev/null
+++ b/help/C/howto_text_setup.page
@@ -0,0 +1,193 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_text_setup">
+ <info>
+ <desc>
+ a feature which allows you to perform basic configuration of <app>Orca</app> even
+ if the graphical desktop is not running.
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Using Text Setup</title>
+ <p>
+ Orca has a text setup feature which allows you to perform basic configuration
+ of <app>Orca</app> even if the graphical desktop is not running. To launch
+ <app>Orca</app>'s text-only guided setup:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Open a <gui>Run</gui> dialog. For most distros, this can be accomplished
+ by pressing <keyseq><key>Alt</key><key>F2</key></keyseq>. Alternatively,
+ you can use a terminal window.
+ </p>
+ </item>
+ <item>
+ <p>
+ Type <cmd>orca --text-setup</cmd> or <cmd>orca -t</cmd> and press
+ <key>Return</key>.
+ </p>
+ </item>
+ </steps>
+ <p>You will be asked a few questions:</p>
+ <steps>
+ <item>
+ <p>Select desired speech system</p>
+ <p>
+ The choices that follow will depend on which speech systems you have
+ installed on your system. Type the number associated with your desired
+ speech system and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Select desired speech server</p>
+ <p>
+ The choices that follow will depend on which speech synthesizers you have
+ installed on your system. Type the number associated with your desired
+ speech server and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Select desired voice</p>
+ <p>
+ The "voices" correspond with the languages available. In the case of
+ speech-dispatcher, there are approximately 60 languages and dialects
+ supported with more being added regularly. Type in the number of your
+ language choice (e.g., <cmd>7</cmd> for American English) and press
+ <key>Return</key>. You do not need to wait for the entire list to be
+ spoken. In addition, <app>Orca</app> attempts to make your default
+ language the first choice, so in many cases you can simply type
+ <cmd>1</cmd> and press <key>Return</key> without having to listen to
+ the full list of voices.</p>
+ </item>
+ <item>
+ <p>Enable echo by word?</p>
+ <p>
+ This option causes <app>Orca</app> to speak words as you finish typing
+ them. Type <cmd>y</cmd> or <cmd>n</cmd> and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Enable key echo?</p>
+ <p>
+ This option causes <app>Orca</app> to speak all keys as they are pressed.
+ Type <cmd>y</cmd> or <cmd>n</cmd> and press <key>Return</key>.
+ </p>
+ <p>
+ If you indicate that you would like key echo enabled, setup will then
+ ask you about the types of key echo you can enable or disable. For each
+ one, type <cmd>y</cmd> to enable it or <cmd>n</cmd> to disable it and
+ press <key>Return</key>. The types are:
+ </p>
+ <list>
+ <item>
+ <p>alphanumeric and punctuation keys</p>
+ <p>
+ This option controls whether or not keys like <key>a</key>,
+ <key>b</key>, <key>c</key>, <key>;</key>, <key>?</key>, and so on
+ should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>modifier keys</p>
+ <p>
+ This option controls whether or not <key>Shift</key>, <key>Ctrl</key>,
+ <key>Alt</key> and <key>Meta</key> should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>locking keys</p>
+ <p>
+ This option controls whether or not <key>Caps Lock</key>, <key>Scroll
+ Lock</key>, and <key>Num Lock</key> should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>function keys</p>
+ <p>
+ This option controls whether or not <key>F1</key> through <key>F12</key>
+ should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>action keys</p>
+ <p>
+ This option controls whether or not <key>BackSpace</key>,
+ <key>Delete</key>, <key>Return</key>, <key>Escape</key>,
+ <key>Tab</key>, <key>Page Up</key>, <key>Page Down</key>,
+ <key>Home</key>, and <key>End</key> should be spoken when
+ pressed.
+ </p>
+ </item>
+ </list>
+ </item>
+ <item>
+ <p>Select desired keyboard layout.</p>
+ <p>
+ Orca has two keyboard layouts: Desktop and Laptop. The layout you
+ choose impacts which key is used as the Orca Modifier.
+ </p>
+ <list>
+ <item>
+ <p>
+ If you are using the Laptop layout, the default Orca Modifier will
+ be <key>CapsLock</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ If you are using the Desktop layout, the Orca Modifier will be both
+ <key>Insert</key> and <key>KeyPad Insert</key>, the latter being the
+ same key as <key>KeyPad 0</key>.
+ </p>
+ </item>
+ </list>
+ <p>
+ The layout also determines the keystrokes associated with a number of
+ <app>Orca</app>'s commands, especially in the areas of Flat Review,
+ Where Am I, and Say All.
+ </p>
+ <p>
+ Type <cmd>1</cmd> for Desktop layout or <cmd>2</cmd> for Laptop layout
+ and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Enable Braille</p>
+ <p>
+ This functionality assumes a BrlTTY-compatible device is available.
+ Type <cmd>y</cmd> or <cmd>n</cmd> and press <key>Return</key>. Note
+ that you can usually just enter <cmd>y</cmd> here; <app>Orca</app> will
+ recover gracefully and function even if it cannot find BrlTTY.
+ </p>
+ </item>
+ <item>
+ <p>Enable Braille Monitor</p>
+ <p>
+ Orca's Braille Monitor is an on-screen braille representation. This is
+ mostly for sighted developers who need to verify BrlTTY output, but may
+ also be useful in other situations, such as visually diagnosing or verifying
+ braille output. Type <cmd>y</cmd> or <cmd>n</cmd> and press <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>Automatically start <app>Orca</app> when you log in</p>
+ <p>
+ Type <cmd>y</cmd> if you want <app>Orca</app> automatically launched for you
+ or <cmd>n</cmd> if you do not, and press <key>Return</key>.
+ </p>
+ </item>
+ </steps>
+ <p>
+ That's it. <app>Orca</app> is now ready for use. If accessibility was not
+ yet enabled, <app>Orca</app> does so now and asks you to logout and back
+ in for the services to start. Type <cmd>y</cmd> and press <key>Return</key>
+ to restart your login session. If, on the other hand, accessibility was
+ already enabled, you will simply be prompted to press <key>Return</key>
+ after which <app>Orca</app> will be launched for you.
+ </p>
+</page>
diff --git a/help/C/howto_the_orca_modifier.page b/help/C/howto_the_orca_modifier.page
new file mode 100644
index 0000000..39f2a20
--- /dev/null
+++ b/help/C/howto_the_orca_modifier.page
@@ -0,0 +1,79 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_the_orca_modifier">
+ <info>
+ <link type="guide" xref="index#getting_started"/>
+ <link type="next" xref="howto_learn_modes" />
+ <title type="sort">4. The Orca Modifier</title>
+ <desc>
+ a key that works like <key>Shift</key>, <key>Ctrl</key>,
+ and <key>Alt</key>
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>The Orca Modifier</title>
+ <p>
+ Orca has a special modifier key that works like <key>Shift</key>,
+ <key>Ctrl</key>, and <key>Alt</key>. It is designed specifically
+ for performing <app>Orca</app> commands and doing so without
+ introducing conflicts with the commands of the applications you
+ are accessing.
+ </p>
+ <p>
+ Which key the "Orca Modifier" is bound to will, by default, depend
+ on whether you are using <app>Orca</app>'s Laptop keyboard layout
+ or its Desktop keyboard layout:
+ </p>
+ <list>
+ <item>
+ <p>
+ If you are using the Laptop layout, the default Orca Modifier
+ will be <key>CapsLock</key>
+ </p>
+ </item>
+ <item>
+ <p>
+ If you are using the Desktop layout, the Orca Modifier will
+ be both <key>Insert</key> and <key>KeyPad Insert</key>, the
+ latter being the same key as <key>KeyPad 0</key>.
+ </p>
+ </item>
+ </list>
+ <section id="changing_the_modifier">
+ <title>Changing the Orca Modifier</title>
+ <p>
+ If you want to maintain your current keyboard layout but select
+ a different modifier key, you can do so by performing the following
+ steps:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Get into the <link xref="preferences">Orca Preferences</link>
+ dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+ </keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>Move to the <gui>Key Bindings</gui> page.</p>
+ </item>
+ <item>
+ <p>Move to the <gui>Orca Modifier Key(s)</gui> combobox.</p>
+ </item>
+ <item>
+ <p>Arrow to the desired modifier. The available options are:</p>
+ <list>
+ <item><p>Insert, KP_Insert</p></item>
+ <item><p>KP_Insert</p></item>
+ <item><p>Insert</p></item>
+ <item><p>Caps_Lock</p></item>
+ </list>
+ </item>
+ <item><p>Press the <gui>Apply</gui> button.</p></item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/howto_toggling_caps_lock.page b/help/C/howto_toggling_caps_lock.page
new file mode 100644
index 0000000..80442a5
--- /dev/null
+++ b/help/C/howto_toggling_caps_lock.page
@@ -0,0 +1,34 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_toggling_caps_lock">
+ <info>
+ <link type="guide" xref="index#getting_started"/>
+ <link type="next" xref="howto_key_bindings" />
+ <title type="sort">7. CapsLock in Laptop Layout</title>
+ <desc>toggling it when it is the <key>Orca Modifier</key></desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>CapsLock in Laptop Layout</title>
+ <p>
+ Orca has two keyboard layouts: Desktop and Laptop. The layout you choose
+ impacts which key is used as the Orca Modifier. If you are using the Laptop
+ layout, the default Orca Modifier will be <key>CapsLock</key>. If you are
+ using <app>Orca</app>'s Laptop Layout and want to lock or unlock
+ <key>CapsLock</key>, you can do so by performing the following steps:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Press the Bypass command, <keyseq><key>Orca Modifier</key><key>BackSpace</key>
+ </keyseq>, to tell <app>Orca</app> that the next command should be ignored.
+ </p>
+ </item>
+ <item>
+ <p>Press <key>CapsLock</key> to toggle its locked state.</p>
+ </item>
+ </steps>
+</page>
diff --git a/help/C/howto_web_forms.page b/help/C/howto_web_forms.page
new file mode 100644
index 0000000..18d9f8e
--- /dev/null
+++ b/help/C/howto_web_forms.page
@@ -0,0 +1,22 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_web_forms">
+ <info>
+ <link type="guide" xref="index#reading"/>
+ <link type="next" xref="howto_tables" />
+ <title type="sort">4. Form Controls</title>
+ <desc>
+ interacting with embedded widgets
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Form Controls (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
+
diff --git a/help/C/howto_whereami.page b/help/C/howto_whereami.page
new file mode 100644
index 0000000..241b40a
--- /dev/null
+++ b/help/C/howto_whereami.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="howto_whereami">
+ <info>
+ <link type="guide" xref="index#reviewing"/>
+ <link type="next" xref="howto_flat_review" />
+ <title type="sort">1. WhereAmI</title>
+ <desc>
+ identifying and learning about your location
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>WhereAmI (WRITE ME)</title>
+ <p>
+ Write me
+ </p>
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..5ad6173
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="guide" id="index">
+ <info>
+ <title type="link">Introduction to the <app>Orca</app> Screen Reader</title>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>
+ <media type="image" mime="image/png" src="figures/orca-logo.png">
+ <app>Orca</app>'s logo
+ </media>
+ <app>Orca</app> Screen Reader
+ </title>
+ <p>
+ If you are new to screen readers or are unfamiliar with <app>Orca</app>,
+ the guides which follow should get you started with performing common
+ tasks using <app>Orca</app>. If, on the other hand, you are already
+ familiar with how to use a screen reader and just need to know how what
+ options and tools <app>Orca</app> provides, you may prefer to read the
+ guides covering <link xref="preferences"><app>Orca</app>'s Preferences
+ dialogs</link> and <link xref="commands"><app>Orca</app>'s commands</link>.
+ </p>
+ <section id="getting_started" style="2column">
+ <title>Getting Started</title>
+ </section>
+ <section id="reading" style="2column">
+ <title>Reading Documents and Web Pages</title>
+ </section>
+ <section id="reviewing" style="2column">
+ <title>Reviewing and Interacting with Screen Contents</title>
+ </section>
+</page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
new file mode 100644
index 0000000..32c9e6c
--- /dev/null
+++ b/help/C/introduction.page
@@ -0,0 +1,197 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="introduction">
+ <info>
+ <link type="guide" xref="index#getting_started" />
+ <link type="next" xref="howto_setting_up_orca" />
+ <title type="sort">1. Welcome to Orca</title>
+ <desc>
+ introducing the <app>Orca</app> screen reader
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Welcome to Orca</title>
+ <p>
+ <app>Orca</app> is a free, open source, flexible, and extensible
+ screen reader that provides access to the graphical desktop via
+ user-customizable combinations of speech, braille, and/or
+ magnification.
+ </p>
+ <p>
+ <app>Orca</app> works with applications and toolkits that support
+ the assistive technology service provider interface (AT-SPI), which
+ is the primary assistive technology infrastructure for Linux and
+ Solaris. Applications and toolkits supporting the AT-SPI include the
+ GNOME Gtk+ toolkit, the Java platform's Swing toolkit, OpenOffice,
+ Gecko, and WebKitGtk. AT-SPI support for the KDE Qt toolkit is being
+ pursued.
+ </p>
+ <section id="launching">
+ <title>Launching <app>Orca</app></title>
+ <p>To launch <app>Orca</app>:</p>
+ <list>
+ <item>
+ <p>
+ Type <cmd>orca</cmd>, along with any optional parameters, in a
+ terminal window or within the <gui>Run</gui> dialog and then press
+ <key>Return</key>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Configure <app>Orca</app> to launch automatically, by enabling
+ this option in <app>Orca</app>'s <link xref="howto_text_setup">text
+ setup</link> or on the <gui>General</gui> page of <app>Orca</app>'s
+ <link xref="preferences">Preferences dialog</link>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Configure <app>Orca</app> to be launched automatically as your
+ preferred screen reader by choosing this option in GNOME's
+ <gui>Assistive Technology Preferences</gui> dialog.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="quitting">
+ <title>Quitting <app>Orca</app></title>
+ <p>To quit <app>Orca</app>:</p>
+ <list>
+ <item>
+ <p>
+ Press the <gui>Quit</gui> button in the <app>Orca</app> main
+ window.
+ </p>
+ </item>
+ <item>
+ <p>
+ Press <keyseq><key>Orca Modifier</key><key>Q</key></keyseq>.
+ This command works whether the <app>Orca</app> main window is
+ enabled or not.
+ </p>
+ </item>
+ <item>
+ <p>
+ Type <cmd>orca -q</cmd> or <cmd>orca --quit</cmd> in a terminal
+ window or within the <gui>Run</gui> dialog and then press
+ <key>Return</key>.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="loadtime">
+ <title>Load-Time Options</title>
+ <p>
+ The following options can be specified when launching <app>Orca</app>:
+ </p>
+ <list>
+ <item>
+ <p><cmd>-?</cmd>, <cmd>--help</cmd>: Show the help message</p>
+ </item>
+ <item>
+ <p>
+ <cmd>-v</cmd>, <cmd>--version</cmd>: Show the version of
+ <app>Orca</app>
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-s</cmd>, <cmd>--setup</cmd>, <cmd>--gui-setup</cmd>:
+ Set up user preferences
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-t</cmd>, <cmd>--text-setup</cmd>: Set up user preferences
+ (text version)
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-n</cmd>, <cmd>--no-setup</cmd>Skip set up of user preferences
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-u</cmd>, <cmd>--user-prefs-dir=<em>dirname</em></cmd>:
+ Use <em>dirname</em> as the alternate directory for user
+ preferences
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-e</cmd>, <cmd>--enable=<em>option</em></cmd>: Force use
+ of option, where the <em>option</em> can be one of the following:
+ </p>
+ <list>
+ <item><p><cmd>speech</cmd></p></item>
+ <item><p><cmd>braille</cmd></p></item>
+ <item><p><cmd>braille-monitor</cmd></p></item>
+ <item><p><cmd>magnifier</cmd></p></item>
+ <item><p><cmd>main-window</cmd></p></item>
+ <item><p><cmd>splash-window</cmd></p></item>
+ </list>
+ </item>
+ <item>
+ <p>
+ <cmd>-d</cmd>, <cmd>--disable=<em>option</em></cmd>: Prevent the
+ use of an option, where the <em>option</em> can be one of the
+ following:
+ </p>
+ <list>
+ <item><p><cmd>speech</cmd></p></item>
+ <item><p><cmd>braille</cmd></p></item>
+ <item><p><cmd>braille-monitor</cmd></p></item>
+ <item><p><cmd>magnifier</cmd></p></item>
+ <item><p><cmd>main-window</cmd></p></item>
+ <item><p><cmd>splash-window</cmd></p></item>
+ </list>
+ </item>
+ <item>
+ <p>
+ <cmd>-i</cmd>, <cmd>--import-file=<em>filename</em></cmd>:
+ Import a profile from a given <app>Orca</app> profile file
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-q</cmd>, <cmd>--quit</cmd>: Quits <app>Orca</app>
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-f</cmd>, <cmd>--forcequit</cmd>: Forces <app>Orca</app>
+ to be terminated immediately.
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>--replace</cmd>: Replace a currently-running <app>Orca</app>
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>-l</cmd>, <cmd>--list-apps</cmd>: Print the known running
+ applications
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>--debug</cmd>: Send debug output to debug-YYYY-MM-DD-HH:MM:SS.out
+ </p>
+ </item>
+ <item>
+ <p>
+ <cmd>--debug-file=<em>filename</em></cmd>: Send debug output to
+ the specified file
+ </p>
+ </item>
+ </list>
+ </section>
+
+</page>
diff --git a/help/C/preferences.page b/help/C/preferences.page
new file mode 100644
index 0000000..13c25bf
--- /dev/null
+++ b/help/C/preferences.page
@@ -0,0 +1,65 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="guide" id="preferences">
+ <info>
+ <link type="next" xref="preferences_general" />
+ <link type="seealso" xref="index" />
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ <desc>
+ <app>Orca</app>'s preferences dialogs allow you to customize the
+ behavior and features of <app>Orca</app>, including speech, braille,
+ magnification, and keyboard layout. These customizations can be set
+ globally or be limited to a particular application. These guides will
+ familiarize you with all of the customizations which you can make.
+ </desc>
+ </info>
+ <title><app>Orca</app>'s Preferences Dialogs</title>
+ <p>
+ <app>Orca</app>'s preferences dialogs allow you to customize the behavior
+ and features of <app>Orca</app>, including speech, braille, magnification,
+ and keyboard layout. These customizations can be set globally or be limited
+ to a particular application. These guides will familiarize you with all of
+ the customizations which you can make.
+ </p>
+ <note style="tip">
+ <title>Keyboard Shortcuts for Getting Into the Preferences Dialogs</title>
+ <list>
+ <item>
+ <p>
+ <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>:
+ <app>Orca</app>'s Preferences
+ </p>
+ </item>
+ <item>
+ <p>
+ <keyseq><key>Ctrl</key><key>Orca Modifier</key><key>Space</key>
+ </keyseq>: <app>Orca</app>'s Preferences for the current
+ application
+ </p>
+ </item>
+ </list>
+ </note>
+ <section id="orca" style="2column">
+ <title>Orca Preferences</title>
+ <p>
+ These preferences allow you to customize functionality in <app>Orca</app>
+ that applies to all applications. As a result, with the exception of the
+ General Preferences, you will find the following available in both the
+ <app>Orca</app> Preferences dialog and <app>Orca</app>'s
+ application-specific preferences dialogs.</p>
+ </section>
+ <section id="application" style="2column">
+ <title>Application-Unique Preferences</title>
+ <p>
+ These preferences allow you to customize <app>Orca</app> functionality
+ that only applies in certain environments, such as on web pages or in
+ chat applications. As a result, you will only find these options
+ available in the application-specific preferences dialogs and only for
+ those applications to which these options apply.
+ </p>
+ </section>
+</page>
diff --git a/help/C/preferences_braille.page b/help/C/preferences_braille.page
new file mode 100644
index 0000000..eb2f171
--- /dev/null
+++ b/help/C/preferences_braille.page
@@ -0,0 +1,99 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_braille">
+ <info>
+ <title type="sort">3. Braille</title>
+ <title type="link">Braille</title>
+ <desc>
+ configuring <app>Orca</app>'s braille display support
+ </desc>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_key_echo" />
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Braille Preferences</title>
+ <section id="braillesupport">
+ <title>Enable Braille Support</title>
+ <p>
+ This check box toggles whether or not <app>Orca</app> will make
+ use of a braille display. If BrlTTY is not running, <app>Orca</app>
+ will recover gracefully and will not communicate with the braille
+ display.
+ </p>
+ <note style="tip">
+ <p>
+ If you configure BrlTTY later on, you need to restart <app>Orca</app>
+ in order to use braille.
+ </p>
+ </note>
+ </section>
+ <section id="braillemonitor">
+ <title>Enable Braille Monitor</title>
+ <p>
+ 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 <app>Orca</app>
+ developers who do not have access to a braille display.
+ </p>
+ </section>
+ <section id="contractedbraille">
+ <title>Enable Contracted Braille</title>
+ <p>TODO: Get rid of the wiki reference; put basic docs here.</p>
+ <p>
+ Orca supports contracted braille via the liblouis project.
+ Refer to the <app>Orca</app> Wiki, where you can find additional
+ information about setting up liblouis with <app>Orca</app>.
+ </p>
+ </section>
+ <section id="rolenames">
+ <title>Abbreviated Role Names</title>
+ <p>
+ This check box determines the manner in which role names are
+ displayed and can be used to help conserve real estate on the
+ braille display. For instance, if a slider had focus, the word
+ "slider" would be displayed if abbreviated role names is not
+ checked; if it were checked, "sldr" would be displayed instead.
+ </p>
+ </section>
+ <section id="eolindicator">
+ <title>Disable end of line symbol</title>
+ <p>
+ Checking this checkbox tells <app>Orca</app> to not present the
+ "$l" string at the end of a line of text.
+ </p>
+ </section>
+ <section id="verbosity">
+ <title>Verbosity</title>
+ <p>
+ This radio button group determines the amount of information that
+ will be brailled 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.
+ </p>
+ </section>
+ <section id="selectionandhyperlink">
+ <title>Selection and Hyperlink Indicators</title>
+ <p>
+ The <gui>Selection Indicator</gui> and <gui>Hyperlink Indicator</gui>
+ radio button groups allow you to configure <app>Orca</app>'s behavior
+ when displaying selected text and hyperlinks. By default, when you
+ encounter either, <app>Orca</app> will "underline" that text on
+ your braille display with Dots 7 and 8. If you would prefer, you
+ can change the indicator to only be Dot 7, only be Dot 8, or not
+ be present at all.
+ </p>
+ <note style="tip">
+ <title>Text Attribute Indicators</title>
+ <p>
+ You can also optionally have text attributes indicated in braille.
+ Enabling this feature and choosing which attributes are of
+ interest is done on the <link xref="preferences_text_attributes">
+ <gui>Text Attributes</gui> page</link> of the preferences dialog.
+ </p>
+ </note>
+ </section>
+</page>
diff --git a/help/C/preferences_chat.page b/help/C/preferences_chat.page
new file mode 100644
index 0000000..6d82ed5
--- /dev/null
+++ b/help/C/preferences_chat.page
@@ -0,0 +1,68 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_chat">
+ <info>
+ <link type="guide" xref="preferences#application" />
+ <title type="sort">3. Chat</title>
+ <title type="link">Chat</title>
+ <desc>
+ configuring <app>Orca's</app> support for IM and IRC
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Chat Preferences</title>
+ <p>
+ The following options allow you to customize how <app>Orca</app>
+ behaves when providing access to instant messaging and internet
+ relay chat clients.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Speak Chat Room name</gui>: If this checkbox is checked,
+ <app>Orca</app> will prefix incoming messages with the name
+ of the room or buddy they came from, unless they came from
+ the currently-focused conversation.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Announce when your buddies are typing</gui>: If this
+ checkbox is checked, and if <app>Orca</app> has sufficient
+ information identifying that your buddy is typing,
+ <app>Orca</app> will announce changes in typing status.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Provide chat room specific message histories</gui>: If
+ this checkbox is checked, <app>Orca</app>'s commands for
+ reviewing recent messages will only apply to the currently-focused
+ conversation. Otherwise, the history will contain the most recent
+ messages regardless of which conversation they came from.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Speak messages from</gui> group of radio buttons allows
+ you to control under what circumstances <app>Orca</app> will
+ present an incoming message to you. Your choices are:
+ </p>
+ <list>
+ <item>
+ <p><gui>All channels</gui></p>
+ </item>
+ <item>
+ <p><gui>A channel only if its window is active</gui></p>
+ </item>
+ <item>
+ <p><gui>All channels when any chat window is active</gui></p>
+ </item>
+ </list>
+ </item>
+ </list>
+</page>
diff --git a/help/C/preferences_gekco.page b/help/C/preferences_gekco.page
new file mode 100644
index 0000000..e8e13e6
--- /dev/null
+++ b/help/C/preferences_gekco.page
@@ -0,0 +1,84 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_gecko">
+ <info>
+ <link type="guide" xref="preferences#application" />
+ <link type="next" xref="preferences_structural_navigation" />
+ <link type="seealso" xref="commands_structural_navigation" />
+ <link type="seealso" xref="howto_reading_web" />
+ <title type="sort">1. Gecko Navigation</title>
+ <title type="link">Gecko Navigation</title>
+ <desc>
+ configuring <app>Orca</app>'s caret navigation
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Gecko Navigation Preferences</title>
+ <p>
+ The following options allow you to customize how <app>Orca</app>
+ behaves in Gecko-based applications, including Firefox, Thunderbird,
+ and Yelp 2.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Use <app>Orca</app> Caret Navigation</gui>: This checkbox
+ toggles <app>Orca</app>'s caret navigation on and off. It is checked
+ by default. To toggle this setting on the fly without saving it, use
+ <keyseq><key>Orca Modifier</key><key>F12</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Grab focus on objects when navigating</gui>: If this checkbox
+ is checked, <app>Orca</app> will perform an explicit focus grab as
+ you navigate using the <app>Orca</app>-controlled caret. Doing this
+ was necessary in older versions of Firefox and Thunderbird. It is
+ unchecked by default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Position cursor at start of line when navigating vertically</gui>:
+ If this checkbox is checked, <app>Orca</app> will always move the caret
+ to the beginning of the line when <app>Orca</app> is controlling the
+ caret and you press Up or Down Arrow to read the previous or next line.
+ If this checkbox is not checked, <app>Orca</app> will attempt to keep
+ the caret in the same horizontal position as you navigate Up or Down.
+ It is checked by default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Speak results during find</gui>: If this checkbox is checked,
+ <app>Orca</app> will read the line which matches your current search
+ query when you are using the application's Find toolbar to perform
+ your search. It is checked by default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Only speak changed lines during find</gui>: If this checkbox
+ is checked, <app>Orca</app> will not present the matching line if
+ it is the same line as the previous match. This option is designed
+ to prevent "chattiness" on a line with multiple instances of the
+ string for which you are searching. It is unchecked by default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Minimum length of matched text</gui>: The number of characters
+ which much match before <app>Orca</app> announces the matching line.
+ The default value is four characters.
+ </p>
+ </item>
+ </list>
+ <p>
+ See <link xref="preferences_structural_navigation" /> for additional
+ preferences related to Structural Navigation.
+ </p>
+</page>
diff --git a/help/C/preferences_general.page b/help/C/preferences_general.page
new file mode 100644
index 0000000..811aa99
--- /dev/null
+++ b/help/C/preferences_general.page
@@ -0,0 +1,167 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_general">
+ <info>
+ <title type="sort">1. General</title>
+ <title type="link">General</title>
+ <desc>
+ configuring <app>Orca</app>'s fundamental behaviors
+ </desc>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_speech" />
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>General Preferences</title>
+ <section id="keyboardlayout">
+ <info>
+ <desc>
+ Preferences dialog box option to select which <app>Orca</app> keyboard
+ layout to use, desktop or laptop.
+ </desc>
+ </info>
+ <title>Keyboard Layout</title>
+ <p>
+ The <gui>keyboard layout</gui> options allow you to specify if
+ you will be working on a desktop (i.e. with a numeric keypad)
+ or laptop keyboard. Which layout you choose will determine both
+ the Orca Modifier key as well as a number of keyboard shortcuts
+ for performing <app>Orca</app> commands.</p>
+ </section>
+ <section id="quitorca">
+ <info>
+ <desc>
+ Preferences dialog box option to quit <app>Orca</app> without
+ presenting a confirmation dialog.
+ </desc>
+ </info>
+ <title>Quit <app>Orca</app> Without Confirmation</title>
+ <p>
+ Normally, when you quit <app>Orca</app>, <app>Orca</app> will pop
+ up a confirmation dialog asking you if you want to quit. Unchecking
+ the <gui>Quit <app>Orca</app> without confirmation</gui> checkbox
+ prevents the confirmation window from appearing.
+ </p>
+ </section>
+ <section id="disablegksu">
+ <info>
+ <desc>
+ Preferences dialog box option to disable gksu keyboard grab.
+ </desc>
+ </info>
+ <title>Disable gksu Keyboard Grab</title>
+ <p>
+ When running commands from the launch menu, many distributions
+ use an application known as gksu to authorize the user to run
+ these commands; gksu is the GUI that asks you for your password.
+ When it runs, gksu 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 <app>Orca</app>. The
+ result of a keyboard grab is that <app>Orca</app> will not receive
+ any keyboard events, preventing <app>Orca</app> from functioning
+ normally.
+ </p>
+ <p>
+ By checking the "Disable gksu keyboard grab" checkbox, you will
+ turn off the keyboard grab behavior, allowing <app>Orca</app> to
+ function normally with system administration applications.
+ </p>
+ <p>
+ The keyboard grab is a security attempt by gksu to prevent nefarious
+ applications from "sniffing" the keyboard and grabbing secret
+ information. Please be advised that disabling the gksu keyboard grab
+ feature can expose you to such nefarious behavior. 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 logout and log back in as root whenever you want to
+ perform a system administration command.
+ </p>
+ </section>
+ <section id="presenttooltips">
+ <info>
+ <desc>
+ Preferences dialog box option to enable presentation of tooltips which
+ appear as the result of mouse hovering.
+ </desc>
+ </info>
+ <title>Present Tooltips</title>
+ <p>
+ When checked, this option will tell <app>Orca</app> to present information
+ about tooltips when they appear as the result of mouse hovering. Specific
+ actions to force tooltips to appear, such as pressing <keyseq>
+ <key>Ctrl</key><key>F1</key></keyseq> when an object has focus, will
+ always result in tooltips being presented, regardless of this setting.
+ </p>
+ </section>
+ <section id="showmainwindow">
+ <info>
+ <desc>
+ Preferences dialog box option for showing or hiding the <app>Orca</app>
+ main window.
+ </desc>
+ </info>
+ <title>Show <app>Orca</app> Main Window</title>
+ <p>
+ The <app>Orca</app> main window provides you with a graphical way to
+ display the <link xref="preferences">Orca Preferences</link> dialog,
+ access help content, bring up the About dialog, and quit <app>Orca</app>.
+ Many users do not like the <app>Orca</app> main window because it shows
+ up in the window manager's Tab order when you press <keyseq>
+ <key>Alt</key><key>Tab</key></keyseq> to switch windows. By unchecking
+ the "Show <app>Orca</app> main window" checkbox, you can tell
+ <app>Orca</app> to not show the <app>Orca</app> main window.
+ </p>
+ </section>
+ <section id="autolaunch">
+ <info>
+ <desc>
+ Preferences dialog box option to cause <app>Orca</app> to automatically
+ start when you log in.
+ </desc>
+ </info>
+ <title>Start <app>Orca</app> When You Login</title>
+ <p>
+ When checked, this option will tell the system to automatically launch
+ <app>Orca</app> when you log in.
+ </p>
+ </section>
+ <section id="objectundermouse">
+ <info>
+ <desc>
+ Preferences dialog box option to enable presentation of the object
+ under the mouse pointer.
+ </desc>
+ </info>
+ <title>Speak Object Under Mouse</title>
+ <p>
+ When checked, this option will tell <app>Orca</app> to present
+ information about the object under the mouse pointer as you move
+ it around the screen.
+ </p>
+ </section>
+ <section id="timeanddate">
+ <info>
+ <desc>
+ Preferences dialog box options for customizing the time and date
+ formats used by <app>Orca</app>.
+ </desc>
+ </info>
+ <title>Time and Date Formats</title>
+ <p>
+ The Time Format and Date Format combo boxes allow you to select the
+ format <app>Orca</app> uses when presenting the time and the date.
+ </p>
+ </section>
+ <section id="profiles">
+ <info>
+ <desc>
+ Preferences dialog box options for managing settings profiles.
+ </desc>
+ </info>
+ <title>Profiles</title>
+ <p>WRITEME</p>
+ </section>
+</page>
diff --git a/help/C/preferences_key_bindings.page b/help/C/preferences_key_bindings.page
new file mode 100644
index 0000000..2fe9af3
--- /dev/null
+++ b/help/C/preferences_key_bindings.page
@@ -0,0 +1,86 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_key_bindings">
+ <info>
+ <link type="guide" xref="preferences#orca"/>
+ <link type="next" xref="preferences_pronunciation" />
+ <link type="seealso" xref="howto_key_bindings" />
+ <title type="sort">6. Key Bindings</title>
+ <title type="link">Key Bindings</title>
+ <desc>
+ configuring <app>Orca</app>'s keyboard shortcuts
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Key Bindings Preferences</title>
+ <section id="orca_modifier_keys">
+ <info>
+ <desc>
+ Preferences dialog box option to select the Orca Modifier key.
+ </desc>
+ </info>
+ <title>Orca Modifier Keys</title>
+ <p>
+ The <gui>Orca Modifier Keys</gui> combo box allows you to select which
+ key or keys will serve as the Orca Modifier. The available options are:
+ </p>
+ <list>
+ <item><p>Insert, KP_Insert</p></item>
+ <item><p>KP_Insert</p></item>
+ <item><p>Insert</p></item>
+ <item><p>Caps_Lock</p></item>
+ </list>
+ </section>
+ <section id="key_bindings_table">
+ <title>The Key Bindings Table</title>
+ <p>
+ The key bindings table provides a list of <app>Orca</app> operations
+ and the keys that are bound to them.
+ </p>
+ <list>
+ <item>
+ <p>
+ The <gui>Function</gui> column is a description of the
+ <app>Orca</app> operation to be performed.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Key Binding</gui> is the primary way to invoke the function
+ from the keyboard. Note that the key binding may include the word
+ "Orca". This indicates that the <key>Orca Modifier</key> key should
+ be held down along with the other keys. You can modifiy the value of
+ this column by pressing <key>Return</key>, pressing the keys for the
+ new binding, and pressing <key>Return</key> again.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Alternate</gui> column allows you to specify an additional
+ keybinding for this function. You can modifiy the value of this
+ column by pressing <key>Return</key>, pressing the keys for the new
+ binding, and pressing <key>Return</key> again.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Modified</gui> column serves both as an indicator to what
+ has been changed and as a way to restore the default bindings
+ associated with that function.
+ </p>
+ </item>
+ </list>
+ <p>
+ Beneath the list of <app>Orca</app> keybindings, you will find a group
+ of "unbound" commands. These are commands which we feel will be very
+ useful for some users, but not needed by most users. Rather than "use
+ up" a keystroke for such commands, we have left them unassigned by
+ default. At the end of the list are the braille bindings, for use with
+ a refreshable braille display.
+ </p>
+ </section>
+</page>
diff --git a/help/C/preferences_key_echo.page b/help/C/preferences_key_echo.page
new file mode 100644
index 0000000..e36a67a
--- /dev/null
+++ b/help/C/preferences_key_echo.page
@@ -0,0 +1,123 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_key_echo">
+ <info>
+ <title type="link">Key Echo</title>
+ <title type="sort">4. Key Echo</title>
+ <desc>
+ configuring what is spoken as you type
+ </desc>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_magnifier" />
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Key Echo Preferences</title>
+ <section id="keyecho">
+ <title>Enable key echo</title>
+ <p>
+ Orca's key echo setting controls what happens each time you press
+ a key. To enable key echo, check the "Enable key echo" checkbox.
+ Doing so causes additional checkboxes to become available through
+ which you can choose exactly which keys should and should not be
+ echoed to best suit your needs:
+ </p>
+ <list>
+ <item>
+ <p>Enable alphanumeric and punctuation keys</p>
+ <p>
+ This option controls whether or not keys like <key>a</key>,
+ <key>b</key>, <key>c</key>, <key>;</key>, <key>?</key>, and
+ so on should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>Enable modifier keys</p>
+ <p>
+ This option controls whether or not <key>Shift</key>,
+ <key>Ctrl</key>, <key>Alt</key> and <key>Meta</key> should be
+ spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>Enable locking keys</p>
+ <p>
+ This option controls whether or not <key>Caps Lock</key>,
+ <key>Scroll Lock</key>, and <key>Num Lock</key> should be
+ spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>Enable function keys</p>
+ <p>
+ This option controls whether or not <key>F1</key> through
+ <key>F12</key> should be spoken when pressed.
+ </p>
+ </item>
+ <item>
+ <p>Enable action keys</p>
+ <p>
+ This option controls whether or not <key>BackSpace</key>,
+ <key>Delete</key>, <key>Return</key>, <key>Escape</key>,
+ <key>Tab</key>, <key>Page Up</key>, <key>Page Down</key>,
+ <key>Home</key>, and <key>End</key> should be spoken when
+ pressed.
+ </p>
+ </item>
+ <item>
+ <p>Enable navigation keys</p>
+ <p>
+ This option controls whether or not <key>Left</key>,
+ <key>Right</key>, <key>Up</key>, and <key>Down</key>
+ should be spoken when pressed. This option also applies
+ to any key combination in which <key>Orca Modifier</key>
+ is being held down, for instance when flat review is being
+ used.
+ </p>
+ </item>
+ <item>
+ <p>Enable non-spacing diacritical keys</p>
+ <p>
+ This option controls whether or not "dead keys" used to
+ generate accented letters should be spoken when pressed.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="characterecho">
+ <title>Enable echo by character</title>
+ <p>
+ Enabling this option causes Orca to echo the character
+ you just typed. While echo by character seems quite similar
+ to the key echo of alphanumeric and punctuation keys,
+ there are important differences, especially with respect to
+ accented letters and other symbols for which there is no
+ dedicated key. Key echo causes <app>Orca</app> to announce what
+ you just pressed; character echo causes it to announce what was
+ inserted. Thus to have accented characters spoken as you type them,
+ you should enable this option.
+ </p>
+ <note style="tip">
+ <title>Enabling both key echo and character echo</title>
+ <p>
+ If you like key echo and you frequenty type accented characters,
+ consider enabling both. <app>Orca</app>'s character echo logic
+ attempts to filter out characters which were spoken as a result
+ of key echo, thus minimizing the likelihood of "double speaking"
+ as you type.
+ </p>
+ </note>
+ </section>
+ <section id="wordandsentenceecho">
+ <title>Enable echo by word and Enable echo by sentence</title>
+ <p>
+ Checking the <gui>Enable echo by word</gui> checkbox causes
+ <app>Orca</app> to echo the word you just typed. Similarly,
+ checking the <gui>Enable echo by sentence</gui> checkbox causes
+ <app>Orca</app> to echo the sentence you just typed.
+ </p>
+ </section>
+</page>
diff --git a/help/C/preferences_magnifier.page b/help/C/preferences_magnifier.page
new file mode 100644
index 0000000..304ca35
--- /dev/null
+++ b/help/C/preferences_magnifier.page
@@ -0,0 +1,353 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_magnifier">
+ <info>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_key_bindings" />
+ <title type="sort">5. Magnifier</title>
+ <title type="link">Magnifier</title>
+ <desc>
+ configuring magnification, colors, and pointer
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Magnifier Preferences</title>
+ <section id="enable_magnifier">
+ <title>Enable Magnifier</title>
+ <p>
+ The <gui>Enable magnifier</gui> check box enables and disables
+ <app>Orca</app>'s magnification support. When it is unchecked,
+ the other widgets on this page become unavailable.
+ </p>
+ </section>
+ <section id="zoomer">
+ <title>Zoomer</title>
+ <p>
+ The <gui>Zoomer</gui> options allow you to customize the magnifier's
+ position, size, and level.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Scale factor</gui> can be used to set the magnification
+ level from 1.0x to 16.0x (fractional values are supported).
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Position</gui> can be used to specify the placement of the
+ magnifier on your screen. The available positions are:
+ </p>
+ <list>
+ <item><p><gui>Full Screen</gui> (default)</p></item>
+ <item><p><gui>Left Half</gui></p></item>
+ <item><p><gui>Right Half</gui></p></item>
+ <item><p><gui>Top Half</gui></p></item>
+ <item><p><gui>Bottom Half</gui></p></item>
+ <item><p><gui>Custom</gui></p></item>
+ </list>
+ </item>
+ <item>
+ <p>
+ Choosing <gui>Custom</gui> causes four spin buttons to become
+ available:
+ </p>
+ <list>
+ <item><p><gui>Top</gui></p></item>
+ <item><p><gui>Left</gui></p></item>
+ <item><p><gui>Right</gui></p></item>
+ <item><p><gui>Bottom</gui></p></item>
+ </list>
+ <p>
+ These spin buttons allow you to define the location of each edge
+ of the zoom window. Units are in pixels.
+ </p>
+ </item>
+ <item><p>TODO: Add Hide System Pointer Option</p></item>
+ </list>
+ </section>
+ <section id="tracking_and_alignment">
+ <title>Tracking and Alignment</title>
+ <p>These options control the tracking of the mouse cursor.</p>
+ <section id="mouse_pointer">
+ <title>Mouse Pointer</title>
+ <p>
+ The <gui>Mouse Pointer</gui> combo box allows you to select
+ your tracking and alignment from the following options:
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Centered</gui>: Keeps the mouse pointer at the center
+ of the screen whenever possible. This is the default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Proportional</gui>: Positions the mouse pointer in the
+ zoom window relative to its actual, unmagnified position. For
+ instance, if the mouse pointer is 25% away from the left edge
+ of the desktop, <app>Orca</app> positions the magnified mouse
+ pointer 25% from the left edge of the zoom window.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Push</gui>: Moves the zoomer window the least amount
+ necessary to keep the mouse pointer on the screen.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>None</gui>: Moving the mouse pointer has no impact on
+ what the zoomer window displays.
+ </p>
+ </item>
+ </list>
+ <p>
+ The <gui>Pointer follows zoomer</gui> checkbox allows you to
+ customize what should occur if the mouse pointer is not on the
+ screen when you initially move the mouse. With this option
+ enabled, if the mouse pointer is not on the screen when you
+ initially move the mouse, it will be moved into the zoomer
+ so that you can continue to see what you were working on. If
+ your preferred mouse tracking mode is centered, the pointer
+ will be moved to the center; otherwise it will be moved to the
+ item with focus. This option is enabled by default.
+ </p>
+ </section>
+ <section id="control_and_menu_item">
+ <title>Control and menu item</title>
+ <p>These options control additional behavior of the magnifier.</p>
+ <list>
+ <item>
+ <p>
+ <gui>Centered</gui>: When navigating via keyboard, keep
+ the focused dialog box control or menu item at the center
+ of the screen whenever possible.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Push</gui>: When navigating via keyboard, move the
+ zoomer window the least amount necessary to display the
+ focused dialog box control or menu item. This is the
+ default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>None</gui>: Using the keyboard to navigate among
+ dialog box controls and menu items will have no impact
+ on what the zoomer window displays.
+ </p>
+ </item>
+ </list>
+ <p>
+ <gui>Pointer follows focus</gui>: If this option is enabled,
+ the mouse pointer will follow you as you arrow through menu
+ items and move among controls in dialog boxes. This option
+ is disabled by default.
+ </p>
+ </section>
+ <section id="text_cursor">
+ <title>Text cursor</title>
+ <p>These options control how the text cursor behaves.</p>
+ <list>
+ <item>
+ <p>
+ <gui>Centered</gui>: As the text cursor moves, keep it at
+ the center of the screen whenever possible.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Push</gui>: As the text cursor moves, move the zoomer
+ window the least amount necessary to display it. This is
+ the default.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>None</gui>: Moving the text cursor will have no impact
+ on what the zoomer window displays.
+ </p>
+ </item>
+ </list>
+ <p>
+ The <gui>Edge margin</gui> is how close the caret should be
+ allowed to get to the edge of the screen before it's time to
+ "push" the zoomer window. The margin can range from 0 to 50%,
+ with 50% being the equivalent of choosing centering. The default
+ value is 0. This option is only available if "Push" is your text
+ cursor tracking mode.
+ </p>
+ </section>
+ </section>
+ <section id="color">
+ <title>Color</title>
+ <p>
+ The <gui>Color</gui> options allow you to do some rough color
+ adjustments of the magnified region.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Invert colors</gui>: Creates a reverse or negative-image
+ effect.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Brightness</gui>: Ranges from -1 to 1 (-1 is black/no
+ brightness; 1 is white/total brightness; 0 is "normal"/unchanged).
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Contrast</gui>: Ranges from -1 to 1 (-1 is grey/no contrast;
+ 1 is maximum contrast; 0 is "normal"/unchanged).
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="border">
+ <title>Border</title>
+ <p>
+ The <gui>Border</gui> options can be used to customize the border
+ which separates the magnified region from the non-magnified region.
+ As such, these options are not available when <gui>Full Screen</gui>
+ is selected.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Enable border</gui>: This option determines if a window
+ border is visible for the magnifier.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Border size</gui>: This value determines the size of the
+ border in pixels.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="cursor">
+ <title>Cursor</title>
+ <p>
+ These controls can be used to customize the size and color of the
+ magnifier's cursor.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Enable cursor</gui>: If this check box is enabled then a
+ cursor is visible and the size and color options become available.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Custom size</gui>: Enable this check box if you would like
+ to make the mouse pointer larger than it normally is. The cursor
+ size can be changed from the default value of 32 pixels.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Custom color</gui>: If the cursor is enabled, a custom color
+ can also be applied.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="crosshair">
+ <title>Cross-hair</title>
+ <p>
+ This set of controls can be used to customize the magnifier's optional
+ area-targeting cursor.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Enable cross-hair</gui>: If checked, you can additionally
+ configure the clipping behavior, size and color of the cross-hair.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Enable cross-hair clip</gui>: If enabled, the cross-hair
+ will be "clipped" (removed) in the area immediately surrounding
+ the mouse pointer.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Cross-hair size</gui>: This control sets the thickness
+ of the cross-hair in pixels.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Cross-hair color</gui>: This control allows a custom color
+ to be used for the cross-hair.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="advanced">
+ <title>Advanced</title>
+ <p>
+ If you press the <gui>Advanced</gui> button located near the bottom
+ of the Magnifier page, you can further customize <app>Orca</app>'s
+ magnification support, including:
+ </p>
+ <list>
+ <item><p><gui>Smoothing</gui>: Bilinear or none.</p></item>
+ <item>
+ <p>
+ <gui>Brightness</gui>: Choosing different brightness levels
+ for red, blue, and green allows you to create the color scheme
+ that works best for you.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Contrast</gui>: While not as significant as changes to
+ brightness, choosing different contrast levels for red, blue,
+ and green helps you to create the color scheme that works best
+ for you.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Color Filtering</gui>: Allows you to pick one of the
+ colorblind filters available through libcolorblind. In order
+ to take advantage of this feature you will need to install
+ libcolorblind and then rebuild gnome-mag.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Multi-Monitor Settings - Source Display</gui>: X Window
+ System DISPLAY of what should be magnified. Written in the form
+ ":0.x" where x is the number of the screen whose contents should
+ be magnified.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Multi-Monitor Settings - Target Display</gui>: X Window
+ System DISPLAY of where to put the zoomer window. Written in
+ the form ":0.y" where y is the number of the screen where the
+ zoomer window should appear.
+ </p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/C/preferences_pronunciation.page b/help/C/preferences_pronunciation.page
new file mode 100644
index 0000000..33de62d
--- /dev/null
+++ b/help/C/preferences_pronunciation.page
@@ -0,0 +1,101 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+ id="preferences_pronunciation">
+ <info>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_text_attributes" />
+ <title type="sort">7. Pronunciation</title>
+ <title type="link">Pronunciation</title>
+ <desc>
+ defining how specific words get pronounced
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Pronunciation Preferences</title>
+ <p id="introduction">
+ Sometimes your speech synthesizer just doesn't say the right thing
+ for a given string. You might prefer to hear "laughing out loud"
+ rather than "LOL." Or there may be a name or a technical term which
+ the synthesizer mispronounces. The pronunciation page is where you
+ can add, edit, and delete <app>Orca</app>'s pronunciation dictionary
+ entries. Because the pronunciation page is also part of the
+ application-specific settings, you can customize your entries on an
+ as-needed basis for each application you use.
+ </p>
+ <section id="add">
+ <title>Add a new dictionary entry</title>
+ <p>
+ To add a new entry into <app>Orca</app>'s pronunciation dictionary:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Press the New Entry button (<keyseq><key>Alt</key><key>N</key>
+ </keyseq>)
+ </p>
+ </item>
+ <item>
+ <p>
+ Type the text of the new entry and press <key>Return</key>
+ to finish editing the actual string.
+ </p>
+ </item>
+ <item>
+ <p>
+ Move to the <gui>Replacement String</gui> column and press
+ <key>Return</key> to begin editing.
+ </p>
+ </item>
+ <item>
+ <p>
+ Type the text that you would like to have spoken instead
+ and press <key>Return</key> to finish editing the replacement
+ string.
+ </p>
+ </item>
+ </steps>
+ </section>
+ <section id="edit">
+ <title>Edit an existing dictionary entry</title>
+ <p>
+ To edit an existing entry in <app>Orca</app>'s pronunciation
+ dictionary:
+ </p>
+ <steps>
+ <item>
+ <p>
+ Move to the cell you wish to edit and press <key>Return</key>
+ to begin editing.
+ </p>
+ </item>
+ <item>
+ <p>
+ Make your changes and then press <key>Return</key> to finish
+ editing.
+ </p>
+ </item>
+ </steps>
+ </section>
+ <section id="delete">
+ <title>Delete an existing dictionary entry</title>
+ <p>
+ To delete an entry from <app>Orca</app>'s pronunciation
+ dictionary:
+ </p>
+ <steps>
+ <item>
+ <p>Move to the entry you wish to delete.</p>
+ </item>
+ <item>
+ <p>
+ Press the Delete button or <keyseq><key>Alt</key><key>D</key></keyseq>.
+ </p>
+ </item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/preferences_speech.page b/help/C/preferences_speech.page
new file mode 100644
index 0000000..bb3956f
--- /dev/null
+++ b/help/C/preferences_speech.page
@@ -0,0 +1,335 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic" id="preferences_speech">
+ <info>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_braille" />
+ <title type="sort">2. Speech</title>
+ <title type="link">Speech</title>
+ <desc>
+ configuring the voice and what gets spoken
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Speech Preferences</title>
+ <section id="enable_speech">
+ <info>
+ <desc>
+ Preferences dialog box option to enable and disable <app>Orca</app>'s
+ speech output.
+ </desc>
+ </info>
+ <title>Enable speech</title>
+ <p>
+ The <gui>Enable speech</gui> check box controls whether or not
+ <app>Orca</app> will make use of a speech synthesizer.
+ Magnification-only and Braille-only users will likely want to
+ uncheck this checkbox.
+ </p>
+ </section>
+ <section id="tts_options">
+ <info>
+ <desc>
+ Preferences dialog box options to configure the text-to-speech
+ settings to be used by <app>Orca</app>.
+ </desc>
+ </info>
+ <title>Text-To-Speech Options</title>
+ <list>
+ <item>
+ <p>
+ The <gui>Speech system</gui> combo box allows you to select your
+ preferred speech system from those you have installed. Examples
+ include Speech Dispatcher and GNOME Speech.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Speech synthesizer</gui> combo box allows you to select
+ the speech synthesizer to be used with your chosen Speech system.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Voice settings</gui> combo box makes it possible for
+ you to use different voices so that you can better distinguish
+ uppercase and linked text from other text, and on-screen text
+ from text added by <app>Orca</app>.
+ </p>
+ <note style="tip">
+ <title>Configuring Multiple Voices</title>
+ <p>
+ For each voice you wish to configure, first select the
+ voice in the <gui>Voice settings</gui> combo box. Then
+ configure the person, rate, pitch, and volume to be used
+ for that voice.
+ </p>
+ </note>
+ </item>
+ <item>
+ <p>
+ The <gui>Person</gui> combo box allows you to choose which
+ "person" or "speaker" should be used with the selected voice.
+ For instance, you might wish to have David speak by default,
+ but have hyperlinks spoken by Alice. Note that what you find
+ in the <gui>Person</gui> combo box will depend on which speech
+ synthesizers you have installed.
+ </p>
+ </item>
+ <item>
+ <p>
+ The <gui>Rate</gui>, <gui>Pitch</gui>, and <gui>Volume</gui>
+ left-right sliders allow you to further customize the sound
+ of the person you have just selected.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="punctuation_level">
+ <info>
+ <desc>
+ Preferences dialog box option to set the level of verbalized
+ punctuation.
+ </desc>
+ </info>
+ <title>Punctuation Level</title>
+ <p>
+ The <gui>Punctuation Level</gui> radio button group is used to
+ adjust the amount of punctuation spoken by the synthesizer. The
+ available levels are None, Some, Most and All.
+ </p>
+ </section>
+ <section id="verbosity">
+ <info>
+ <desc>
+ Preferences dialog box option to control the amount of information
+ which will be spoken in various situations.
+ </desc>
+ </info>
+ <title>Verbosity</title>
+ <p>
+ The <gui>Verbosity</gui> setting determines the amount of information
+ that will be spoken in various situations. For example, if it is set
+ to verbose, <app>Orca</app> will speak shortcut keys for items in
+ menus. When it is set to brief, these shortcut keys are not announced.
+ </p>
+ </section>
+ <section id="table_rows">
+ <info>
+ <desc>
+ Preferences dialog box option to configure what gets spoken when
+ navigating amongst rows in a table.
+ </desc>
+ </info>
+ <title>Table Rows</title>
+ <p>
+ The <gui>Table Rows</gui> radio button group determines what gets
+ spoken when navigating amongst rows in a table. The available
+ options are <gui>speak row</gui> and <gui>speak cell</gui>.
+ </p>
+ <p>
+ Consider the process of examinging the list of messages in your Inbox.
+ In order to have <app>Orca</app> announce the sender, subject, date,
+ and presence of attachments you would need <gui>speak row</gui>. On
+ the other hand, when navigating amongst rows in a spreadsheet, hearing
+ the full row may not be desired. In that case, <gui>speak cell</gui>
+ should instead be chosen.
+ </p>
+ </section>
+ <section id="progress_bar_updates">
+ <info>
+ <desc>
+ Preferences dialog box options to control which progress bar updates
+ get spoken.
+ </desc>
+ </info>
+ <title>Progress Bar Updates</title>
+ <p>
+ If the <gui>Enabled</gui> checkbox is checked <app>Orca</app> will
+ periodically announce the status of progress bars. How often the
+ announcement is made is determined by the value chosen in the
+ <gui>Frequency (secs)</gui> spin button.
+ </p>
+ <p>
+ The <gui>Restrict to</gui> combo box allows you to control which
+ progress bars should be spoken, assuming the speaking of progress
+ bar updates has been enabled. The choices are <gui>All</gui>,
+ <gui>Application</gui>, and <gui>Window</gui>. Choosing <gui>All</gui>
+ will result in <app>Orca</app> speaking updates for all progress bars,
+ regardless of where the progress bars are located. Choosing
+ <gui>Application</gui> will result in <app>Orca</app> speaking updates
+ from progress bars in the active application, even if they are not in
+ the active window. Choosing <gui>Window</gui> will result in
+ <app>Orca</app> only speaking updates for progress bars in the active
+ window. The default value is <gui>Application</gui>.
+ </p>
+ </section>
+ <section id="only_speak_displayed_text">
+ <info>
+ <desc>
+ Preferences dialog box option to cause <app>Orca</app> to only
+ speak actual text displayed on screen. This option is intended
+ primarily for low vision users and users with a visual learning
+ disability.
+ </desc>
+ </info>
+ <title>Only speak displayed text</title>
+ <p>
+ Checking this checkbox causes <app>Orca</app> to only speak actual
+ text displayed on screen. This option is intended primarily for low
+ vision users and users with a visual learning disability.
+ </p>
+ </section>
+ <section id="multicase_strings">
+ <info>
+ <desc>
+ Preferences dialog box option to cause <app>Orca</app> to present
+ multicase strings as if they were separate words.
+ </desc>
+ </info>
+ <title>Speak multicase strings as words</title>
+ <p>
+ In some texts, and especially when working with code, one often comes
+ across a "word" consisting of several words with alternating case, such
+ as "MultiCaseString." Speech synthesizers do not always pronounce such
+ multicase strings correctly. Checking the <gui>Speak multicase strings
+ as words</gui> checkbox will cause <app>Orca</app> to break a word like
+ "MultiCaseString" into separate words ("Multi," "Case," and "String")
+ prior to passing it along to the speech synthesizer.
+ </p>
+ </section>
+ <section id="pauses">
+ <info>
+ <desc>
+ Preferences dialog box option to cause <app>Orca</app> to add pauses
+ to the items being spoken.
+ </desc>
+ </info>
+ <title>Break speech into chunks between pauses</title>
+ <p>
+ Depending on the enabled speech settings, <app>Orca</app> may have quite
+ a bit to say about a particular object such as its name, its role, its
+ state, its mnemonic, its tutorial message, and so on. Checking the
+ <gui>Break speech into chunks between pauses</gui> checkbox will cause
+ <app>Orca</app> to insert brief pauses in between each of these pieces
+ of information.
+ </p>
+ </section>
+ <section id="say_all_by">
+ <info>
+ <desc>
+ Preferences dialog box option controlling <app>Orca</app>'s Say All
+ style. The options are by sentence and by line.
+ </desc>
+ </info>
+ <title>Say All By</title>
+ <p>
+ The <gui>Say All By</gui> combo box allows you to specify whether
+ <app>Orca</app> speaks a sentence at a time or a line at a time when
+ doing a "Say All" of a document.
+ </p>
+ </section>
+ <section id="system_voice_items">
+ <title>System Information</title>
+ <info>
+ <desc>
+ Preferences dialog box options for controlling the presentation
+ of a variety of supplemental, "system" information about the item
+ with focus.
+ </desc>
+ </info>
+ <p>
+ The following items control the presentation of a variety of
+ supplemental, "system" information about the item with focus.
+ Because the associated text does not appear on screen, this
+ information is presented in <app>Orca</app>'s System voice.
+ </p>
+ <note style="note">
+ <title>Configuration of System Information</title>
+ <p>
+ The follow items will not be available for configuration if
+ the <gui>Only speak displayed text</gui> checkbox is checked.
+ </p>
+ </note>
+ <section id="speak_blank_lines">
+ <info>
+ <desc>
+ Preferences dialog box option for controlling whether or not
+ blank lines are announced by <app>Orca</app>.
+ </desc>
+ </info>
+ <title>Speak blank lines</title>
+ <p>
+ If the <gui>Speak blank lines</gui> checkbox is checked,
+ <app>Orca</app> will say "blank" each time you arrow to a blank
+ line. If it is unchecked, <app>Orca</app> will say nothing when
+ you move to a blank line.
+ </p>
+ </section>
+ <section id="indentation_and_justification">
+ <info>
+ <desc>
+ Preferences dialog box option for enabling/disabling the speaking
+ of indentation and justification whilst navigating within text.
+ </desc>
+ </info>
+ <title>Speak indentation and justification</title>
+ <p>
+ When working with code or editing other documents it is often
+ desirable to be aware of justification and indentation. Checking
+ the <gui>Speak indentation and justification</gui> checkbox will
+ cause <app>Orca</app> to announce this information.
+ </p>
+ </section>
+ <section id="mnemonics">
+ <info>
+ <desc>
+ Preferences dialog box option for enabling/disabling the speaking
+ of mnemonics and keyboard shortcuts associated with the focused
+ item.
+ </desc>
+ </info>
+ <title>Speak object mnemonics</title>
+ <p>
+ If the <gui>Speak object mnemonics</gui> checkbox is checked,
+ <app>Orca</app> will announce the mnemonic associated with the
+ object with focus (such as <keyseq><key>Alt</key><key>O</key>
+ </keyseq> for an <gui>OK</gui> button).
+ </p>
+ </section>
+ <section id="child_position">
+ <info>
+ <desc>
+ Preferences dialog box option for enabling/disabling the speaking
+ of the position of the current item in a menu, list, or tree.
+ </desc>
+ </info>
+ <title>Speak child position</title>
+ <p>
+ Checking the <gui>Speak child position</gui> checkbox will cause
+ <app>Orca</app> to announce the position of the focused item in
+ menus, lists, and trees (e.g. "9 of 16").
+ </p>
+ </section>
+ <section id="speak_tutorial_messages">
+ <info>
+ <desc>
+ Preferences dialog box option for controlling whether or not
+ <app>Orca</app> provides tutorial information, such as how to
+ interact with the currently-focused object.
+ </desc>
+ </info>
+ <title>Speak tutorial messages</title>
+ <p>
+ If the <gui>Speak tutorial messages</gui> checkbox is checked, as
+ you move amongst objects in an interface, <app>Orca</app> will
+ provide additional information, such as how to interact with the
+ currently-focused object.
+ </p>
+ </section>
+ </section>
+</page>
diff --git a/help/C/preferences_structural_navigation.page b/help/C/preferences_structural_navigation.page
new file mode 100644
index 0000000..f4c84b9
--- /dev/null
+++ b/help/C/preferences_structural_navigation.page
@@ -0,0 +1,65 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+ id="preferences_structural_navigation">
+ <info>
+ <link type="guide" xref="preferences#application" />
+ <link type="next" xref="preferences_chat" />
+ <link type="seealso" xref="commands_structural_navigation" />
+ <link type="seealso" xref="commands_table" />
+ <title type="sort">2. Structural Navigation</title>
+ <title type="link">Structural Navigation</title>
+ <desc>
+ configuring <app>Orca</app>'s navigation by element
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Structural Navigation Preferences</title>
+ <p>
+ The following option allows you to customize how <app>Orca</app>
+ behaves in Structural-Navigation-enabled applications.
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Use <app>Orca</app> Structural Navigation</gui>: This checkbox
+ toggles structural navigation on and off. To toggle this setting on
+ the fly without saving it, use <keyseq><key>Orca Modifier</key>
+ <key>Z</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Speak cell coordinates</gui>: If this checkbox is checked,
+ <app>Orca</app> will announce the coordinates of each cell you
+ navigate to.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Speak multiple cell spans</gui>: If this checkbox is checked,
+ <app>Orca</app> will announce how many rows and/or columns a cell
+ spans when it spans more than one.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Announce cell header</gui>: If this checkbox is checked,
+ <app>Orca</app> will announce changes in the header if the
+ headers for the current cell can be determined.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Skip blank cells</gui>: If this checkbox is checked,
+ <app>Orca</app> will skip blank cells when you are using
+ <app>Orca</app>'s table structural navigation commands to
+ access the table.
+ </p>
+ </item>
+ </list>
+</page>
diff --git a/help/C/preferences_text_attributes.page b/help/C/preferences_text_attributes.page
new file mode 100644
index 0000000..ea9a671
--- /dev/null
+++ b/help/C/preferences_text_attributes.page
@@ -0,0 +1,131 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+ id="preferences_text_attributes">
+ <info>
+ <link type="guide" xref="preferences#orca" />
+ <link type="next" xref="preferences_gecko" />
+ <link type="seealso" xref="howto_text_attributes" />
+ <title type="sort">8. Text Attributes</title>
+ <title type="link">Text Attributes</title>
+ <desc>
+ configuring what formatting is presented
+ </desc>
+ <credit type="author">
+ <name>Joanmarie Diggs</name>
+ <email>joanied gnome org</email>
+ </credit>
+ <license>
+ <p>Creative Commons Share Alike 3.0</p>
+ </license>
+ </info>
+ <title>Text Attributes Preferences</title>
+ <section id="table">
+ <title>The text attributes table</title>
+ <p>
+ The text attributes table is where you specify what attributes will
+ and will not be presented and under what conditions. Each row consists
+ of four columns:
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Attribute Name</gui>: The name of the text attribute.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Speak</gui>: Check this checkbox if you would like
+ <app>Orca</app> to speak this attribute when you press
+ <keyseq><key>Orca</key><key>F</key></keyseq>.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Mark in braille</gui>: Check this checkbox if you would
+ like <app>Orca</app> to "underline" this attribute on your
+ braille display.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Present Unless</gui>: This editable field allows you to
+ specify when an enabled attribute is not of interest.
+ </p>
+ <p>
+ For example, by default the "underline" text attribute has a
+ value of "none." This causes <app>Orca</app> to inform you
+ about underlined text as long as the text is actually underlined.
+ If you always want this attribute to be spoken irrespective of
+ whether or not the text is underlined, then the attribute should
+ be checked and the <gui>Present unless</gui> value cleared.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="reset">
+ <title>Undoing changes</title>
+ <p>
+ Beneath the list of text attributes, there is a Reset button
+ (<keyseq><key>Alt</key><key>R</key></keyseq>) which will restore
+ the values of the table to what they were when the dialog was
+ first displayed.
+ </p>
+ </section>
+ <section id="rearranging">
+ <title>Rearranging the order of presentation</title>
+ <p>
+ When you initially display the text attribute page, all your
+ checked attributes are put at the top of the list. They are given
+ in the order that they will be spoken. There are four buttons which
+ can be used to rearrange the order of presentation:
+ </p>
+ <list>
+ <item>
+ <p>
+ <gui>Move to top</gui> (<keyseq><key>Alt</key><key>T</key></keyseq>):
+ moves the selected attribute to the top of the list.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Move up one</gui> (<keyseq><key>Alt</key><key>U</key></keyseq>):
+ moves the selected attribute up one row.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Move down one</gui> (<keyseq><key>Alt</key><key>D</key></keyseq>):
+ moves the selected attribute down one row.
+ </p>
+ </item>
+ <item>
+ <p>
+ <gui>Move to bottom</gui> (<keyseq><key>Alt</key><key>B</key></keyseq>):
+ moves the selected attribute to the bottom of the list.
+ </p>
+ </item>
+ </list>
+ </section>
+ <section id="braille_indicator">
+ <title>Braille indicator</title>
+ <p>
+ Beneath the push buttons is the <gui>Braille Indicator</gui> group
+ of radio buttons. Here you can select the cell or cells to be used
+ to indicate text which has at least one of the specified attributes.
+ Your choices are:
+ </p>
+ <list>
+ <item>
+ <p><gui>None</gui> (the default)</p>
+ </item>
+ <item>
+ <p><gui>Dot 7</gui></p>
+ </item>
+ <item>
+ <p><gui>Dot 8</gui></p>
+ </item>
+ <item>
+ <p><gui>Dots 7 and 8</gui></p>
+ </item>
+ </list>
+ </section>
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
new file mode 100644
index 0000000..b001671
--- /dev/null
+++ b/help/Makefile.am
@@ -0,0 +1,58 @@
+DOC_ID = orca
+DOC_FIGURES = \
+ figures/orca-logo.png
+
+DOC_PAGES = \
+ commands_bookmarks.page \
+ commands_braille.page \
+ commands_chat.page \
+ commands_controlling_orca.page \
+ commands_debugging.page \
+ commands_find.page \
+ commands_flat_review.page \
+ commands_live_regions.page \
+ commands_magnifier.page \
+ commands_mouse.page \
+ commands.page \
+ commands_reading.page \
+ commands_speech_settings.page \
+ commands_structural_navigation.page \
+ commands_table.page \
+ commands_time_date_notifications.page \
+ commands_where_am_i.page \
+ howto_bookmarks.page \
+ howto_documents.page \
+ howto_flat_review.page \
+ howto_key_bindings.page \
+ howto_keyboard_layout.page \
+ howto_learn_modes.page \
+ howto_mouse_review.page \
+ howto_notifications.page \
+ howto_orca_find.page \
+ howto_profiles.page \
+ howto_reading_web.page \
+ howto_setting_up_orca.page \
+ howto_tables.page \
+ howto_text_attributes.page \
+ howto_text_setup.page \
+ howto_the_orca_modifier.page \
+ howto_toggling_caps_lock.page \
+ howto_web_forms.page \
+ howto_whereami.page \
+ index.page \
+ introduction.page \
+ preferences_braille.page \
+ preferences_chat.page \
+ preferences_gekco.page \
+ preferences_general.page \
+ preferences_key_bindings.page \
+ preferences_key_echo.page \
+ preferences_magnifier.page \
+ preferences.page \
+ preferences_pronunciation.page \
+ preferences_speech.page \
+ preferences_structural_navigation.page \
+ preferences_text_attributes.page
+
+DOC_LINGUAS =
+dist-hook: doc-dist-hook
\ No newline at end of file
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
