This is a GUI to the Perl debugger.  It has been tested with Tk800.003 and
Tk800.005 under Solaris 2.5 and Linux 2.0.  The GUI actually runs in a
separate process from the debugger itself.  The debugger is the Perl debugger
hacked a bit to use the IPC::Open2 module to talk to the GUI.  This means that
this program will probably only work on Unix like systems.

To install it, first uncompress it:
    tar zxf PerlDBGUI-DR-1.tar.gz
or whatever you do.  Then go into the newly created directory PerlDBGUI-DR-1
and do one of the following.

Either the usual:
    perl Makefile.PL
    make install
The perl Makefile.PL takes all the usual ExtUtils::MakeMaker arguments.

Or, you could just copy perl5dbgui.pl to some convenient place (it doesn't
matter where, since it isn't compiled via the usual module stuff).  Then just
copy perldbgui somewhere on your search path and fix the #! line if needed.

To run it, you need to set the environment variable PERL5DB to:
BEGIN { require "<libinstall>/perl5db.pl" }
where <libinstall> is the place you installed the perl5db.pl file.  Also,
perldbgui needs to be on your path.  To return controller to the regular
perl debugger, unset the PERL5DB environment variable.

This software is pre-alpha.  It may be usable as is, but it hasn't been tested
very much.  I am releasing it so that you may either:
- test it.  Please let me know if you get it to work on any platform other than
Solaris or Linux, or any bugs you find.
- or help with the development of it.  See the TODO list for a list of stuff that
I have thought of or fix any bugs you find.  Please email me if you would like to work
on this, and I'll coordinate the various activities.

Copyright (c) 1998 Curt McKelvey. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

- Curt McKelvey
  CurtMcKelvey@lycosmail.com