================================= INSTALL =================================

	*****************************************************************
	*                                                               *
	*                    The xaero Release                          *
	*                                                               *
	*****************************************************************

        This is the free xaero release.

        The current version can be obtained via anonymous ftp from
	ftp.informatik.uni-stuttgart.de (currently 129.69.211.2) in the
	directory /pub/XAERO.

	To compile this release you need:

	     X11R5 (not tested with an earlier version)
             Athena Widget set
             FWF (Free Widget Foundation widget set Version 3.62 or newer) 
             XPM (X PixMap Version 3.2g or newer)
	     Ansi C Compiler (best: gcc Version 2.3.3 or newer)
	   
	There are a few Makefiles adapted to different operating systems.
	First check the Makefile. To use the makefile adapted to your OS
	type 'make -f <name of Makefile (i.e. Makefile.linux)>'. Some
	path-variables will be listed by typing 'make help'. These
	variables should be adapted to your local system. To compile xaero
	type 'make all'. If you want to install xaero (in a global path)
	type 'make install'. See Makefile for further information.


	If you only want to install the binaries, put the 'xaero' file in a
	directory which is listed in your 'path'-variable. Place the
	application default file in directory '/usr/lib/X11/app-defaults'
	(see X manual for detail). If you don't have write permission to
	these directory, you have to add the app-defaults path to the
	XAPPLRESDIR env by typing: 'setenv XAPPLRESDIR <directory where the
	app-def file can be found>'.
	
	Now 'rehash' and start xaero.

	--------------------------------------------------------------------	
	Here is a FAQ:
	        
Q:        I've recently downloaded the xaero package and seem to be having
Q:	some difficulty getting it to run. I keep on getting the following
Q:	message:
Q:		Error: Widget EM_Darstellung3D has zero width and/or height

A:	There are some machines which don't support local application-
A:	defaults. In this case you have to place the app-defaults/XAero
A:	into a system app-defaults directory (for example:/usr/lib/X11/app-defaults,
A:	/usr/local/X11R5/lib/app-defaults). If you don't have write
A:	permission to this directory, you can add the application-file to
A:	your X server resource database via
A:
A:		'xrdb -merge app-defaults/XAero' 
A:
A:	If your system supports the XAPPLRESDIR environment, it probably
A:	does not accept a list of app-defaults Directories. In this case 
A:
A:		'setenv XAPPLRESDIR $HOME/app-defaults'
A:
A:	may work.
	--------------------------------------------------------------------

		Good luck

				Andreas Ziegler



	If you have some problems, suggestions, or bug reports please email
	to

	  aziegler@hermes.informatik.uni-stuttgart.de (Andreas Ziegler)
	  keller@hermes.informatik.uni-stuttgart.de   (Hartmut Keller)
	  stolz@hermes.informatik.uni-stuttgart.de    (Horst Stolz)
	  braunl@informatik.uni-stuttgart.de          (Thomas Braeunl)
