*** WARNING *** THIS IS A PRERELEASE *** WARNING *** THIS IS A PRERELEASE ***

The distribution consisists of the following packages:

	(a)  tcl 6.2 (by John Ousterhout: extensible tcl shell)
	(b)  dbug (by Fred Fish: debug library):  optional
	(c)  xpm3.1 (Arnaud Le Hors: pixmap library)
	(d)  src (ours: wafe - user front end using athena widgets)
	(e)  apps (ours: sample application programs)

(a), (b) and (c) are prerequesists of (d) which is a prerequesite of (e).
(b) and (c) are optional. for many application programs in (e) you
will need perl 4.0, which you can obtain from every good archive
server (such as ftp.uu.net or wuarchive.wustl.edu).


HOW TO MAKE WAFE:

	-  choose a directory where you want to build wafe 
	    and its application programs

			csh
			mkdir wafe
			cd wafe
			setenv WAFE `pwd`
			uncompress < ../wafe.tar.Z | tar -xvf -

	-  bulding (a): tcl 6.2

			cd $WAFE/tcl6.2
			more README
			./config
			make

		under AIX you might have to delete the declaration of
		open in tclUnix.h and to comment the test after 
		"set errlist=1" (line 257 -- 262)
	

	-  bulding (b): dbug-library
		
			cd $WAFE/dbug 
			make lib


	-  bulding (c): xpm-library
		
			cd $WAFE/xpm-3.1
			xmkmf
			make libXpm.a

	- building (e): wafe src

			cd $WAFE/src

		before issuing xmkmf you might want to modify
		some settings in the Imakefile.

			xmkmf
			make
			strip wafe
			make install

	- building (e): wafe apps

			cd $WAFE
			uncompress < wafeapps.tar.Z | tar -xvf -
			cd apps

		you can choose whether you prefer a 'local
		installation' (i.e. in your home directory) or
		a global installation (typically in /usr/bin/X11 and
		/usr/lib/X11). if LOCAL is defined in the Imakefile,
		parms.local are used, otherwise parms.global.
		Modify the appropriate parms.xxxxx file. if the
		WAFELIB parameter is modified, the environment
		variable WAFELIB can still be used to use a wafe 
                library on a nonstandard location.

			xmkmf
			make Makefile
			make Makefiles
			make install

		if you can write to the directory, where your man
		pages are installed you might issue

			make install.man
			rehash

		If everything works, you might try to answer the
		questions in
			
			xwafemc -l english

		provided, you have perl on your system. If you have 
		trouble with fonts etc, read the manpage of
		"wafeapp". To see examples in various languages
		check the directory

			$WAFE/apps/lang/

		A postscript verision of the documentation 
		(man-pages+handbook) can be found in 

			$WAFE/apps/hardcopy/

Good luck!
