This file contains installation information for several Sather libraries:

Xlib	- an Xlib interface (low level routines)
Xrm	- an experimental Xrm interface (resource manager)
Xt	- an experimental Xt interface (X toolkit)
Xaw	- an experimental 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/04/27.



INSTALLING:

Some of the libraries use C code as a system interface.  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 *.c
	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

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

-home /home/user/Sather /home/user/Sather/Library/Library.module

then you should instead set it to

-home /home/user/Sather /home/user/Sather/Contrib/schnetter/schnetter.module /home/user/Sather/Library/base.commands

The order of the '.../schnetter.module' must come before the
'.../Library/module'.



Having done this, you can compile your programs 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
