
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


Release Procedure (for Release Manager(s) ONLY!)
========================================================================

ptkdb release procedure.

example release: v1_1092

* cvs tag ... v1_1092 -> 1.1092
* cvs export ver v1_1092 in target folder Devel-ptkdb-1.1092
* create an archive Devel-ptkdb-1.1092.tar.gz
* upload the tarball to shell account at sf.net
* upload to upload.sf.net from your shell account at sf.net
* add news release to ptkdb package
* choose your file from the listed of uploaded files
* add news



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