[easytag/wip/help: 3/3] Add CDDB search help page

[David King <davidk src gnome org>]

commit db0097eb1fbcd1fe6ce2a337e392bea285af25dc
Author: David King <amigadave amigadave com>
Date:   Sun Oct 6 23:15:33 2013 +0100

    Add CDDB search help page

 help/C/cddb-search.page |   69 +++++++++++++++++++++++++++++++++++++++++++++++
 help/Makefile.am        |    1 +
 2 files changed, 70 insertions(+), 0 deletions(-)
---
diff --git a/help/C/cddb-search.page b/help/C/cddb-search.page
new file mode 100644
index 0000000..c21c09c
--- /dev/null
+++ b/help/C/cddb-search.page
@@ -0,0 +1,69 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="guide"
+      id="cddb-search">
+
+  <info>
+    <link type="guide" xref="index#main"/>
+    <revision pkgversion="2.1.9" date="2013-10-06" status="draft" />
+
+    <credit type="author">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Fill tags using information from a CD database</desc>
+  </info>
+
+  <title>Search CDDB</title>
+
+  <p>If your music is organized by album, <app>EasyTAG</app> can search online
+  databases using the <sys>CDDB</sys> protocol and automatically fill in
+  several tag fields.</p>
+
+  <steps>
+    <item>
+      <p><link xref="file-select">Select the files</link> for the album that
+      you want to search for in the file list. The ordering of the files should
+      match the order of tracks on the album, so you should adjust the sort
+      order<!-- TODO link --> until the order in the file list is correct.</p>
+    </item>
+    <item>
+      <p>Select <guiseq><gui style="menu">Miscellaneous</gui>
+      <gui style="menuitem">CDDB Search…</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select <gui style="button">Find</gui> and wait for the search to
+      finish.</p>
+    </item>
+    <item>
+      <!-- TODO Split Manual search into a tip? -->
+      <!-- TODO Search within the results. -->
+      <p>Select an album in the list of results, and the track information will
+      be shown to the right. If the album is not the one that you wanted, try
+      selecting another result in the list.</p>
+      <p>If there are no results which match the tracks that you selected,
+      select <gui style="tab">Manual Search</gui> and enter the name of the
+      album in the search field. Select <gui style="button">Find</gui> and wait
+      for the search to finish, and check the results again to see if you can
+      find an album which matches the tracks that you selected.</p>
+    </item>
+    <item>
+      <p>Choose the tag fields to fill in by selecting either
+      <gui style="checkbox">All</gui> or a combination of
+      <gui style="checkbox">Filename</gui>, <gui style="checkbox">Title</gui>,
+      <gui style="checkbox">Artist</gui>, <gui style="checkbox">Album</gui>,
+      <gui style="checkbox">Year</gui>, <gui style="checkbox">Track #</gui>,
+      <gui style="checkbox"># Tracks</gui>, or
+      <gui style="checkbox">Genre</gui>.</p>
+    </item>
+    <!-- TODO Run the scanner for each file -->
+    <!-- TODO Levenshtein matching -->
+    <item>
+      <p>To fill in the tags of the selected files using the details in the
+      search result, select <gui style="button">Apply</gui>.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 9ae4448..f48cb1b 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -3,6 +3,7 @@
 HELP_ID = easytag
 
 HELP_FILES = \
+       cddb-search.page \
        file-rename.page \
        file-select.page \
        format-specifier.page \