tkpp(1)

NAME

       tkpp - frontend to pp written in Perl/Tk

SYNOPSIS

       tkpp

DESCRIPTION

       Tkpp is a GUI frontend to pp, which can turn perl scripts into stand-
       alone PAR files, perl scripts or executables.

       Below is a short explanation of all available screen elements; it is
       also displayed from the "Help" - "Help Contents" menu item.

       Source file

       The file you want to pack.

       Output file (--output, --par, --perlscript)

       The file you want the source file packed as.  This option recognizes
       the ".par", ".pl" and executable extensions, and supplies the corre-
       sponding build option automatically.

       Use icon (--icon)

       The icon file you want your output file to use.  This option will only
       work when building Microsoft Windows ".exe" files.  Currently, this
       option only accepts ".ico" files.

       Add modules/files (--add)

       Add the specified items into the package, along with their dependen-
       cies.  Multiple items should be seperated by a comma (",") or semicolon
       (";").

       Exclude modules (--exclude)

       Exclude the given module from the dependency search path and from the
       package.  Multiple modules should be seperated by a comma (",") or
       semicolon (";").

       Scan dependencies (--compile, --execute, --noscan)

       Specify the dependency scanning method to use.  See pp for explanations
       of the options.

       GUI (--gui)

       Build an executable that does not have a console window.  This option
       is only applicable on Microsoft Windows, and is ignored when the output
       file is a ".par" file.

       Log (--log)

       Log the output of packaging to a file.  The log file, tkpp.log, will be
       written in the user's home directory.

       Verbose (--verbose)

       Increase verbosity of output; from 1 to 3, 3 being the most verbose.
       This option is ignored if logging is not enabled.

       Build

       Starts building the package.

       File Menu->Preferences

       Specify the location to perl and pp.  They must be set before Tkpp will
       build anything.  The Tkpp configuration file, .tkpprc, is stored in the
       user's home directory.

NOTES

       I write code for a living not literature, so any misspelled words in
       any comments or anything, whoops ;)

SEE ALSO

       pp, PAR

AUTHORS

       Tkpp was written by Doug Gruber.  In the event this application breaks,
       you get both pieces ;)

COPYRIGHT

       Copyright 2003, 2004, 2005, 2006 by Doug Gruber <doug(a)dougthug.com>,
       Audrey Tang <cpan@audreyt.org>.

       Neither this program nor the associated pp program impose any licensing
       restrictions on files generated by their execution, in accordance with
       the 8th article of the Artistic License:

           "Aggregation of this Package with a commercial distribution is
           always permitted provided that the use of this Package is embedded;
           that is, when no overt attempt is made to make this Package's
           interfaces visible to the end user of the commercial distribution.
           Such use shall not be construed as a distribution of this Package."

       Therefore, you are absolutely free to place any license on the result-
       ing executable, as long as the packed 3rd-party libraries are also
       available under the Artistic License.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.8.8                       2006-05-30                           TKPP(1)