Basic Installation
==================

	There is no installation script at this time, however, installing 
	the library is very easy.  Simply choose a location for the library
	and unzip/untar all the files there.  In order to use the library
	you must now source the file lib.tcl.  There are two ways to do this:
		(1)		Source the library by specifying the full path name 
				For example:
					source /usr/local/lib/tcl/lib.tcl
		(2)		Create a symbolic link in your program's directory and
				then source the symbolic link
				For example:
					Create the symbolic link
					ln -s /usr/local/lib/tcl/lib.tcl /app/tcl/mytclapp/lib.tcl
					
					(A)  Then from source the symbolic link
					source /app/tcl/mytclapp.lib.tcl
					
					(B)  or simply 
					source lib.tcl
					
					(C)  or even better
					source "[file dirname [info script]]/lib.tcl"
	Method 2C is the recommended method, since this allows the ability
	for your script to be completely relocatable.

	Pandora was written to make use of additional "private" libraries.  These
	libraries are generally commercial-private libraries.  For example, a bank
	might have a library of routines for performing banking transactions.  
	Pandora can be made to use this library by creating another directory 
	tree in the lib directory and placing an init.tcl script in the new 
	directory.  So you would then end up with the following files 
	and directories:
		/usr/local/lib/tcl/lib.tcl
		/usr/local/lib/tcl/lib/pandora/
		/usr/local/lib/tcl/lib/pandora/init.tcl
		/usr/local/lib/tcl/lib/bank/
		/usr/local/lib/tcl/lib/bank/init.tcl
	
	In this case, the lib.tcl script, which is located in 
	/usr/local/lib/tcl/lib.tcl will include the pandora library, and then 
	will include the bank/init.tcl script.  The bank/init.tcl script is 
	responsible for included any other files.  Examples of how to do this 
	can be taken from the Pandora library.  The recommended method is to 
	keep the files/scripts/directory structures the same as in the 
	Pandora library.
	
