INSTRUCTIONS FOR INSTALLING THE SPATBIB PACKAGE ON THE WEB

To install the bibliography (or a subset) on your WWW server, you can
take the following steps. The filters will also work directly under
UNIX. Requires PERL 4. The current distribution (ver 3.1) is running
about 4Mb. You will need to ask your sys-ad to install one file in the
cgi-bin directory.

0) Pls pick up these two files from

ftp.cs.albany.edu/pub/amit/bib:
	

bib.tar.gz:	962382 Oct 17 12:46 
	all the search filters for local use, and also the bibexec.pl
	cgi-bin script.
www.tar.gz:	348770 Oct 17 12:46 
	the web searcher search.html etc. You won't need this to
	install the bib locally.

Then go to your directory where you want to install the WWW search file
search.html. In my system, this is the directory ~amit/. Let's call
this directory the "BASE". Move the www.tar.gz file to BASE. 

1) un-tar the www.tar file first. This will create a bib subdirectory.

2) move the bib.tar.gz to the BASE/bib subdirectory. Un-tar it there.
	This will create a BASE/bib/bin directory.

3) In the BASE/bib/bin directory:
	make all the files here executable
	move the file bibexec.pl to the cgi-bin directory. 
		(this is a newer bibexec.pl). 

4) go to the BASE/bib directory and execute bin/initial_setup. This is
	a shell script that will fix the paths in the filters, create
	a keywords file called keywords.freq, Do the test at the end.

5) go to the BASE directory. There will be two files there:
search.html, AND searchmirr.html. YOU NEED the file searchmirr.html. 
Execute these commands:
	mv search.html search0.html
	mv searchmirr.html search.html
FYI, the mirror file is formed from the search.html file by the command
	"make searchmirr.html"

6) Let's say BASE is ~user/spatbib. Then you need to edit search.html 
to replace the string
	VALUE="~amit
with the string
	VALUE="~user/spatbib
If you are getting "file not found" messages, this may be the problem.  
Make sure you don't change the other ~amit full URLs, which need to stay.
The rest of the pointers work with default paths referenced to the
BASE directory, and need no change.

VOILA!! You should have a working bib site!!! Total space is actually
well under 4Mb. As the test at the end of step 4 shows, you can also
run it from the command line locally, which is probably quicker.

You may wish to use the small file "bib.tst" to test the web server;
uncomment the lines in search.html and save it as test.html to do this.

In case of any probs, let me know!

--
Amitabha Mukerjee                         
e-mail: amit@cs.albany.edu         WWW: http://www.cs.albany.edu/~amit

--------
HISTORY: ver 3.0 Oct 5
        -rw-r--r--  1 amit       948389 Oct  5 09:11 bib.tar.gz
        -rw-r--r--  1 amit       154592 Oct  5 08:36 www.tar.gz

These instructions supersede any contradicting information in the file
ftp.README.