	This fileset contains the VMSIndex search engine, originally developed
for use with the VMS Gopher Server, and now ported for use with the CERN HTTP
Server and OSU DECthreads HTTP Server.  We support it, and related aspects of
all three infosystem servers, via the VMSGopher-L@trln.lib.unc.edu email list.
(NOTE that none of us has any tolerance for WWW versus Gopher or Unix versus
VMS "religious wars", so be careful what you say should you seek our help!).

	Indexes are created with Build_Index.exe, which is common to all
three servers.  Its use is explained in Build_Index.Doc.  WWWquery.exe does
the searches for the CERN and OSU HTTP server, and query.exe is for the
Gopher server.  Build them by executing Make.com, which will determine
whether you are using VAXC or DECC, and whether or not you have MMS, and
then do the right things.

	For the OSU HTTP server, you also need to use Set_DCL_Env.exe to set
up the CGI environment as DCL symbols.  Build it with Make_Set_DCL_Env.com,
after reading its header.  An EchoDT.com which calls Set_DCL_Env.com is
included in the distribution and can be used, like the CERN server's Echo.com,
for reporting the available DCL symbols when developing scripts or forms.

	Start by reading the headers of VMSIndex.com and HTTP_IndexTree.com,
then the headers of VMSGopherServer.com and of HTTP_IndexDoc.com and
HTTP_IndexUserDoc.com, then study Build_Index.Doc, then read the header of
WWWquery.c.  Some of the HTTP_foo.com index-building scripts for the OSU
DECthreads server have -dt appended to the .com.

	In addition to indexing a set of whole foo.html files, WWWquery.c
and query.c can index single or sets of sectional database files, analogously
to WAIS.  The index built with HTTP_IndexTree.com and search with VMSIndex.com
is a model for sets of whole foo.html files.  The indexes built with
HTTP_IndexDoc.com or HTTP_IndexUserDoc.com and the search with
VMSGopherServer.com is a model for sectional databases.

	Copy VMSIndex.com (and VMSGopherServer.com if you have reason to use
it) to your htbin directory, and set up a foreign command for WWWquery.exe.
(Set_DCL_Env.exe will have been placed in the OSU server's htbin directory
by Make_Set_DCL_Env.com)  Copy SearchWords.html (and EGREP.html if you have
reason to use it) to an appropriate subdirectory of your data tree for access
in conjunction with searches.

	The command file interfaces for building indexes can be executed from
here.

	The VMSIndex distribution now includes the ISINDEX search script,
WWWsearch.com, which can be used as the interface to WWWquery.exe for the
CERN and OSU DECthreads servers.  Read its header for more information.  The
ISINDEX document, indexdemo.html, is included for testing WWWsearch.com
with the index built by HTTP_IndexTree.com.  The script UserSearch.com
is a supplementary interface for handling searches invoked via /~username/
URLs.  Read it's header and that of the HTTP_IndexUser.com example indexing
command file.

	NOTE that any links in ISINDEX cover pages returned via direct calls
to an htbin procedure without a query should have references with absolute
paths (i.e, they should have href="/path/foo.html", not href="foo.html").
Otherwise, clients will fill them in as "/htbin/foo.html" instead of using 
"/path/foo.html".  Partial URL's can be used with ISINDEX documents if the
files are to be sought relative to the ISINDEX document from which the
search is performed.  References in sectional databases for which ranges,
rather than URLs for whole files, will be returned in the hit lists also
should have absolute paths.

				Fote

=========================================================================
 Foteos Macrides           Worcester Foundation for Experimental Biology
 MACRIDES@SCI.WFEB.EDU     222 Maple Avenue, Shrewsbury, MA 01545
=========================================================================
