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

  <info>
    <revision version="0.1" date="2013-03-03" status="candidate"/>
    <link type="guide" xref="index#textoutput"/>

    <credit type="author copyright">
      <name>Sindhu S</name>
      <email>sindhus@live.in</email>
      <years>2013</years>
    </credit>
    <credit type="copyright editor">
      <name>Ekaterina Gerasimova</name>
      <email>kittykat3756@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="copyright editor">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
      <years>2013</years>
    </credit>

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

    <desc>Search the <app>Terminal</app> output.</desc>

  </info>

  <title>Use <gui style="menuitem">Find</gui></title>

  <p>You can search text in the <app>Terminal</app> output:</p>

  <steps>
    <item>
      <p>Select <guiseq><gui style="menu">Search</gui>
      <gui style="menuitem">Find…</gui></guiseq>.</p>
    </item>
    <item>
      <p>Type in the search keyword and press <gui style="button">Find</gui>.
      To cancel, press <gui style="button">Close</gui>.</p>
    </item>
  </steps>

  <p>You can search using the following options to narrow down your
  results:</p>

  <terms>
    <item>
      <title><gui style="checkbox">Match case</gui></title>
      <p>Make the search case sensitive: this restricts results to only those
      that match the case of your search keyword.</p>
    </item>
    <item>
      <title><gui style="checkbox">Match entire word only</gui></title>
      <p><app>Terminal</app> will look for the entire keyword and will ignore
      results that partially match your search keyword. For example, if
      you have searched for "gnome", <app>Terminal</app> will show only
      results that match this keyword exactly and omit results such as
      "gnome-terminal".</p>
    </item>
    <item>
      <title><gui style="checkbox">Match as regular expression</gui></title>
      <p>You can use regular expression patterns, also known as regex
      patterns, in your search keywords. <app>Terminal</app> will display
      the results that match these search terms.</p>
    </item>
    <item>
      <title><gui style="checkbox">Search backwards</gui></title>
      <p><app>Terminal</app> will search for the keyword from the latest output
      and continue the search upwards. This option is recommended when you are
      looking for a keyword that could have occurred recently, thus enabling
      you to find the keyword quickly.</p>
    </item>
    <item>
      <title><gui style="checkbox">Wrap around</gui></title>
      <p><app>Terminal</app> searches from your current location in the
      scrollback to the end of available terminal output and then restarts the
      search from the top.</p>
    </item>
  </terms>

  <note style="tip">
    <p>If you expect to work with a lot of <app>Terminal</app> output, increase
    the <link xref="pref-scrolling#lines">scrollback lines</link> to
    a higher limit to allow <app>Terminal</app> to search further back.</p>
  </note>

</page>
