Title	Greenstone digital library software

Purpose	A suite of digital library software which includes the ability to
	serve digital library collections and build new collections

Author	New Zealand Digital Library Project

License GNU General Public Licence (Version 2)
	Full terms and conditions are in the file "COPYING" on this CD-ROM

Date	February 2001

Version 2.31

Documentation
	Install.pdf	Greenstone Digital Library Installer's Guide
	User.pdf	Greenstone Digital Library User's Guide
	Developer.pdf	Greenstone Digital Library Developer's Guide

Platform
	Unix and Windows.  Binaries and source code are included.

	The Greenstone user interface uses a Web browser capable of Javascript,
	Tables, and Frames.  Browsers that meet these requirements include:

		Netscape Navigator 4.0
		Internet Explorer 4.0
		Mozilla

	More recent versions of these browsers should also work.

Unix	Source code has been compiled and tested on Linux and Solaris.
	Binary code requires an Intel x86-based Linux distribution which
	includes ELF binary support and supports the GNU C library (glibc 2.0
	or greater).  Distributions that meet these requirements include:

		RedHat 5.1
		SuSE Linux 6.1
		Debian 2.1
		Slackware 4.0

	More recent versions of these distributions should also work.

Windows Source code has been compiled with Microsoft Visual C++ 6.0 or greater
	Binary code has been tested on Windows 3.1, 95/98, NT, 2000
	Restriction:
		The building process requires PERL, and so collections cannot
		be built under Windows 3.1

Install Install.pdf describes the complete installation procedure for both Unix
	and Windows, and includes tutorial information about configuring
	Greenstone and configuring the Apache Web Server appropriately.

	Self-explanatory install scripts are provided for both Unix and
	Windows, which take you step by step through the installation procedure
	and provide appropriate options at each stage.

		Windows installation:	execute Windows\Install.exe
		Unix installation:	execute Unix/Install.sh

	Uninstall scripts are provided which clean up should installation fail.

Support	Please report any problems installing or running the Greenstone Digital
	Library Software using the bug report form provided as Support.htm in
	the top level directory of this CD-ROM.

	There is a Greenstone mailing list that you can join by sending email
	to majordomo@colosys.net with "subscribe greenstone" as the body of the
	message.

Contents of this CD-ROM

	README.TXT  This document

	COPYING	    Gives the conditions under which this software can be
		    copied

	Support.htm Form for reporting problems installing or running
		    Greenstone 

	docs	    Documentation, including the following:

			Install.pdf	Installer's Guide
					Describes the installation procedure
					for both Unix and Windows, and includes
					tutorial information about configuring
					Greenstone and the Apache Web Server.

			User.pdf	User's Guide
					Provides a comprehensive description of
					how to use the Greenstone software for
					accessing and building collections.

			Developer.pdf	Developer's Guide 
					This manual describes how Greenstone
					works.  It is aimed at those who wish
					to customize collections and to develop
					and maintain the software.

	Unix	    Unix version, including Linux binaries

		    The top-level files and directories are:

			Install.sh	Unix installation shell script (if run
					on Linux, includes option to install
					binaries; otherwise installs source) 
			bin		Linux binaries

	Windows     Windows installation procedure and binaries

		    The top-level files and directories are:

			Install.exe	Windows self-install program (includes
					option to install binaries or source) 
			bin		Windows binaries

	gsdl	    Greenstone digital library software directory structure.
		    This mirrors the Greenstone digital library directory
		    structure that will be installed.

			bin	        Executable code
			cgi-bin		CGI scripts
			collect		Greenstone collections
					(includes Demo collection, pre-built)
			etc	        Configuration files, logs, etc
			images		Images used by interface
			macros		Display macros
			perllib		Perl modules used when building
			mappings	Unicode translation tables

		    The installation procedure installs files into some of
		    these directories as follows:

		  	top level	Batch file or shell script
			bin	        Executable code
			cgi-bin		CGI scripts
			collect		The Greenstone Demo collection
					Additional collections as specified at
					install time
			src, lib, packages
			      		Source code if specified at install
			  		time 

	collect     Greenstone collections (prebuilt)
		    
			chinese		Chinese demo
			fnl		Food and Nutrition Library
			folktale	Language extraction demo
			gsarch		Greenstone archives
			wordpdf		MSWord and PDF demo

	collect/dlpeople		Assorted Web pages (to test the
					collection-building process)

	src         Program source files

			Windows		Configuration information for Windows
			Unix		Configuration information for Unix
			lib		C++ library code
			packages	C++ source code for packages used by
					Greenstone 
			src		C++ source code

