
Doing search
------------

Open your prefered frontend in Web browser:
http://your.web.server/path/to/search.cgi
or
http://your.web.server/path/to/search.php3
or
http://your.web.server/path/to/search.pl


To find something just type words you want to find and press SUBMIT button.
For example, "mysql odbc". You should not use quotes " in query,
it's written here only to divide query from other text. UdmSearch
will find all documents that contain word "mysql" or word "odbc". Best
documents will be displayed first.


Search parameters
-----------------
UdmSearch frontends support the following parameters given in CGI query 
string. You may use them in HTML form on search page.

q	text parameter with search query
ps	page size, number of search results displayed on one page,
	20 by default, 100 maximum.
np	page number, 0 by default (first page)
m	search mode. Currently "all" and "any" values are supported.
o	search result type. 0 by default. You may describe several template 
	sections for every part, for example "res". This allows to choose
	for example "Long" or "Short" search result output types.
t	tag limit. Limits search through only documents with given tag.
	This parameter has the same effect with -t indexer option
ul	URL limit, URL substring to limit search through subsection
	of database. It supports SQL % and _  LIKE wildcards. 
	This parameter has the same effect with -u indexer option.
	By default search.cgi inserts % signs before and after "ul" value.
	It allows to write URL substring in HTML from to limit search,
	for example <OPTION VALUE="/manual/"> instead of VALUE="%/manual/%".
	You may specify --disable-auto-wildcard to configure script
	at installation time to disallow automatic addition of % signs.

	Disabling automatic addition sometimes allow to make search faster.
	For example, specifying whole begining of URL
	<OPTION VALUE="http://www.somewhere.com/manual/%"> allows most 
	of SQL servers to use indexes when executing the query with given 
	value in LIKE expression.


Advanced search with PHP
------------------------
If you want more advanced results and use PHP you can use query language. 
search.cgi does not have advanced search yet. It is on TODO list.
PHP frontends are currently inmplemented for MySQL, PostgreSQL and Oracle 
databases.

search.php3 understands next commands:

& - logical AND.
For example, "mysql & odbc". UdmSearch will find any URLs that 
contain both "mysql" and "odbc".

| - logical OR. For example "mysql|odbc". It's just the same that "mysql odbc".
Space " " is equal for "|". UdmSearch will find any URLs, that contain
word "mysql" or word "odbc".

~ - logical NOT. For example "mysql & ~odbc". 
UdmSearch will find urls that contain word "mysql" and do not contain
word "odbc" at the same time. Note that ~ just excludes word from result.
Query "~odbc" will find nothing! UdmSearch compose WHERE condition in
mysql query using all of the words in search query (to make search very quick):
.... WHERE word in ('all','of','the','words','have','been','typed')

() - group command to compose more complex queries.
For example "(mysql | msql) & ~postgres".
Query language is simple (and powerful). 
Just consider query as common logical expression.

