[gnome-dictionary/wip/help-pages: 12/18] Update help and fix filenames

[Sindhu S <sindhus src gnome org>]

commit 610510342fdf6804f8a3fc28b7a5bb90d26d9438
Author: Sindhu S <sindhus live in>
Date:   Sat Mar 30 09:57:32 2013 -0400

    Update help and fix filenames
    
    Fix save-definitions.page filename.
    Delete sources-add-local.page.stub
    Add help on prob error page.
    Stub strategies page.
    Update ../Makefile.am

 help/C/dictionary-select.page                      |   50 ++++++++++++++++++++
 help/C/prob-error-while-retrieving-definition.page |    2 +-
 help/C/sources-add-local.page.stub                 |   23 ---------
 help/C/sources-default.page                        |   46 ++++++++++++++++++
 help/C/sources-default.page.stub                   |   22 ---------
 help/C/sources-guide.page                          |   11 ++--
 help/C/sources-select.page                         |   40 ++++++++++++++++
 help/C/sources-select.page.stub                    |   24 ---------
 help/C/{strategies.page => strategies.page.stub}   |    0
 help/Makefile.am                                   |    3 +
 10 files changed, 145 insertions(+), 76 deletions(-)
---
diff --git a/help/C/dictionary-select.page b/help/C/dictionary-select.page
new file mode 100644
index 0000000..1ff4e3e
--- /dev/null
+++ b/help/C/dictionary-select.page
@@ -0,0 +1,50 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="task"
+      id="dictionary-select">
+
+  <info>
+    <revision version="0.1" date="2013-03-30" status="review"/>
+    <link type="guide" xref="index#features"/>
+    <link type="seealso" xref="sources-default"/>
+    <!--link type="guide" xref=""/-->
+
+    <credit type="author copyright">
+      <name>Sindhu S</name>
+      <email>sindhus live in</email>
+      <years>2013</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  </info>
+
+  <title>Select a dictionary</title>
+
+  <p>A single dictionary source may have many dictionaries related to various
+  subjects and languages. You can search terms from any of these
+  dictionaries.</p>
+
+  <steps>
+    <title>To select a dictionary:</title>
+    <item>
+      <p>Select <guiseq><gui style="menu">View</gui><gui style="menuitem">Available 
Databases</gui></guiseq>. The sidebar will pop up listing the
+      available dictionaries for your default set dictionary source.</p>
+    </item>
+    <item>
+      <p>Select and click the desired dictionary.</p>
+    </item>
+    <item>
+      <p><link xref="definition">Look up</link> the definition for the desired
+      term.</p>
+    </item>
+  </steps>
+
+  <note style="important">
+    <p>Unless you select another dictionary or open a new instance of
+    <app>Dictionary</app> or restart <app>Dictionary</app>, throughout the
+    current session of <app>Dictionary</app>, terms you search
+    will be looked up from the selected dictionary. By default in a new
+    instance, a term will searched from the first dictionary from the
+    <gui>Available Dictionaries</gui> list.</p>
+  </note>
+</page>
\ No newline at end of file
diff --git a/help/C/prob-error-while-retrieving-definition.page 
b/help/C/prob-error-while-retrieving-definition.page
index fb3f9c8..cdcbfee 100644
--- a/help/C/prob-error-while-retrieving-definition.page
+++ b/help/C/prob-error-while-retrieving-definition.page
@@ -3,7 +3,7 @@
       id="prob-error-while-retrieving-definition">
 
   <info>
-    <revision pkgversion="3.6" date="2013-03-28" status="review"/>
+    <revision pkgversion="3.6" date="2013-03-30" status="review"/>
     <link type="guide" xref="index#troubleshooting"/>
     <link type="seealso" xref="definitions"/>
     <!--link type="guide" xref=""/-->
