<page xmlns="http://projectmallard.org/1.0/"
      type="guide" style="task"
      id="files-search">

  <info>
    <revision pkgversion="0.0.1" version="0.0.3" date="2015-01-28" status="draft"/>

    <link type="guide" xref="files"/>
    <link type="guide" xref="shell-overview#files"/>
    <desc>Locate files based on file name and type. Save your searches for later use.</desc>

    <credit type="author">
      <name>Mate Documentation Team</name>
      <years>2015</years>
    </credit>

    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list@gnome.org</email>
    </credit>
    <credit type="author">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Search for files</title>

  <p>You can search for files based on their name or file type directly
  within the file manager. You can even save common searches, and they
  will appear as special folders in your home folder.</p>

  <links type="topic" style="linklist">
    <title>Other search applications</title>
    <!-- This is an extension point where search apps can add
    their own topics. It's empty by default. -->
  </links>

  <steps>
    <title>Search</title>
    <item><p>Open the <app>Files</app> application from the
    <gui>Activities</gui> overview.</p></item>
    <item><p>If you know the files you want are under a particular
    folder, go to that folder.</p></item>
    <item><p>Click <gui>Search</gui> in the toolbar, or press
    <keyseq><key>Ctrl</key><key>F</key></keyseq>.</p></item>
    <item><p>Type a word or words that you know appear in the file
    name and press enter. For example, if you name all your invoices
    with the word "Invoice", type <input>invoice</input>. Words are
    matched regardless of case.</p></item>
    <item><p>You can narrow your results by selecting a different
    starting folder in <gui>Location</gui>. Or click <gui>Location</gui>
    and select <gui>File Type</gui> from the drop-down list to narrow
    your results based on file type. Click the <gui>+</gui> button to
    add multiple filters if you want to narrow based on location and
    file type. When you make changes, click <gui>Reload</gui> to search
    again.</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 <gui>Search</gui> in the toolbar again to exit the
    search and return to the folder.</p></item>
  </steps>

  <p>If you perform certain searches often, you can save them to
  access them quickly.</p>

  <steps>
    <title>Save a search</title>
    <item><p>Start a search as above.</p></item>
    <item><p>When you're happy with the search parameters, click
    <guiseq><gui>File</gui><gui>Save Search As</gui></guiseq>.</p></item>
    <item><p>Give the search a name and click <gui>Save</gui>. If you
    like, select a different folder to save the search in. When you
    view that folder, you will see your saved search as an orange
    folder icon with a magnifying glass on it.</p></item>
  </steps>
</page>
