


search(1)		  User Commands			search(1)



NAME
     search - SWISH++ searcher

SYNOPSIS
     search [ options ]	query

DESCRIPTION
     search is the SWISH++ searcher.

  Query	Input
     The formal	grammar	of a query is:

	  query:	  query	optional_relop primary
			  primary

	  primary:	  ( query )
			  not primary
			  word
			  word*

	  optional_relop: and
			  or
			  (empty)

     In	practice, however, the query is	the set	of  words  sought
     after, possibly combined with the Boolean operators ``and,''
     ``or,'' and ``not.''  The asterisk	(*)  can  be  used  as	a
     wildcard  character  at  the  end	of  words.   Queries  are
     evaluated in left-to-right	order, i.e., ``and'' has the same
     precedence	as ``or.''  See	the EXAMPLES.

  Results Output
     The results are output in the format of:

	  rank path-name file-size file-title

     where rank	is an integer from from	1 to 100.  The	path-name
     is	 relative  to  where  the  set	of  files  was originally
     indexed.  If the file is an HTML file,  then  file-title  is
     its  title;  otherwise,  it is its	filename.  A results line
     can be parsed easily in Perl with:

	  ($rank,$path,$size,$title) = split( /	/, $_, 4 );


OPTIONS
     -d		     Dump the entire index file	to standard  out-
		     put.

     -iindex-file    The name of the  index  file  to  use.   The
		     default  is the.index in the present working
		     directory.



SWISH++		   Last	change:	March 5, 1998			1






search(1)		  User Commands			search(1)



     -mmax-results   The maximum  number  of  results  to  return
		     overriding	the compiled-in	default	(which is
		     usually 100).

     -sskip-results  The initial number	of results to skip.   The
		     default  is 0.  Used in conjunction with -m,
		     results can be returned in	``pages.''

     -V		     Print the	version	 number	 of  SWISH++  and
		     exit.

EXAMPLES
     The query:

	  librar*

     will  return  all	documents   that   contain   ``library,''
     ``libraries,'' or ``librarian.''  The query:

	  mouse	and computer

     will return only those documents regarding	the kind of  mice
     attached to a computer and	not the	rodents.  The query:

	  cat or kitten	or feline

     will return only those documents regarding	cats.  The query:

	  mouse	or mice	and not	computer

     will  return  only	 those	documents  regarding  mice   (the
     rodents) and not the kind attached	to a computer. The query:

	  mouse	and computer or	keyboard

     is	the same as:

	  (mouse and computer) or keyboard

     in	that they will both return only	those documents	regarding
     either  mice attached to a	computer or any	kind of	keyboard.
     However, neither of those is the same as:

	  mouse	and (computer or keyboard)

     that will return only those  documents  regarding	mice  and
     either a computer or a keyboard.

EXIT STATUS
     Exits with	a value	of zero	only if	the  query  was	 properly
     formed; non-zero otherwise.




SWISH++		   Last	change:	March 5, 1998			2






search(1)		  User Commands			search(1)



FILES
     the.index	   default index file name

SEE ALSO
     index(1), perlfunc(1)

AUTHOR
     Paul J. Lucas <pjl@best.com>















































SWISH++		   Last	change:	March 5, 1998			3



