Imported Upstream version 0.18.1upstream/0.18.1

1 files changed, 63 insertions, 0 deletions

diff --git a/help/C/organize-search.page b/help/C/organize-search.page
new file mode 100644
index 0000000..7f97370
--- /dev/null
+++ b/help/C/organize-search.page
@@ -0,0 +1,63 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="search">
+
+    <info>
+        <link type="guide" xref="index#organize"/>
+        <desc>Find photos and videos in your collection by a variety of criteria.</desc>
+        
+        <link type="next" xref="tag"/>
+    </info>
+
+    <title>Searching</title>
+    
+    <p>
+        There are two ways to search in Shotwell: the filter toolbar, and with a saved search.  The search 
+        bar allows you to quickly search the current view for certain criteria.  Saved Searches feature
+        more complex search criteria and persist in the sidebar between sessions.
+    </p>
+    
+    <section id="searchbar">
+        <title>Search bar</title>
+            <p>
+                The <guiseq><gui>View</gui><gui>Search Bar</gui></guiseq> checkbox toggles the display of the
+                search bar.  You can also hit <keyseq><key>Ctrl</key><key>F</key></keyseq> or <key>F8</key> to
+                bring up the search bar. From this bar, you can find, show and hide photos and videos based on
+                title, tag, rating or other options.
+            </p>
+            
+            <p>
+                To begin searching, simply enter a search keyword in the text box, or click on <gui>Flagged</gui>,
+                <gui>Rating</gui> or <gui>Type</gui>. The text search matches your keywords across tag names, 
+                photo or video titles and photos' original filenames. The <gui>Flagged</gui>,
+                <gui>Rating</gui> and <gui>Type</gui> buttons allow you to filter your collection by 
+                whether photos are flagged, their current number of stars, and whether the items shown are
+                images, videos, or raw camera files, respectively. 
+            </p>
+            
+            <p>
+                Disabling the search bar or exiting Shotwell automatically resets the search bar.
+            </p>
+    </section>
+    
+    <section id="savedsearch">
+        <title>Saved search</title>
+            <p>
+                A saved search persists across Shotwell sessions, and is updated as photos and videos are added 
+                and removed from your Shotwell library.
+            </p>
+            
+            <p>
+                Create a new saved search with <guiseq><gui>Edit</gui><gui>New Search</gui></guiseq> or by hitting 
+                <keyseq><key>Ctrl</key><key>S</key></keyseq>. The dialog box allows you to enter a name for the
+                search and select whether you want to meet Any, All, or None of the criteria in the following rows.
+            </p>
+            
+            <p>
+                Each row represents a search criterion.  Use the + button to add more rows, and the - button to
+                remove a specific row.  The combo box on the left of each row selects the type of criteria.  
+                Criteria must be entered correctly before the OK button becomes available.
+            </p>
+    </section>
+
+</page>