The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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 corresponding build option automatically.

Use icon (--icon)

The icon file you want your output file to use. This option will only work with exe files in Windows, par files will just ignore this option. This options will only accept .ico files.

Add modules/files (--add)

Adds the specified items into the package, along with their dependencies. Multiple items should be seperated by a comma (,) or semicolon (;).

Exclude modules (--exclude)

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

GUI (--gui)

Build an executable that does not have a console window. This option is ignored when the output file is a par file.

Log (--log)

Log the output of packaging to a file rather than to stdout. The log file, tkpp.log, will be written in the users home directory.

Verbose (--verbose)

Increase verbosity of output; from 0 to 5, 5 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. The path to perl and pp MUST be set before Tkpp will let you build. The Tkpp configuration file, .tkpprc, is stored in the users 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 by Doug Gruber <doug(a)dougthug.com>, Autrijus Tang <autrijus@autrijus.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 resulting 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