
Introduction
========================================================================

ptkdb is a debugger for Perl that uses the
Perl/Tk user interface.  It features pushbutton controls for run,
step-in, step-out, return, controls for breakpoints, expression
evaluation and package browsing.


Installation
========================================================================

1. Installing Tk:

   In order to use ptkdb you must first install Perl/Tk 8.x

Option #1 Using the CPAN module:

   perl -MCPAN -e "install Tk"

Option #2 Using the Active State PPM Module:

   ppm install Tk
      or
   retrieve the latest Tk archive from CPAN (Tk800.022 as of this writing)

   http://www.perl.com/CPAN/modules/by-category/08_User_Interfaces/Tk/

Option #3 Windows (if previous methods fail for installing Perl/Tk)

   # Extract the Tk archive and compile it with Visual C++:
   perl Makefile.PL
   nmake 

UNIX/Linux
   gunzip Tk800.022.tar.gz
   tar xf Tk800.022.tar
   cd Tk800.022
   perl Makefile.PL
   make
    # This may require su or root permissions
   make install
   nmake install


2. Installing ptkdb

perl Makefile.PL
make
make install

If worse comes to worse you can simply copy the ptkdb.pm file into 
cp ptkdb.pm /usr/local/lib/perl5/5.xxx/Devel/ptkdb.pm

On Windows:

copy ptkdb.pm C:\perl\site\lib\Devel\ptkdb.pm

To Test:

perl -d:ptkdb -e 1


Support
========================================================================

Bug Reporting URL
http://sourceforge.net/tracker/?atid=437609&group_id=43854&func=browse

Feature Requests URL:
http://sourceforge.net/tracker/?atid=437612&group_id=43854&func=browse

Mailing List
http://lists.sourceforge.net/lists/listinfo/ptkdb-user


Credits
========================================================================
Andrew E. Page, aepage@users.sourceforge.net; (c) 1998, 2007
Matthew Persico beta tester



Svetoslav Marinov <svetoslavm at users.sourceforge.net>
Project Admin
