This file contains installation information for several Sather libraries:

Xlib	- an Xlib interface (low level routines)
Xrm	- an Xrm interface (resource manager)
Xt	- an Xt interface (X toolkit)
Xaw	- and Xaw interface (Athena widget set)
Time	- a timer class
Math	- easier access to mathematical functions.

If you have questions concerning this file or the library, mail to
<schnetter@student.uni-tuebingen.de>.  This text was last updated on
1995/02/08.



INSTALLING:

The classes come in a whole bunch of files, instead of in one file
only.  This accelerates compiling, as normally not all of the files
have to be parsed.  You should copy all these files into one
directory.  In the following I assume that this is the directory
'/home/user/Sather/Contrib/schnetter'.

Some of the libraries use C code, too.  Before you can use it, you
have to compile it.  This is best done via

	cd /home/user/Sather/Contrib/schnetter
	make

This may take some time.  If this fails, or if you don't have a make
utility, you can do it by hand:

	cd /home/user/Sather/Contrib/schnetter/Xlib
	cc -I /home/user/Sather -c -O2 -g *.c
	# you can omit the '-g' above; this saves some space on your disk
	ar rc xlib.a *.o
	# (if you don't have ranlib, then you probably don't need it)
	ranlib xlib.a
	# and to save some space:
	rm *.o

	# Now repeat this for Xrm, Xt, Xaw, and Time.
	# Math does not use C code.



In order to use these libraries, you have to tell the compiler by
adding command files to the call of the compiler, as in

cs program.sa -o program -main PROGRAM \
-com /home/user/Sather/Library/Xlib/xlib.commands

(but in one line!)

This is tedious.  A more convenient way to do so is to add this to
your environment variable SATHER_COMMANDS.  You are setting this
variable probably in your '.profile' or '.cshrc'.  Assuming you set it
to

-home /home/user/Sather -com /home/user/Sather/Library/base.commands

then you should instead set it to

-home /home/user/Sather
-com /home/user/Sather/Contrib/schnetter/Xaw/xaw.commands
-com /home/user/Sather/Contrib/schnetter/Xt/xt.commands
-com /home/user/Sather/Contrib/schnetter/Xrm/xrm.commands
-com /home/user/Sather/Contrib/schnetter/Xlib/xlib.commands
-com /home/user/Sather/Contrib/schnetter/Time/time.commands
-com /home/user/Sather/Contrib/schnetter/Math/math.commands
-com /home/user/Sather/Library/base.commands
-C_flag -w

(again, this should be one line).  The order of the 'X..' files is
important.  The '-C_flag -w' suppresses warnings that may be emitted
by the C compiler.  If your system is set up correctly, you can safely
ignore those warnings.



Having done this, you can compile your programs (as before) with

	cs your_program.sa -o your_program -main YOUR_PROGRAM

and then the library classes are parsed automatically whenever a
program of yours uses them.



-erik
