Syntax: search <archive | path-to-archive>] [/password] [-all] <pattern>

	Search all files of the specified archive (and all of its subarchives
	if  -all  is specified) for lines that match the pattern. The pattern
	can be an  egrep(1)-style  regular expression  with  support  for the
	following additional operators: '~',if leading the regular expression
	it reverses  its  meaning;  '|'  and  '&'  separate multiple  regular
	expressions (logical OR and AND);  '<' '>'  group regular expressions
	(we preserve the meaning of the parentheses from ed(1),and remove the
	meaning of < and > from ed(1) since in the ListProcessor context they
	are either the default or inappropriate). These can be used literally 
	by escaping  them with  '\' .  In addition,  the following characters
	should be defined in matched pairs:  (),  <>,  []. The pattern may be 
	enclosed in single or double quotes.

	Pattern matching is case insensitive.

	Certain archives may be private, and in this case you have to specify 
	a  password  for accessing  them.  The slash  is required.  Different
	archives may have different passwords.

	The archiving system is hierarchical.  Therefore subarchives may have 
	the same names;  they can be distinguished by the path (the branch in 
	the hierarchy) to them.For example,the archives unix and pub/unix are
	distinct.  'path-to-archive'  is a UNIX style path (such as pub/unix)
	-- i.e. a '/'  is used to move through the branches of the hierarchy. 
	An  'index'  request always reports  paths to archives  for your con-
	vinience.

	EXAMPLES:

	search listproc -all "<oranges &~apples>|.*andarin[sz]?"
	search ilp '\|.*\|.$'

	NOTES:
	
	- . matches ANY character including newline, so to find all lines
	  that contain a newline only, one should use '^.$' instead of '^$'
	  
	- If you do not quote your pattern, it will include any blanks you
	  may have appended after it by mistake, and it will not include any
	  blanks that may start the regular expression.