diff --git a/help/C/sources-default.page b/help/C/sources-default.page
new file mode 100644
index 0000000..c848502
--- /dev/null
+++ b/help/C/sources-default.page
@@ -0,0 +1,46 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="task"
+      id="sources-default">
+
+  <info>
+    <revision version="0.1" date="2013-03-30" status="review"/>
+    <link type="guide" xref="sources-guide#guide"/>
+    <!--link type="guide" xref=""/-->
+
+    <credit type="author copyright">
+      <name>Sindhu S</name>
+      <email>sindhus live in</email>
+      <years>2013</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  </info>
+
+  <title>Set a default dictionary source</title>
+
+  <p>The default dictionary source in <app>Dictionary</app> is to set to
+  <sys href="http://dict.org";>dict.org</sys>. <app>Dictionary</app> can look
+  up definitions from dictionary sources of your choice. This is useful if you
+  often look up terms in a dictionary source other than the default.</p>
+
+  <steps>
+    <title>To set a defualt dictionary source:</title>
+    <item>
+      <p>Select <guiseq><gui><app>Dictionary</app></gui>
+      <gui style="menu">Preferences</gui>
+      <gui style="tab">Source</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>From the list below <gui style="radiobutton">Select a dictionary
+      source for looking up words:</gui>, select the desired dictionary source
+      to be set as the default.</p>
+    </item>
+    <item>
+      <p>Click <gui style="button">Close</gui> to close the
+      <gui><app>Dictionary</app> Preferences</gui> dialog and return to
+      <app>Dictionary</app>.</p>
+    </item>
+  </steps>
+
+</page>
\ No newline at end of file
diff --git a/help/C/sources-guide.page b/help/C/sources-guide.page
index 9d93049..d82893b 100644
--- a/help/C/sources-guide.page
+++ b/help/C/sources-guide.page
@@ -3,7 +3,7 @@
       id="sources-guide">
 
   <info>
-    <revision version="0.1" date="2013-03-28" status="review"/>
+    <revision version="0.1" date="2013-03-30" status="review"/>
     <link type="guide" xref="index#preferences"/>
     <link type="seealso" xref="definition"/>
 
@@ -21,11 +21,10 @@
 
   <title><app>Dictionary</app> sources</title>
 
-  <p><gui><app>Dictionary</app> sources</gui> are collections of terms and
-  their meanings. Each dictionary source contains terms particular to a
-  language or subject. Individually, each dictionary source is called a
-  <em>Dictionary</em>. You can install various dictionaries (both online and
-  offline) related to your interest.</p>
+  <p>Dictionaries are collections of terms and their meanings. A 
+  <gui><app>Dictionary</app> source</gui> is an online or offline resource
+  containing many dictionaries. Each dictionary contains terms particular to a
+  language or subject.</p>
 
   <section id="guide" style="2column">
     <title>Manage your dictionary sources</title>
diff --git a/help/C/sources-select.page b/help/C/sources-select.page
new file mode 100644
index 0000000..2189592
--- /dev/null
+++ b/help/C/sources-select.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="task"
+      id="sources-select">
+
+  <info>
+    <revision version="0.1" date="2013-03-30" status="review"/>
+    <link type="guide" xref="sources-guide#guide"/>
+    <link type="seealso" xref="sources-default"/>
+    <link type="seealso" xref="dictionary-select"/>
+    <!--link type="guide" xref=""/-->
+
+    <credit type="author copyright">
+      <name>Sindhu S</name>
+      <email>sindhus live in</email>
+      <years>2013</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  </info>
+
+  <title>Select a dictionary source</title>
+
+  <p><app>Dictionary</app> allows you to change the
+  <link xref="sources-default">default dictionary source</link>
+  without affecting the <link xref="index#preferences">
+  <gui>Preferences</gui></link>.</p>
+
+  <steps>
+    <title>To temporarily change the dictionary source:</title>
+    <item>
+      <p>Select <guiseq><gui style="menu">View</gui>
+      <gui style="menuitem">Dictionary Sources</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select and click on the desired dictionary source.</p>
+    </item>
+  </steps>
+
+</page>
\ No newline at end of file
diff --git a/help/C/strategies.page b/help/C/strategies.page.stub
similarity index 100%
rename from help/C/strategies.page
rename to help/C/strategies.page.stub
diff --git a/help/Makefile.am b/help/Makefile.am
index 3cd2e9c..12c4ee7 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -4,6 +4,7 @@ HELP_ID = gnome-dictionary
 
 HELP_FILES = \
           definition.page \
+          dictionary-select.page \
           find.page \
           index.page \
           introduction.page \
@@ -14,7 +15,9 @@ HELP_FILES = \
           prob-error-while-retrieving-definition.page \
           save-definition.page \
           similar-words.page \
+          sources-default.page \
           sources-guide.page \
+          sources-select.page \
           text-operations.page
 HELP_MEDIA = \
        figures/gnome-dictionary-icon.png \