SEARCHBOOK(1)                                                    SEARCHBOOK(1)


NAME
     searchbook - (a.k.a. search tool) find files

SYNOPSIS
     /usr/sbin/searchbook [-file | searchbookfile]

DESCRIPTION
     The searchbook (or search tool) contains named pages on which users can
     create queries to find files.  The user can launch searchbook from the
     toolchest (Find > Search For Files) or at a Unix shell command line.
     This application has the ``runonce'' feature, meaning only one instance
     of the application will run at one time.  Attempting to launch the
     application a second time will have the effect of deiconifying the
     application window or popping it to the top on the current desk.

     The options have effects as follows:

     -file   Opens searchbook to a fresh, blank page.

     searchbookfile
             Specifies the criteria for a specific search.  Defines the
             configuration and setup of a searchbook page.

     Each page contains a query area at the top, a Search button, and a
     results area at the bottom.  Search criteria can be added from the Match
     menu on the menubar.  For more information on the criteria, please refer
     to the online books for help about the search tool.  The user can switch
     to different pages by clicking the left mouse button on the bottom tabs.

     As in the iconcatalog, icons in the search tool are references to the
     actual files.  This differs from directory views.  Icons can not be
     dragged onto searchbook pages; icons appear there only if the user
     presses Search or if the user makes a copy of a file icon already on that
     page.  Searchbook pages are shaded light gray (in the default IndigoMagic
     color scheme) to indicate that icons can not be dragged onto them.
     Operations such as "copy" or "make linked copy" on icons in the search
     tool will create new files in the user's home directory.

     The search tool remembers each page's query, contents, size, mode of
     display, and which page the book is open to on each desk.

     Searchbook pages can be derived either from the system's default Files
     page or from a user's own new search pages.  Pages derived from the
     system's default page can be changed by the user.  To return the system
     default page to its original state, use the Remove command.  A message
     will confirm the user's removal of local changes.

     For more information about the entire IRIX Interactive Desktop
     environment, see the IID(1) man page.


FILES
     $HOME/.desktop-<hostname>/searchbook/
     /usr/lib/desktop/searchbook/syspages/Files
     /usr/lib/desktop/searchbook/syspages/searchbookMark


     The searchbook stores page information as the user defines the desired
     search criteria under ~/.desktop-<hostname>/searchbook or
     /usr/lib/desktop/searchbook/syspages.  The user does not need to alter
     these files directly.  The searchbookMark file records the currently open
     page.  The internal format of these files is not guaranteed to remain
     constant between releases.


SEE ALSO
     The IRIX Interactive Desktop Users Guide, IID(1), iconcatalog(1)


BUGS
     The user can create a page with the same name as the system default page
     "Files."  Searchbook can distinguish them, but to avoid confusion it is
     recommended that the user rename the new page.

     Sometimes after a match criterion has been removed or added, the vertical
     sizing of the criteria lines will be wrong.  To fix this, resize the
     window vertically a bit.


                                                                        Page 2