
wafeperl.tar.gz contains the necessary code to link Wafe 0.96
together with perl 4.036. It allows to build a version of
perl that has a few additional commands that allow to build
Xt based applications directly from perl. 

The wafeperl kit can be used to build either an Athena Widget based
version (wafeperl) or an OSF/Motif based version (mofeperl).

Wafe was originally developed to provide graphical user frontends 
for programs in arbitrary programming languages. When Wafe is
used as a frontend, it executes as a separate process (coprocess)
linked via sockets to an application program. In the wafe dostribution
(wafe-0.96.tar.gz) there are various examples how to use Wafe together
with perl. The applications ranges from various monitoring programs to
newsreader, mailer and ftp clients. The distributed Wafe applications
can show how to run an perl application as a subprocess of Wafe or Wafe 
as a subprocess of perl. This kit offers a third possiblilty to use
Wafe together with perl by building an extended version of Perl, in 
which wafe functions can be called as use subprograms of perl and
perl functions can be called from wafe vice versa.

So far, i've made no attempt to check, which kind of modifications
are necessary in the mentioned wafe applications in order to
run them with perlwafe.

Installation:

Prerequesits: 
	perl 4.036 (source)
	Wafe 0.96   
	wafeperl-0.1.tar.gz

Wafe 0.96 can be obtained for example from 

	ftp.wu-wien.ac.at:pub/src/X11/wafe/wafe-0.96.tar.gz

Step 1: Build Wafe as indicated in the Wafe distribution
Step 2: Build perl (we will need the .o files in the next step)
Step 3: expand wafeperl-0.1.tar.gz in the source tree
        of perl 4.036 such you get an directroy structur like

        .../perl-4.036/lib/...
        .../perl-4.036/usub/...
        .../perl-4.036/wafeperl/...

Step 4: cd to .../perl-4.036/wafeperl
        edit the Makefile to adjust library paths etc.
        LIBS and MLIBS should reflect the library paths and 
        libraries of your .../wafe/src/Makefile.
Step 5: make

Note: 
if you want to build wafeperl AND mofeperl (say: first wafeperl
and the mofeperl, then you have to cd to the wafe sources after
building wafeperl, reconfigure the Imakefile to use Motif, 
do an xmkmf;make clean_version;make, before you switch back to
the wafeperl directroy to "make mofeperl". i should really provide
are libwafe.a and a libmofe.a to simpleify this task.

Have fun
-gustaf
