
The distribution consisists of the following packages:

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

The packages marked with * are optional.  (a) to (e) are prerequesists
of (f) which is a prerequesite of (g).  For many application programs
in (g) you will need perl 4, which you can obtain from every good
archive server (such as ftp.uu.net or wuarchive.wustl.edu).

Before you build Wafe and its componentes, check out which packages
you will need or which packages you can build. In the currnet state,
you can either build a Xaw wafe binary or a OSF/Motif wafe binary
(called mofe). (e) will be only possible when you have OSF/Motif with
include files and libraries installed.

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`
			gunzip < ../wafe-0.96.tar.gz | tar -xvf -

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

	-  bulding (a): tcl 7.0

			cd $WAFE/tcl7.0
			more README
			./configure
			make

		you might have to delete the declaration of
		open() in tclUnix.h. 


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


	-  bulding (c): xpm-library
		
			cd $WAFE/xpm-3.2g
			xmkmf
			make Makefiles
			cd lib
			make

	-  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

                or other sources.

	-  bulding (e): XmGraph Widget

			cd $WAFE/XmGraph

		You will have to edit the Makefile to fill in
		eg. the location of OSF/Motif include files on your site.

			make libgraph.a

	- building (f): 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.6A.tar.Z 

                A patch for Xaw3d, which makes nicer shadows for black
                and white background widgets (which will most likely
                go into the next xaw3d release) can be obtained from

                        ftp.wu-wien.ac.at:pub/src/X11/Xaw3d-0.6.patch

                A patch, which add the resources for time offsets to
                the xaw3d clock, can be found in

                        ftp.wu-wien.ac.at:pub/src/X11/wafe/xaw3d.Clock.patch


		If you are building the OSF/Motif version of Wafe (mofe),
		you will have to edit several parameters in the
		Imakefile. You will have to set
			#define MOTIF11
 		which unsets ATHENA automatically.

		I have build mofe originally on a DECstation 5000/200,
		where i am using X11R5. Since the OSF/Motif libraries
		provided by DEC are based on X11R4, i have to use
		separate X libraries, as well as separate Plotter Widget
		libraries and so on. That's why there are so many 
		MOTIF flags in the Imakefile.

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

			xmkmf
			make
			strip wafe
			make install


	- building (g): wafe apps

			cd $WAFE
			gunzip < wafeapps.tar.gz | 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 version of the documentation 
		(man-pages+handbook) and a copy of our Usenix paper
		can be found in 

			$WAFE/apps/hardcopy/

		you will find additional programs in 

			$WAFE/apps/contrib/

                and small sample scripts for beginners in 
 
			$WAFE/src/tcl/


		If Wafe has on your site troubles to locate bitmap files 
		you might have to add the following link:

			ln -s /usr/include/X11/bitmaps /usr/lib/X11

		For the conversion of .xbm or .xpm files into Pixmap 
		objects Wafe uses since version 0.93 XFILESEARCHPATH 
	        which points per default to /usr/lib/X11/bitmaps. Of 
		course, you can seet also the environment variable 
		XFILESEARCHPATH accordingly. If you do not know, to 
		which path your local XFILESEARCHPATH defaults, try 

			strings /usr/lib/libXt.a | fgrep %N%C%S

		and set the link accordingly.

Good luck!



    DIRECTORY STRUCTURE

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

