<HTML
><HEAD
><TITLE
>Usage</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="GNOME Search Tool"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="GNOME Search Tool"
HREF="index.html"><LINK
REL="NEXT"
TITLE="Search Criteria"
HREF="criteria.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME Search Tool</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="index.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="criteria.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="USAGE"
>Usage</A
></H1
><P
>    <TT
CLASS="APPLICATION"
>GNOME Search Tool</TT
> provides two types of
    search: <I
CLASS="EMPHASIS"
>Full find</I
> and <I
CLASS="EMPHASIS"
>Quick
    find</I
>. Full find is reliable and provides many
    possibilities, but can be slow. Quick find uses special technique
    for speeding up search; it is much faster, but can only search by
    filename, and is not as accurate as full find. This section
    describes full find mode; quick find is described in <A
HREF="locate.html"
>the section called <I
>Quick  find mode</I
></A
>.  
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MAINWIN"
></A
><P
><IMG
SRC="mainwin.png"></P
><P
><B
>Figure 1. Main search window</B
></P
></DIV
><P
> 
      To start a search, you must give the GNOME Search Tool the
      search criteria and the directory to start in. 
    </P
><P
> By default, the search starts in the current working
      directory; if the <TT
CLASS="APPLICATION"
>GNOME Search Tool</TT
>
      was started from the menu, then the current working directory is
      your home directory. You can change the starting directory by
      entering any valid path in the <TT
CLASS="GUILABEL"
><B
>Start in
      directory</B
></TT
> field, or by choosing a directory using the
      <B
CLASS="GUIBUTTON"
>Browse...</B
> button. For example, to search
      through all the files in on your system, enter
      <TT
CLASS="FILENAME"
>/</TT
> in this field (warning: it will take
      <I
CLASS="EMPHASIS"
> very</I
> long time).  </P
><P
> By default, <TT
CLASS="APPLICATION"
>GNOME Search Tool</TT
>
      also searches through all subdirectories of the given directory;
      you can turn this behavior off by enabling the option
      <TT
CLASS="GUILABEL"
><B
>Don't search subdirectories</B
></TT
>. For finer
      control, you can enable the option <TT
CLASS="GUILABEL"
><B
>Don't search
      mounted filesystems</B
></TT
>, which will exclude from the
      search subdirectories which are physically located (mounted) on
      drives or partitions other than the starting directory &#8212;
      see <A
HREF="criteria.html"
>the section called <I
>Search Criteria</I
></A
> for details.
    </P
><P
> 
      The only search criterion presented by default is the
      <TT
CLASS="GUILABEL"
><B
>Filename</B
></TT
>. You can use the wildcards
      <SPAN
CLASS="KEYSYM"
>*</SPAN
> 
      (matches any sequence of symbols, including an empty one) and
      <SPAN
CLASS="KEYSYM"
>?</SPAN
> 
      (matches any single symbol) in this field. For example, to find
      the files with the extension <TT
CLASS="FILENAME"
>txt</TT
>, enter
      <TT
CLASS="USERINPUT"
><B
>*.txt</B
></TT
> in this field; to find all the
      files that start with the letter D, enter
      <TT
CLASS="USERINPUT"
><B
>D*</B
></TT
> (warning: file names are
      case-sensitive!).  You can also specify much more complicated
      search criteria &#8212; see <A
HREF="criteria.html"
>the section called <I
>Search Criteria</I
></A
>.
   </P
><P
> After you have specified the search criteria and starting
   directory, press <B
CLASS="GUIBUTTON"
>Start</B
>. This will take some
   time (depending on the directory size and system speed), after
   which you will be presented with a window containing the list of
   all the files matching your criteria (it may be empty), as shown in
   <A
HREF="usage.html#RESULTS"
>Figure 2</A
>. If the search is taking too much time,
   you can abort it by pressing <B
CLASS="GUIBUTTON"
>Stop</B
> button.
   </P
><DIV
CLASS="FIGURE"
><A
NAME="RESULTS"
></A
><P
><IMG
SRC="results.png"></P
><P
><B
>Figure 2. Search results window</B
></P
></DIV
><P
> In the search results window, you can double-click on any
      file to open it. It will have the same effect as double-clicking
      on this file in a File Manager window &#8212; that is, the file
      will be opened using the default action for this file type. You
      can also save the list of found files  to disk by pressing
      <B
CLASS="GUIBUTTON"
>Save</B
> button. You wil be prompted for a
      filename to save the list to; the list will be saved in a plain
      text format. 
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="index.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="criteria.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>GNOME Search Tool</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Search Criteria</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>