[gnome-user-docs] Update files-search.page

[David King <davidk src gnome org>]

commit 266020b078b42f6e7aae587aa83ce0d824759538
Author: Jim Campbell <jcampbell gnome org>
Date:   Sat Jul 20 13:40:44 2019 -0700

    Update files-search.page
    
    Update files-search.page to reflect current search functionality within
    Nautilus / GNOME Files.
    Include information on how to customize search within Nautilus
    Fixes #49

 gnome-help/C/figures/edit-find-symbolic.svg |  6 ++
 gnome-help/C/files-search.page              | 86 +++++++++++++++++++++++++----
 2 files changed, 80 insertions(+), 12 deletions(-)
---
diff --git a/gnome-help/C/figures/edit-find-symbolic.svg b/gnome-help/C/figures/edit-find-symbolic.svg
new file mode 100644
index 00000000..8686f071
--- /dev/null
+++ b/gnome-help/C/figures/edit-find-symbolic.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg"; width="16" height="16">
+    <g color="#000" font-weight="400" font-family="sans-serif" white-space="normal" fill="#474747">
+        <path d="M6.508 1C3.48 1 1.002 3.474 1.002 6.5S3.48 12 6.508 12s5.505-2.474 5.505-5.5S9.536 1 6.508 
1zm0 2a3.488 3.488 0 0 1 3.505 3.5c0 1.944-1.557 3.5-3.505 3.5a3.488 3.488 0 0 1-3.506-3.5c0-1.944 1.557-3.5 
3.506-3.5z" 
style="line-height:normal;font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000;text-transform:none;text-orientation:mixed;shape-padding:0;isolation:auto;mix-blend-mode:normal;marker:none"
 overflow="visible"/>
+        <path d="M10 8.99a1 1 0 0 0-.696 1.717l4.004 4a1 1 0 1 0 1.414-1.414l-4.003-4a1 1 0 0 0-.72-.303z" 
style="line-height:normal;font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000;text-transform:none;text-orientation:mixed;shape-padding:0;isolation:auto;mix-blend-mode:normal;marker:none"
 overflow="visible"/>
+    </g>
+</svg>
diff --git a/gnome-help/C/files-search.page b/gnome-help/C/files-search.page
index 7b0d9858..7e56023f 100644
--- a/gnome-help/C/files-search.page
+++ b/gnome-help/C/files-search.page
@@ -1,4 +1,6 @@
 <page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      xmlns:ui="http://projectmallard.org/ui/1.0/";
       type="guide" style="task"
       id="files-search">
 
@@ -8,6 +10,7 @@
     <revision pkgversion="3.6.0" version="0.2" date="2012-09-25" status="review"/>
     <revision pkgversion="3.13.92" date="2014-09-20" status="review"/>
     <revision pkgversion="3.18" date="2015-09-29" status="final"/>
+    <revision pkgversion="3.34" date="2019-07-20" status="draft"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -25,6 +28,10 @@
       <name>David King</name>
       <email>amigadave amigadave com</email>
     </credit>
+    <credit type="editor">
+      <name>Jim Campbell</name>
+      <email>jcampbell gnome org</email>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
@@ -58,36 +65,91 @@
       invoices with the word “Invoice”, type <input>invoice</input>. Words are
       matched regardless of case.</p>
       <note>
-        <p>Instead of typing words directly to bring up the search bar, you can
-       click the magnifying glass in the toolbar, or press
+        <p>Instead of typing words directly to bring up the search bar, you
+        can click the <media its:translate="no" type="image" mime="image/svg"
+        src="figures/edit-find-symbolic.svg"> <key>Search</key> key symbol
+        </media> in the toolbar, or press
         <keyseq><key>Ctrl</key><key>F</key></keyseq>.</p>
       </note>
     </item>
     <item>
-      <p>You can narrow your results by location and file type.</p>
+      <p>You can narrow your results by date, by file type, and by whether to
+      search a file's full text, or to only search for file names.</p>
+      <p>To apply filters, select the drop-down menu button to the left of the
+      file manager's <media its:translate="no" type="image" mime="image/svg"
+      src="figures/edit-find-symbolic.svg"> <key>Search</key> key symbol</media>
+      icon, and choose from the available filters:</p>
       <list>
         <item>
-          <p>Click <gui>Home</gui> to restrict the search results to your
-          <file>Home</file> folder, or <gui>All Files</gui> to search
-          everywhere.</p>
+          <p><gui>When</gui>: How far back do you want to search?</p>
+        </item>
+        <item>
+          <p><gui>What</gui>: What is the type of item?</p>
         </item>
         <item>
-          <p>Click the <gui>+</gui> button and pick a <gui>File Type</gui> from
-         the drop-down list to narrow the search results based on file type.
-         Click the <gui>×</gui> button to remove this option and widen the
-         search results.</p>
+          <p>Should your search include a full-text search, or search only the
+          file names?</p>
         </item>
       </list>
     </item>
+    <item>
+      <p>To remove a filter, select the <gui>X</gui> beside the filter tag
+      that you want to remove.</p>
+    </item>
     <item>
       <p>You can open, copy, delete, or otherwise work with your files from the
       search results, just as you would from any folder in the file
       manager.</p>
     </item>
     <item>
-      <p>Click the magnifying glass in the toolbar again to exit the search and
-      return to the folder.</p>
+      <p>Click the <media its:translate="no" type="image" mime="image/svg"
+      src="figures/edit-find-symbolic.svg"> <key>Search</key> key symbol
+      </media> in the toolbar again to exit the search and return to the
+      folder.</p>
+    </item>
+  </steps>
+
+<section id="customize-files-search">
+  <title>Customize files search</title>
+
+<p>You may want certain directories to be included or excluded from searches
+in the <app>Files</app> application. To customize which directories are
+searched:</p>
+
+  <steps>
+    <item>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+      overview and start typing <gui>Search</gui>.</p>
+    </item>
+    <item>
+      <p>Select <guiseq><gui>Settings</gui><gui>Search</gui></guiseq> from the
+      results. This will open the <gui>Search Settings</gui> panel.</p>
+    </item>
+    <item>
+      <p>Select the <media its:translate="no" type="image" mime="image/svg"
+      src="figures/emblem-system-symbolic.svg"> <key>Preferences</key> key
+      symbol</media> icon from the bottom of the <gui>Search</gui> settings
+      panel.</p>
     </item>
   </steps>
 
+<p>This will open a separate settings panel which allows you toggle directory
+searches on or off. You can toggle searches on each of the three tabs:</p>
+
+  <list>
+    <item>
+      <p><gui>Places</gui>: Lists common home directory locations</p>
+    </item>
+    <item>
+      <p><gui>Bookmarks</gui>: Lists directory locations that you have
+      bookmarked in the <app>Files</app> application</p>
+    </item>
+    <item>
+      <p><gui>Other</gui>: Lists directory locations that you include via
+      the <gui>+</gui> button.</p>
+    </item>
+  </list>
+
+</section>
+
 </page>