[banshee/docs] add search docs

[Paul Cutler <pcutler src gnome org>]

commit 21243e29fd017b422dae652e702552c4b6dad561
Author: Paul Cutler <pcutler gnome org>
Date:   Sat May 29 20:39:09 2010 +0800

    add search docs

 help/C/search.page |   95 ++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 92 insertions(+), 3 deletions(-)
---
diff --git a/help/C/search.page b/help/C/search.page
index b8f25cc..c79264d 100644
--- a/help/C/search.page
+++ b/help/C/search.page
@@ -21,11 +21,100 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Search</title>    
+  <title>Searching your Banshee Library</title>    
   
-  <p></p>
+  <p>Banshee features a powerful search language.  You can search your 
+  library quickly and easily with basic search terms or perform detailed
+  searches with Banshee's advanced search terminology.</p>
   
-  <p>
+  <p>To perform a search of your media in Banshee, press the <key>S</key> or
+  click the <gui>Search</gui> box in the upper right hand corner of the Library
+  view in Banshee.
   </p>
+  
+  <p>A search query consists of some basic terms, for example, 
+  <em>dave matthews</em>.  By entering <em>dave matthews</em> in the search box,
+   Banshee will search all metatdata fields including Track Title, Album Title,
+   Album Artist, Year, etc.  Any track whose metadata includes <em>dave</em> 
+   and <em>matthews</em> will be returned.  Search terms are case insensitive
+   so you don't have to capitalize.  <em>dave</em>, <em>Dave</em>, and <em>DAVE</em>
+   all mean the same thing when searching.</p>
+
+<section id="operators">
+  <title>Basic Operators</title>
+  <p>Operators can be placed between any two search words or placed before a 
+  search word.  The default operation is <gui>AND</gui> and is used when
+  no other operators are used between two search terms.  Because it is the
+  default, there is no explicit AND operator.</p>
+  
+  <p>Other basic operators include <gui>OR</gui> and <gui>NOT</gui>.  Together,
+  these three operations can yield very powerful queries to help you search
+  your media.</p>
+  
+</section>
+
+<section id="logical">
+  <title>Logical Operators and Examples</title>
+  <p>The following is a list of logical operators and examples of the search
+  results when searching using them.</p>
+  
+  <table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Operator</gui></p></td>  <td><p><gui>Description</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><em>default</em>, <em>white space</em></p></td> <td><p>
+    Search for two terms with a space between the two words or terms.</p></td>
+  </tr>
+  <tr>
+    <td><p>OR, or, <key>|</key>, <key>,</key></p></td> <td><p>
+    Search results will be two terms with either result in any field.</p></td>
+  </tr>
+  <tr>
+    <td><p>NOT, not,<key>-</key></p></td> <td><p>
+    Do not display search results with any search team that follows the 
+    operator of NOT, not,<key>-</key>.</p></td>
+  </tr>  
+         
+</table>
+
+  <p>Examples of logical operations include:</p>
+  
+  <table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Query</gui></p></td>  <td><p><gui>Description</gui></p></td>
+  </tr>
+  <tr>
+    <td><p>dave matthews</p></td> <td><p>
+    Matches any fields in a track containing both <em>dave</em> and 
+    <em>matthews</em>.</p></td>
+  </tr>
+  <tr>
+    <td><p>dave, matthews</p></td> <td><p>
+    Matches any fields in a track containing both <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr>
+  <tr>
+    <td><p>dave or matthews</p></td> <td><p>
+    Matches any fields in a track containing both <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr> 
+  <tr>
+    <td><p>dave | matthews</p></td> <td><p>
+    Matches any fields in a track containing both <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr>       
+  <tr>
+    <td><p>-"dave matthews"</p></td> <td><p>
+    Displays all tracks whose fields do not containt <em>dave
+    matthews</em>.</p></td>
+  </tr> 
+  
+  </table> 
+  
+  <p>For more information on performing more complex search queries,
+  see the <link xref="adv-search"/> page.</p>
+  
+</section>
 	
 </page>