<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" id="mail-searching">
 
  <info>
    <desc>Searching messages.</desc>
    
    <link type="guide" xref="searching-items" />
    <link type="guide" xref="mail-organizing" />
 
    <revision pkgversion="2.32.1" version="0.2" date="2010-10-12" status="draft" />
    <credit type="author">
      <name>Max Vorobuov</name>
      <email>vmax0770@gmail.com</email>
    </credit>
    <credit type="author">
      <name>Andre Klapper</name>
      <email>ak-47@gmx.net</email>
    </credit>
    <credit type="author">
      <name>Novell, Inc</name>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>    
 
  </info>
 
<title>Searching Mail</title>
<section id="quick-search">
<title>Quick Search</title>
<p>In the mail view, you can quickly search for messages by defining conditions.</p>
<steps>
<item><p>Click on the search icon <media type="image" mime="image/png" src="figures/search-icon.png"/> to expand the drop-down list.</p></item>
<item><p>Select the search condition from the list.</p></item>
<item><p>Select the scope from the drop-down list right to the text box.</p></item>
<item><p>Enter the text you want to search for and press <key>Enter</key>.</p></item>
<item><p>Evolution displays the search results.</p></item>
</steps>
<note style="tip"><p>If you start directly from the fourth step, text will be searched in mail's subjects and addresses and scope will be "Current folder".</p></note>
<note style="tip"><p>If you search for messages that are not in the same folder rather often you might want to create a search folder instead; see <link xref="mail-search-folders">Using Search Folders</link> for more detail.</p></note>
<p>If you want to set several search conditions, you should use an Advanced search, which is described below.</p>
</section>
  
<section id="advanced-search">
<title>Advanced Search:</title>
<steps>
<item><p>Select the <guiseq><gui>Search</gui><gui>Advanced Search</gui></guiseq> menu to open the dialog box.</p></item>
<item><p>Click <gui style="button">Add Condition</gui> to add any number of rules.</p></item>
<item><p>Select the condition from the dropdown list, and then type a search entry in the field.</p></item>
<item><p>Click <gui style="button">OK</gui> to get the search results displayed.</p></item>
</steps>
</section>

<!-- TODO:XINCLUDE: Needs refactoring as clearing-search and saved-searches are totally identical in all *-searching.page files -->
<section id="clearing-search">
<title>Clearing the Search results</title>
<p>To clear your search view and get back to the default view, click the <gui>Clear</gui> icon in the search string field, or choose <guiseq><gui>Search</gui><gui>Clear</gui></guiseq> from the menubar. You can also press <keyseq><key>Shift</key><key>Ctrl</key><key>Q</key></keyseq> to clear the search.</p>
</section>

<section id="saved-searches">
<title>Saved Searches</title>
<p>If you search for something rather often, you will prefer not to type it many times. In this case you can use saved searches.</p>
<p>To save your search results, either click <gui>Save</gui> instead of <gui>OK</gui> in the Search dialog, or in case the search results are already displayed, select <guiseq><gui>Search</gui><gui>Save Search</gui></guiseq>. From now on this search will be directly available from the <gui>Search</gui> menu.</p>
</section>
 
<section id="editing-a-saved-search">
<title>Editing a Saved Search</title>
<steps>
<item><p>Select <guiseq><gui>Search</gui><gui>Edit Saved Searches</gui></guiseq> from the menu bar to open the window.</p></item>
<item><p>Click the <gui style="button">Edit</gui> button to open the <gui>Edit Rule</gui> window.</p></item>
<item><p>Edit the title or search conditions from the dialog box.</p></item>
<item><p>Click <gui>OK</gui>.</p></item>
</steps>
</section>
 
</page>
