
The distribution consisists of the following packages:

	(a)  tcl 6.4 (John Ousterhout: extensible tcl shell)
	(b)  dbug (Fred Fish: debug library):  optional
	(c)  xpm3.2 (Arnaud Le Hors: pixmap library)
	(d)  plotter (Peter Klingebiel et.al.: plotter widget set)
	(e)  src (ours: wafe - user front end using athena widgets)
	(f)  apps (ours: sample application programs)

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


HOW TO BUILD WAFE:

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

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

	   Steps (a)-(d) can be done in parallel.

	-  bulding (a): tcl 6.4

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

		you might have to delete the declaration of
		open() in tclUnix.h. On AIX you will have to
		replace 
			set strtol=`grep strtol tmp.libc | grep -c "$pattern"`
			if ( $strtol > 1 ) set strtol=1
		by 
			set strtol=1
                in config around line 96.


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


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

	-  bulding (d): plotter widget
			cd $WAFE/plotter/At

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

			xmkmf
			make

                The full distribution of the plotter widget set can be
		obtained from

			ftp.wu-wien.ac.at:pub/src/X11/plotter.v60.README
			ftp.wu-wien.ac.at:pub/src/X11/plotter.v60.tar.Z
			ftp.wu-wien.ac.at:pub/src/X11/plotter.v6b.doc.tar.Z
			ftp.wu-wien.ac.at:pub/src/X11/plotter.v6b.afm.tar.Z

	- building (e): wafe src

			cd $WAFE/src

		Before issuing xmkmf you might want to modify
		some settings in the Imakefile. The distributed
                Imakefile ist set up to use the plotter widgets and 
                Xaw3d (Athena Widgets with 3d-effects). The source
                of the tested Xaw3d library can be ftped from 

			ftp.wu-wien.ac.at:pub/src/X11/Xaw3d-0.1.tar.Z

		When you are finished with your setup, issue the following 
		commands:

			xmkmf
			make
			strip wafe
			make install

	- building (f): 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!



    DIRECTORY STRUCTURE

            .../wafe
                    README
                    COPYRIGHT
                    INSTALLATION
                    src/
                            genc
                            wafe.c
                            Imakefile
                            wafe.man
                            wafedoc.tex
                            ...
                    apps/
                            Imakefile
                            wafe.config
                            wafeapp.man
                            hardcopy/
                                    ...
                            mail/
                                    Imakefile
                                    ...
                            mail/
                                    Imakefile
                                    ...
                            news/
                                    Imakefile
                                    ...
                            ftp/
                                    Imakefile
                                    ...
                            monitoring/
                            ...
                    xpm-3.2/
                            ...
                    tcl-6.4/
                            ...
                    dbug/
                            ...

