Veritools Inc.
459 Hamilton Ave. #200
Palo Alto, CA 94301
Tel: 650-462-5590
E-mail: support@veritools.com


README for perl_Tk_solaris.tar.gz 
How to install (prepared) Perl5 and Perl/Tk for use with Undertow9
(Undertow9 supports perl5.6.1 and Tk800.012)

** How to install Perl5 and Perl/Tk for use with Undertow9 ** 

We have not bundled Perl or Perl/Tk (Tk is the Perl module which
provides the GUI services) with Undertow because of their size.
Instead we have archived the directory /usr/local/lib/perl5 in a file
and placed this file on our web site.  /usr/local/lib/perl5 is the
default installation directory for Perl5.  Perl/Tk resides inside
/usr/local/lib/perl5.

For Solaris the archive is named perl_Tk_solaris.tar.gz
We will have perl_Tk archive for other OS ready to download soon.

First you must download the appropriate file.  If you download it with
Netscape then Netscape will automatically unzip it and leave you with
the file  perl_Tk_solaris.tar. 

You can gunzip the archive with the command:
gunzip perl_Tk_solaris.tar.gz

You must then un-tar the archive with the command:
tar xvf perl_Tk_solaris.tar

This creates the directory perl5/ in the current directory.  If you do
this as root while you are sitting in /usr/local/lib, you are done.  If
you do this somewhere else, you then need to do one of the following in
order to use the perl5 and perl/Tk you have just untarred:

1.  You can move the newly created perl5/ directory into /usr/local/lib
2.  You can make a link to the newly created perl5/ directory from /usr/local/lib
3.  You can add the location of the new perl5/ directory to the environment
    variable PERLLIB.  This will cause perl to search the specified location
    before searching /usr/local/lib/perl5 for modules such as Tk.

Therefore, supposing you have issued the "tar xvf ..." command from a
directory called "/usr99/abcde".

1.  To move the newly untarred perl5/ directory into /usr/local/lib, do
    the following (you will need to be root):

    cd /usr/local/lib
    cp -rp /usr99/abcde/perl5 .

2.  To make a link instead of copying, enter the following (again, as  root):

    cd /usr/local/lib
    ln -s /usr99/abcde/perl5 .

3.  To leave /usr/local/lib/perl5/ alone and point undertow to the newly
    untarred perl5/ directory, set the environment variable PERLLIB by
    entering the following long line before running undertow (as yourself):

setenv PERLLIB  /usr99/abcde/perl5/5.6.1/sun4-solaris:/usr99/abcde/perl5/5.6.1:/usr99/abcde/perl5/site_perl/5.6.1/sun4-solaris

 You are now ready to use perl/Tk and the builder script.

If this is unclear in any way, and/or for fastest response to requests
contact Veritools,Inc. at 650-462-5590

You can also download the original source code for 
perl5.6.1 and Tk800.012 from Veritools' web site.