[orca] Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augment
- From: Joanmarie Diggs <joanied src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [orca] Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augment
- Date: Sat, 18 Dec 2010 23:12:48 +0000 (UTC)
commit dab2b17e3f173d8f4cb5e049b13bfc33a89598c0
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date: Sat Dec 18 14:27:59 2010 -0500
Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augmented, and moved to the Orca module
* Adding figures/screenshots (mostly done; more to follow)
* Adding default preference values for all items (and doing so
in a consistent format/form)
* Converting some lists to headings to make reading help via
structural navigation more consistent between Preferences
and the Main guide page.
help/C/figures/main_window.png | Bin 0 -> 10305 bytes
help/C/figures/orca_find.png | Bin 0 -> 17451 bytes
help/C/figures/perferences_table_navigation.png | Bin 0 -> 7806 bytes
help/C/figures/preferences_Orca_modifier_keys.png | Bin 0 -> 4464 bytes
help/C/figures/preferences_character_echo.png | Bin 0 -> 2081 bytes
help/C/figures/preferences_chat.png | Bin 0 -> 13234 bytes
help/C/figures/preferences_date_and_time.png | Bin 0 -> 4786 bytes
.../preferences_disable_gksu_keyboard_grab.png | Bin 0 -> 2504 bytes
help/C/figures/preferences_gecko_find_options.png | Bin 0 -> 9108 bytes
.../figures/preferences_gecko_page_navigation.png | Bin 0 -> 10791 bytes
help/C/figures/preferences_key_bindings_table.png | Bin 0 -> 36239 bytes
help/C/figures/preferences_key_echo.png | Bin 0 -> 8736 bytes
help/C/figures/preferences_keyboard_layout.png | Bin 0 -> 4073 bytes
help/C/figures/preferences_magnifier_advanced.png | Bin 0 -> 26397 bytes
help/C/figures/preferences_present_tooltips.png | Bin 0 -> 1605 bytes
help/C/figures/preferences_profiles.png | Bin 0 -> 9429 bytes
help/C/figures/preferences_pronunciation.png | Bin 0 -> 15067 bytes
.../preferences_quit_Orca_without_confirmation.png | Bin 0 -> 2515 bytes
.../figures/preferences_show_Orca_main_window.png | Bin 0 -> 2432 bytes
.../preferences_speak_object_under_mouse.png | Bin 0 -> 2674 bytes
.../preferences_start_Orca_when_you_login.png | Bin 0 -> 2758 bytes
help/C/figures/preferences_table_navigation.png | Bin 0 -> 7786 bytes
.../preferences_text_attributes_braille.png | Bin 0 -> 4999 bytes
.../preferences_text_attributes_rearranging.png | Bin 0 -> 6323 bytes
.../figures/preferences_text_attributes_table.png | Bin 0 -> 25538 bytes
.../figures/preferences_word_and_sentence_echo.png | Bin 0 -> 3039 bytes
help/C/figures/profiles_conflict.png | Bin 0 -> 17946 bytes
help/C/figures/profiles_load.png | Bin 0 -> 20041 bytes
help/C/figures/profiles_save_as.png | Bin 0 -> 11527 bytes
help/C/howto_orca_find.page | 64 +++++--
help/C/howto_profiles.page | 23 ++-
help/C/howto_structural_navigation.page | 7 +-
help/C/howto_tables.page | 2 +-
help/C/preferences_chat.page | 101 ++++++-----
help/C/preferences_gekco.page | 152 +++++++++++-----
help/C/preferences_general.page | 95 +++++++---
help/C/preferences_key_bindings.page | 7 +-
help/C/preferences_key_echo.page | 192 ++++++++++++--------
help/C/preferences_magnifier.page | 10 +-
help/C/preferences_pronunciation.page | 18 ++-
help/C/preferences_structural_navigation.page | 65 -------
help/C/preferences_table_navigation.page | 70 +++++++
help/C/preferences_text_attributes.page | 73 +++++---
43 files changed, 554 insertions(+), 325 deletions(-)
---
diff --git a/help/C/figures/main_window.png b/help/C/figures/main_window.png
new file mode 100644
index 0000000..819f957
Binary files /dev/null and b/help/C/figures/main_window.png differ
diff --git a/help/C/figures/orca_find.png b/help/C/figures/orca_find.png
new file mode 100644
index 0000000..a091068
Binary files /dev/null and b/help/C/figures/orca_find.png differ
diff --git a/help/C/figures/perferences_table_navigation.png b/help/C/figures/perferences_table_navigation.png
new file mode 100644
index 0000000..d44c404
Binary files /dev/null and b/help/C/figures/perferences_table_navigation.png differ
diff --git a/help/C/figures/preferences_Orca_modifier_keys.png b/help/C/figures/preferences_Orca_modifier_keys.png
new file mode 100644
index 0000000..29d1a8e
Binary files /dev/null and b/help/C/figures/preferences_Orca_modifier_keys.png differ
diff --git a/help/C/figures/preferences_character_echo.png b/help/C/figures/preferences_character_echo.png
new file mode 100644
index 0000000..d78cabf
Binary files /dev/null and b/help/C/figures/preferences_character_echo.png differ
diff --git a/help/C/figures/preferences_chat.png b/help/C/figures/preferences_chat.png
new file mode 100644
index 0000000..06a30ca
Binary files /dev/null and b/help/C/figures/preferences_chat.png differ
diff --git a/help/C/figures/preferences_date_and_time.png b/help/C/figures/preferences_date_and_time.png
new file mode 100644
index 0000000..e5a0313
Binary files /dev/null and b/help/C/figures/preferences_date_and_time.png differ
diff --git a/help/C/figures/preferences_disable_gksu_keyboard_grab.png b/help/C/figures/preferences_disable_gksu_keyboard_grab.png
new file mode 100644
index 0000000..1fed88e
Binary files /dev/null and b/help/C/figures/preferences_disable_gksu_keyboard_grab.png differ
diff --git a/help/C/figures/preferences_gecko_find_options.png b/help/C/figures/preferences_gecko_find_options.png
new file mode 100644
index 0000000..e39a6e3
Binary files /dev/null and b/help/C/figures/preferences_gecko_find_options.png differ
diff --git a/help/C/figures/preferences_gecko_page_navigation.png b/help/C/figures/preferences_gecko_page_navigation.png
new file mode 100644
index 0000000..d0372d9
Binary files /dev/null and b/help/C/figures/preferences_gecko_page_navigation.png differ
diff --git a/help/C/figures/preferences_key_bindings_table.png b/help/C/figures/preferences_key_bindings_table.png
new file mode 100644
index 0000000..8926bd0
Binary files /dev/null and b/help/C/figures/preferences_key_bindings_table.png differ
diff --git a/help/C/figures/preferences_key_echo.png b/help/C/figures/preferences_key_echo.png
new file mode 100644
index 0000000..f89497e
Binary files /dev/null and b/help/C/figures/preferences_key_echo.png differ
diff --git a/help/C/figures/preferences_keyboard_layout.png b/help/C/figures/preferences_keyboard_layout.png
new file mode 100644
index 0000000..30415c2
Binary files /dev/null and b/help/C/figures/preferences_keyboard_layout.png differ
diff --git a/help/C/figures/preferences_magnifier_advanced.png b/help/C/figures/preferences_magnifier_advanced.png
new file mode 100644
index 0000000..fe2c341
Binary files /dev/null and b/help/C/figures/preferences_magnifier_advanced.png differ
diff --git a/help/C/figures/preferences_present_tooltips.png b/help/C/figures/preferences_present_tooltips.png
new file mode 100644
index 0000000..5d0e981
Binary files /dev/null and b/help/C/figures/preferences_present_tooltips.png differ
diff --git a/help/C/figures/preferences_profiles.png b/help/C/figures/preferences_profiles.png
new file mode 100644
index 0000000..edd2c04
Binary files /dev/null and b/help/C/figures/preferences_profiles.png differ
diff --git a/help/C/figures/preferences_pronunciation.png b/help/C/figures/preferences_pronunciation.png
new file mode 100644
index 0000000..9a19623
Binary files /dev/null and b/help/C/figures/preferences_pronunciation.png differ
diff --git a/help/C/figures/preferences_quit_Orca_without_confirmation.png b/help/C/figures/preferences_quit_Orca_without_confirmation.png
new file mode 100644
index 0000000..03b9c3d
Binary files /dev/null and b/help/C/figures/preferences_quit_Orca_without_confirmation.png differ
diff --git a/help/C/figures/preferences_show_Orca_main_window.png b/help/C/figures/preferences_show_Orca_main_window.png
new file mode 100644
index 0000000..8e3fe04
Binary files /dev/null and b/help/C/figures/preferences_show_Orca_main_window.png differ
diff --git a/help/C/figures/preferences_speak_object_under_mouse.png b/help/C/figures/preferences_speak_object_under_mouse.png
new file mode 100644
index 0000000..069939d
Binary files /dev/null and b/help/C/figures/preferences_speak_object_under_mouse.png differ
diff --git a/help/C/figures/preferences_start_Orca_when_you_login.png b/help/C/figures/preferences_start_Orca_when_you_login.png
new file mode 100644
index 0000000..2b211a0
Binary files /dev/null and b/help/C/figures/preferences_start_Orca_when_you_login.png differ
diff --git a/help/C/figures/preferences_table_navigation.png b/help/C/figures/preferences_table_navigation.png
new file mode 100644
index 0000000..e311706
Binary files /dev/null and b/help/C/figures/preferences_table_navigation.png differ
diff --git a/help/C/figures/preferences_text_attributes_braille.png b/help/C/figures/preferences_text_attributes_braille.png
new file mode 100644
index 0000000..e148092
Binary files /dev/null and b/help/C/figures/preferences_text_attributes_braille.png differ
diff --git a/help/C/figures/preferences_text_attributes_rearranging.png b/help/C/figures/preferences_text_attributes_rearranging.png
new file mode 100644
index 0000000..ed46d53
Binary files /dev/null and b/help/C/figures/preferences_text_attributes_rearranging.png differ
diff --git a/help/C/figures/preferences_text_attributes_table.png b/help/C/figures/preferences_text_attributes_table.png
new file mode 100644
index 0000000..27a897f
Binary files /dev/null and b/help/C/figures/preferences_text_attributes_table.png differ
diff --git a/help/C/figures/preferences_word_and_sentence_echo.png b/help/C/figures/preferences_word_and_sentence_echo.png
new file mode 100644
index 0000000..e08ffc3
Binary files /dev/null and b/help/C/figures/preferences_word_and_sentence_echo.png differ
diff --git a/help/C/figures/profiles_conflict.png b/help/C/figures/profiles_conflict.png
new file mode 100644
index 0000000..e810e04
Binary files /dev/null and b/help/C/figures/profiles_conflict.png differ
diff --git a/help/C/figures/profiles_load.png b/help/C/figures/profiles_load.png
new file mode 100644
index 0000000..bcabe2f
Binary files /dev/null and b/help/C/figures/profiles_load.png differ
diff --git a/help/C/figures/profiles_save_as.png b/help/C/figures/profiles_save_as.png
new file mode 100644
index 0000000..f1d2b61
Binary files /dev/null and b/help/C/figures/profiles_save_as.png differ
diff --git a/help/C/howto_orca_find.page b/help/C/howto_orca_find.page
index b0eee93..1df41da 100644
--- a/help/C/howto_orca_find.page
+++ b/help/C/howto_orca_find.page
@@ -41,44 +41,68 @@
</p>
</note>
<p>
- When you activate Orca Find, you will be placed in a dialog box where you
- can specify the following items:
+ When you activate Orca Find, you will be placed in a dialog box.
+ </p>
+ <figure>
+ <title>
+ <app>Orca</app>'s Find Dialog
+ </title>
+ <media type="image" mime="image/png" src="figures/orca_find.png"/>
+ </figure>
+ <p>
+ Here you can specify the following items:
</p>
<list>
<item>
<p>The text to find</p>
</item>
<item>
- <p>The location to start from, which can be:</p>
- <list>
- <item>
- <p><gui>Current location</gui></p>
- </item>
- <item>
- <p><gui>Top of window</gui></p>
- </item>
- </list>
+ <p>
+ The location from which to begin the search, which can either be
+ the current location or the top of the window
+ </p>
+ <p>
+ Default value of <gui>Start from</gui>: <gui>Current location</gui>
+ </p>
</item>
<item>
- <p><gui>Match case</gui></p>
+ <p>
+ Whether or not capitalization should be taken into account when seeking
+ a match
+ </p>
+ <p>
+ Default value of <gui>Match case</gui>: not checked
+ </p>
</item>
<item>
- <p><gui>Match entire word only</gui></p>
+ <p>
+ Whether or not to limit matches to those which match the entire word
+ or phrase
+ </p>
+ <p>
+ Default value of <gui>Match entire word only</gui>: not checked
+ </p>
</item>
<item>
- <p><gui>Search backwards</gui></p>
+ <p>
+ Whether Find should look down and/or to the right for the next
+ match or up and/or to the left.
+ </p>
+ <p>
+ Default value of <gui>Search backwards</gui>: not checked
+ </p>
</item>
<item>
<p>
- <gui>Wrap around</gui>, should there be no match from the starting point
+ Whether or not Find should wrap around to the top/bottom of the window
+ if there is no match found from the starting location in the direction
+ of the search.
+ </p>
+ <p>
+ Default value of <gui>Wrap around</gui>: checked
</p>
</item>
</list>
- <p>
- By default, the search will be case-insensitive and permit partial word
- matches. And it will begin from your current location and search forward,
- wrapping if needed.
- </p>
<p>
Having performed a search, you can quickly search for the next or previous
match without having to return to the Orca Find dialog box.
diff --git a/help/C/howto_profiles.page b/help/C/howto_profiles.page
index 7f7be55..85e30a7 100644
--- a/help/C/howto_profiles.page
+++ b/help/C/howto_profiles.page
@@ -17,6 +17,16 @@
Orca's profiles allow you to save and load multiple configurations so
that you can quickly access the settings you need.
</p>
+ <figure>
+ <title>
+ Maintaining Multiple Configurations
+ </title>
+ <desc>
+ These options appear at the bottom of the <gui>General</gui> page of the
+ <app>Orca</app> preferences dialog.
+ </desc>
+ <media type="image" mime="image/png" src="figures/preferences_profiles.png"/>
+ </figure>
<section id="save">
<title>Saving a New Profile</title>
<p>To save a new profile:</p>
@@ -37,8 +47,11 @@
</item>
<item>
<p>
- In the resulting <gui>Save Profile As</gui> dialog box, type the new
- profile name.
+ Type the new profile name in the resulting <gui>Save Profile As</gui>
+ dialog box.
+ </p>
+ <p>
+ <media type="image" mime="image/png" src="figures/profiles_save_as.png"/>
</p>
</item>
<item>
@@ -72,6 +85,9 @@
<p>
You will be asked to confirm. Press the <gui>Yes</gui> button.
</p>
+ <p>
+ <media type="image" mime="image/png" src="figures/profiles_load.png"/>
+ </p>
</item>
<item>
<p>Press the <gui>OK</gui> button.</p>
@@ -97,6 +113,9 @@
profile. When you press the <gui>OK</gui> button, you will told there
is a name conflict.
</p>
+ <p>
+ <media type="image" mime="image/png" src="figures/profiles_conflict.png"/>
+ </p>
</item>
<item>
<p>
diff --git a/help/C/howto_structural_navigation.page b/help/C/howto_structural_navigation.page
index 5cab2da..49b6d90 100644
--- a/help/C/howto_structural_navigation.page
+++ b/help/C/howto_structural_navigation.page
@@ -81,10 +81,9 @@
<section id="settings">
<title>Available Settings</title>
<p>
- In addition to the aforementioned commands, <app>Orca</app> has a number of
- <link xref="preferences_structural_navigation">configurable options</link>
- available specifically for applications in which there is structural
- navigation support. To access these options:
+ In addition to the aforementioned commands, <app>Orca</app> has a number
+ of configurable options available specifically for applications in which
+ there is structural navigation support. To access these options:
</p>
<steps>
<item>
diff --git a/help/C/howto_tables.page b/help/C/howto_tables.page
index 479aa01..65cb1a4 100644
--- a/help/C/howto_tables.page
+++ b/help/C/howto_tables.page
@@ -65,7 +65,7 @@
</p>
<p>
In addition, <app>Orca</app> provides configurable
- <link xref="preferences_structural_navigation">presentation options</link>
+ <link xref="preferences_table_navigation">presentation options</link>
which work in conjunction with Structural Navigation and allow you to
control whether or not cell coordinates are presented, multiple cell spans
are indicated, and cell headers are announced.
diff --git a/help/C/preferences_chat.page b/help/C/preferences_chat.page
index 28e5783..ca404b1 100644
--- a/help/C/preferences_chat.page
+++ b/help/C/preferences_chat.page
@@ -15,54 +15,65 @@
</license>
</info>
<title>Chat Preferences</title>
+ <media type="image" mime="image/png" src="figures/preferences_chat.png"/>
<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>
+ <section>
+ <title>Speak Chat Room name</title>
+ <p>
+ 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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+ <section>
+ <title>Announce when your buddies are typing</title>
+ <p>
+ 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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+ <section>
+ <title>Provide chat room specific message histories</title>
+ <p>
+ 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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+ <section>
+ <title>Speak messages from</title>
+ <p>
+ This 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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
</page>
diff --git a/help/C/preferences_gekco.page b/help/C/preferences_gekco.page
index b8812b6..d5622d2 100644
--- a/help/C/preferences_gekco.page
+++ b/help/C/preferences_gekco.page
@@ -1,13 +1,12 @@
<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" />
+ <link type="next" xref="preferences_table_navigation" />
<title type="sort">1. Gecko Navigation</title>
<title type="link">Gecko Navigation</title>
<desc>
- Configuring <app>Orca</app>'s caret navigation
+ Configuring <app>Orca</app>'s support for <app>Firefox</app> and
+ <app>Thunderbird</app>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
@@ -18,67 +17,120 @@
</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>
+ <section id="page_navigation">
+ <title>Page Navigation</title>
+ <media type="image" mime="image/png" src="figures/preferences_gecko_page_navigation.png"/>
+ <p>
+ The <gui>Page Navigation</gui> group of controls make it possible for you
+ to customize how <app>Orca</app> presents, and allow you to interact with,
+ text and other content.
+ </p>
+ <section>
+ <title>Use Orca Caret Navigation</title>
<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>.
+ This checkbox toggles <app>Orca</app>'s caret navigation on and off.
+ When it is on, <app>Orca</app> takes control of the caret as you arrow
+ around within a page; when it is off, Gecko's native caret navigation is
+ active.
</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.
+ Default value: checked
</p>
- </item>
- <item>
+ <note style="tip">
+ <title>This setting can be toggled on the fly</title>
+ <p>
+ To toggle this setting on the fly without saving it, use
+ <keyseq><key>Orca Modifier</key><key>F12</key></keyseq>.
+ </p>
+ </note>
+ </section>
+ <section>
+ <title>Use Orca Structural Navigation</title>
+ <p>
+ This checkbox toggles <app>Orca</app>'s
+ <link xref="howto_structural_navigation">Structural Navigation</link>
+ on and off. Structural Navigation allows you to navigate by elements
+ such as headings, links, and form fields.
+ </p>
+ <p>
+ Default value: checked
+ </p>
+ <note style="tip">
+ <title>This setting can be toggled on the fly</title>
+ <p>
+ To toggle this setting on the fly without saving it, use
+ <keyseq><key>Orca Modifier</key><key>Z</key></keyseq>.
+ </p>
+ </note>
+ </section>
+ <section>
+ <title>Grab focus on objects when navigating</title>
+ <p>
+ 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 <app>Firefox</app> and
+ <app>Thunderbird</app>.
+ </p>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+ <section>
+ <title>Position cursor at start of line when navigating vertically</title>
<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.
+ Default value: not checked
+ </p>
+ </section>
+ </section>
+ <section id="find_options">
+ <title>Find Options</title>
+ <media type="image" mime="image/png" src="figures/preferences_gecko_find_options.png"/>
+ <p>
+ The <gui>Find Options</gui> group of controls make it possible for you to
+ customize how <app>Orca</app> presents the results of a search conducted
+ using the application's built-in search functionality.
+ </p>
+ <section>
+ <title>Speak results during find</title>
+ <p>
+ If this checkbox is checked, <app>Orca</app> will read the line which
+ matches your current search query.
+ </p>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Only speak changed lines during find</title>
+ <p>
+ 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.
+ </p>
+ <p>
+ Default value: not checked
</p>
- </item>
- <item>
+ </section>
+ <section>
+ <title>Minimum length of matched text</title>
<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.
+ This editable spin button is where you can specify the number of
+ characters which much match before <app>Orca</app> announces the
+ matching line. This option is also designed to prevent "chattiness"
+ as there are many matches when you first begin typing string for
+ which you are searching.
</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.
+ Default value: 4
</p>
- </item>
- </list>
- <p>
- See <link xref="preferences_structural_navigation" /> for additional
- preferences related to Structural Navigation.
- </p>
+ </section>
+ </section>
</page>
diff --git a/help/C/preferences_general.page b/help/C/preferences_general.page
index ce193f9..9b7cbd5 100644
--- a/help/C/preferences_general.page
+++ b/help/C/preferences_general.page
@@ -24,12 +24,16 @@
</desc>
</info>
<title>Keyboard Layout</title>
+ <media type="image" mime="image/png" src="figures/preferences_keyboard_layout.png"/>
<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>
+ The <gui>keyboard layout</gui> radio button group allows 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 <key>Orca
+ Modifier</key> as well as a number of keyboard shortcuts for performing
+ <app>Orca</app> commands.</p>
+ <p>
+ Default value: <gui>Desktop</gui>
+ </p>
</section>
<section id="quitorca">
<info>
@@ -38,12 +42,16 @@
presenting a confirmation dialog.
</desc>
</info>
- <title>Quit <app>Orca</app> Without Confirmation</title>
+ <title>Quit Orca Without Confirmation</title>
+ <media type="image" mime="image/png" src="figures/preferences_quit_Orca_without_confirmation.png"/>
+ <p>
+ Normally, when you quit <app>Orca</app>, a confirmation dialog will
+ appear asking you if you do indeed wish to quit <app>Orca</app>.
+ Unchecking the <gui>Quit Orca without confirmation</gui> checkbox
+ prevents this confirmation window from appearing.
+ </p>
<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.
+ Default value: not checked
</p>
</section>
<section id="disablegksu">
@@ -53,6 +61,7 @@
</desc>
</info>
<title>Disable gksu Keyboard Grab</title>
+ <media type="image" mime="image/png" src="figures/preferences_disable_gksu_keyboard_grab.png"/>
<p>
When running commands from the launch menu, many distributions
use an application known as gksu to authorize the user to run
@@ -65,7 +74,7 @@
normally.
</p>
<p>
- By checking the "Disable gksu keyboard grab" checkbox, you will
+ By checking the <gui>Disable gksu keyboard grab</gui> checkbox, you will
turn off the keyboard grab behavior, allowing <app>Orca</app> to
function normally with system administration applications.
</p>
@@ -79,6 +88,9 @@
for login, and then logout and log back in as root whenever you want to
perform a system administration command.
</p>
+ <p>
+ Default value: not checked
+ </p>
</section>
<section id="presenttooltips">
<info>
@@ -88,6 +100,7 @@
</desc>
</info>
<title>Present Tooltips</title>
+ <media type="image" mime="image/png" src="figures/preferences_present_tooltips.png"/>
<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
@@ -95,6 +108,9 @@
<key>Ctrl</key><key>F1</key></keyseq> when an object has focus, will
always result in tooltips being presented, regardless of this setting.
</p>
+ <p>
+ Default value: not checked
+ </p>
</section>
<section id="showmainwindow">
<info>
@@ -103,16 +119,28 @@
main window.
</desc>
</info>
- <title>Show <app>Orca</app> Main Window</title>
+ <title>Show Orca Main Window</title>
+ <media type="image" mime="image/png" src="figures/preferences_show_Orca_main_window.png"/>
+ <figure>
+ <title>
+ The Orca Main Window
+ </title>
+ <media type="image" mime="image/png" src="figures/main_window.png"/>
+ <desc>
+ <app>Orca</app>'s 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>.
+ </desc>
+ </figure>
<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.
+ the <gui>Show <app>Orca</app> main window</gui> checkbox, you can tell
+ <app>Orca</app> to not show <app>Orca</app>'s main window.
+ </p>
+ <p>
+ Default value: checked
</p>
</section>
<section id="autolaunch">
@@ -122,11 +150,15 @@
start when you log in.
</desc>
</info>
- <title>Start <app>Orca</app> When You Login</title>
+ <title>Start Orca When You Login</title>
+ <media type="image" mime="image/png" src="figures/preferences_start_Orca_when_you_login.png"/>
<p>
When checked, this option will tell the system to automatically launch
<app>Orca</app> when you log in.
</p>
+ <p>
+ Default value: not checked
+ </p>
</section>
<section id="objectundermouse">
<info>
@@ -136,10 +168,15 @@
</desc>
</info>
<title>Speak Object Under Mouse</title>
+ <media type="image" mime="image/png" src="figures/preferences_speak_object_under_mouse.png"/>
<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.
+ it around the screen using <app>Orca</app>'s
+ <link xref="howto_mouse_review">Mouse Review</link> feature.
+ </p>
+ <p>
+ Default value: not checked
</p>
</section>
<section id="timeanddate">
@@ -149,10 +186,15 @@
formats used by <app>Orca</app>.
</desc>
</info>
- <title>Time and Date Formats</title>
+ <title>Time Format and Date Format</title>
+ <media type="image" mime="image/png" src="figures/preferences_date_and_time.png"/>
+ <p>
+ The <gui>Time Format</gui> and <gui>Date Format</gui> combo boxes allow
+ you to specify how <app>Orca</app> will speak and braille the time and the
+ date.
+ </p>
<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.
+ Default value: use the system locale's format for each
</p>
</section>
<section id="profiles">
@@ -162,12 +204,13 @@
</desc>
</info>
<title>Profiles</title>
+ <media type="image" mime="image/png" src="figures/preferences_profiles.png"/>
<p>
- The <gui>Profiles</gui> group of controls make it possible for you
- to maintain and use multiple configurations. Here you will find the
- following:
+ The <gui>Profiles</gui> group of controls, which appear at the bottom
+ of the <gui>General</gui> page, make it possible for you to maintain
+ and use multiple configurations.
</p>
- <list>
+ <list>
<item>
<p>
The <gui>Active Profile</gui> combo box displays the current profile
diff --git a/help/C/preferences_key_bindings.page b/help/C/preferences_key_bindings.page
index c554f0b..389222e 100644
--- a/help/C/preferences_key_bindings.page
+++ b/help/C/preferences_key_bindings.page
@@ -18,12 +18,8 @@
</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>
+ <media type="image" mime="image/png" src="figures/preferences_Orca_modifier_keys.png"/>
<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:
@@ -37,6 +33,7 @@
</section>
<section id="key_bindings_table">
<title>The Key Bindings Table</title>
+ <media type="image" mime="image/png" src="figures/preferences_key_bindings_table.png"/>
<p>
The key bindings table provides a list of <app>Orca</app> operations
and the keys that are bound to them.
diff --git a/help/C/preferences_key_echo.page b/help/C/preferences_key_echo.page
index eca5025..0599054 100644
--- a/help/C/preferences_key_echo.page
+++ b/help/C/preferences_key_echo.page
@@ -18,87 +18,127 @@
<title>Key Echo Preferences</title>
<section id="keyecho">
<title>Enable key echo</title>
+ <media type="image" mime="image/png" src="figures/preferences_key_echo.png"/>
+ <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>
+ <p>
+ Default value: checked
+ </p>
+ <section>
+ <title>Enable alphanumeric and punctuation keys</title>
+ <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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Enable modifier keys</title>
+ <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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Enable locking keys</title>
+ <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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Enable function keys</title>
+ <p>
+ This option controls whether or not <key>F1</key> through <key>F12</key>
+ should be spoken when pressed.
+ </p>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Enable action keys</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:
+ 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>
- <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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Enable navigation keys</title>
+ <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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+ <section>
+ <title>Enable non-spacing diacritical keys</title>
+ <p>
+ This option controls whether or not "dead keys" used to generate
+ accented letters should be spoken when pressed.
+ </p>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
</section>
<section id="characterecho">
<title>Enable echo by character</title>
+ <media type="image" mime="image/png" src="figures/preferences_character_echo.png"/>
<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.
+ you just typed.
+ </p>
+ <p>
+ 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:
+ </p>
+ <list>
+ <item>
+ <p>
+ Key echo causes <app>Orca</app> to announce what you just <em>
+ pressed</em>.
+ </p>
+ </item>
+ <item>
+ <p>
+ Character echo causes <app>Orca</app> to announce what was just
+ <em>inserted</em>.
+ </p>
+ </item>
+ </list>
+ <p>
+ Thus to have accented characters spoken as you type them, you should
+ enable character echo.
+ </p>
+ <p>
+ Default value: not checked
</p>
<note style="tip">
<title>Enabling both key echo and character echo</title>
@@ -113,11 +153,15 @@
</section>
<section id="wordandsentenceecho">
<title>Enable echo by word and Enable echo by sentence</title>
+ <media type="image" mime="image/png" src="figures/preferences_word_and_sentence_echo.png"/>
<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>
+ <p>
+ Default value: not checked
+ </p>
</section>
</page>
diff --git a/help/C/preferences_magnifier.page b/help/C/preferences_magnifier.page
index dda4050..5f0b9b0 100644
--- a/help/C/preferences_magnifier.page
+++ b/help/C/preferences_magnifier.page
@@ -5,7 +5,7 @@
<title type="sort">5. Magnifier</title>
<title type="link">Magnifier</title>
<desc>
- Configuring magnification, colors, and pointer
+ Configuring the zoom window appearance
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
@@ -310,8 +310,14 @@
<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:
+ magnification support.
</p>
+ <figure>
+ <title>
+ The <app>Orca</app> <gui>Advanced Settings</gui> Dialog for Magnification
+ </title>
+ <media type="image" mime="image/png" src="figures/preferences_magnifier_advanced.png"/>
+ </figure>
<list>
<item><p><gui>Smoothing</gui>: Bilinear or none.</p></item>
<item>
diff --git a/help/C/preferences_pronunciation.page b/help/C/preferences_pronunciation.page
index 33de62d..402679a 100644
--- a/help/C/preferences_pronunciation.page
+++ b/help/C/preferences_pronunciation.page
@@ -6,7 +6,7 @@
<title type="sort">7. Pronunciation</title>
<title type="link">Pronunciation</title>
<desc>
- defining how specific words get pronounced
+ Defining how specific words get pronounced
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
@@ -21,9 +21,19 @@
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
+ the synthesizer mispronounces.
+ </p>
+ <figure>
+ <title>Options for Defining How Specific Words Get Pronounced</title>
+ <desc>
+ The <gui>Pronunciation</gui> page of the <app>Orca</app> preferences
+ dialog allows you to add, edit, and delete entries in <app>Orca</app>'s
+ pronunciation dictionary.
+ </desc>
+ <media type="image" mime="image/png" src="figures/preferences_pronunciation.png"/>
+ </figure>
+ <p>
+ Because the <gui>Pronunciation</gui> 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>
diff --git a/help/C/preferences_table_navigation.page b/help/C/preferences_table_navigation.page
new file mode 100644
index 0000000..7b54dd2
--- /dev/null
+++ b/help/C/preferences_table_navigation.page
@@ -0,0 +1,70 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+ id="preferences_table_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. Table Navigation</title>
+ <title type="link">Table Navigation</title>
+ <desc>
+ Configuring <app>Orca</app>'s navigation within tables
+ </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 Preferences</title>
+ <media type="image" mime="image/png" src="figures/preferences_table_navigation.png"/>
+ <p>
+ The following option allows you to customize how <app>Orca</app>
+ behaves when navigating within a table in
+ <link xref="howto_structural_navigation">Structural-Navigation</link>-enabled
+ applications.
+ </p>
+ <section>
+ <title>Speak cell coordinates</title>
+ <p>
+ If this checkbox is checked, <app>Orca</app> will announce the coordinates
+ of each cell you navigate to.
+ </p>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Speak multiple cell spans</title>
+ <p>
+ 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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Announce cell header</title>
+ <p>
+ 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>
+ <p>
+ Default value: checked
+ </p>
+ </section>
+ <section>
+ <title>Skip blank cells</title>
+ <p>
+ 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>
+ <p>
+ Default value: not checked
+ </p>
+ </section>
+</page>
diff --git a/help/C/preferences_text_attributes.page b/help/C/preferences_text_attributes.page
index 906128a..b2f359e 100644
--- a/help/C/preferences_text_attributes.page
+++ b/help/C/preferences_text_attributes.page
@@ -18,13 +18,25 @@
</license>
</info>
<title>Text Attributes Preferences</title>
+ <p>
+ The term "text attributes" refers to all of the font, style, alignment,
+ and other formatting associated with a given character or series of
+ characters. <app>Orca</app>'s <gui>Text Attributes</gui> page 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>
<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>
+ <figure>
+ <title>Options for Configuring the Presentation of Formatting</title>
+ <desc>
+ 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.
+ </desc>
+ <media type="image" mime="image/png" src="figures/preferences_text_attributes_table.png"/>
+ </figure>
<list>
<item>
<p>
@@ -62,22 +74,26 @@
</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.
+ <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>
+ <figure>
+ <title>Options for Controlling the Order in Which Attributes Are Presented</title>
+ <desc>
+ When you initially display the text attribute page, all of your enabled
+ attributes are placed at the top of the table in the order in which they
+ will be spoken. There are four buttons which can be used to rearrange
+ the order of presentation.
+ </desc>
+ <media type="image" mime="image/png" src="figures/preferences_text_attributes_rearranging.png"/>
+ </figure>
<list>
<item>
<p>
@@ -107,24 +123,27 @@
</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>
+ <figure>
+ <title>Options for Configuring Braille "Underlining" for Formatting</title>
+ <desc>
+ 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.
+ </desc>
+ <media type="image" mime="image/png" src="figures/preferences_text_attributes_braille.png"/>
+ </figure>
<list>
<item>
- <p><gui>None</gui> (the default)</p>
+ <p><gui>None</gui>: Do not underline text attributes in braille (the default)</p>
</item>
<item>
- <p><gui>Dot 7</gui></p>
+ <p><gui>Dot 7</gui>: Underline text attributes with only Dot 7</p>
</item>
<item>
- <p><gui>Dot 8</gui></p>
+ <p><gui>Dot 8</gui>: Underline text attributes with only Dot 8</p>
</item>
<item>
- <p><gui>Dots 7 and 8</gui></p>
+ <p><gui>Dots 7 and 8</gui>: Underline text attributes with both Dots 7 and Dots 8</p>
</item>
</list>
</section>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
