1TKPP(1) User Contributed Perl Documentation TKPP(1)
2
3
4
6 tkpp - frontend to pp written in Perl/Tk
7
9 tkpp
10
12 Tkpp is a GUI frontend to pp, which can turn perl scripts into stand-
13 alone PAR files, perl scripts or executables.
14
15 Below is a short explanation of all available screen elements; it is
16 also displayed from the "Help" - "Help Contents" menu item.
17
18 Source file
19 The file you want to pack.
20
21 Output file (--output, --par, --perlscript)
22 The file you want the source file packed as. This option recognizes
23 the ".par", ".pl" and executable extensions, and supplies the
24 corresponding build option automatically.
25
26 Use icon (--icon)
27 The icon file you want your output file to use. This option will only
28 work when building Microsoft Windows ".exe" files. Currently, this
29 option only accepts ".ico" files.
30
31 Add modules/files (--add)
32 Add the specified items into the package, along with their
33 dependencies. Multiple items should be seperated by a comma (",") or
34 semicolon (";").
35
36 Exclude modules (--exclude)
37 Exclude the given module from the dependency search path and from the
38 package. Multiple modules should be seperated by a comma (",") or
39 semicolon (";").
40
41 Scan dependencies (--compile, --execute, --noscan)
42 Specify the dependency scanning method to use. See pp for explanations
43 of the options.
44
45 GUI (--gui)
46 Build an executable that does not have a console window. This option
47 is only applicable on Microsoft Windows, and is ignored when the output
48 file is a ".par" file.
49
50 Log (--log)
51 Log the output of packaging to a file. The log file, tkpp.log, will be
52 written in the user's home directory.
53
54 Verbose (--verbose)
55 Increase verbosity of output; from 1 to 3, 3 being the most verbose.
56 This option is ignored if logging is not enabled.
57
58 Build
59 Starts building the package.
60
61 File Menu->Preferences
62 Specify the location to perl and pp. They must be set before Tkpp will
63 build anything. The Tkpp configuration file, .tkpprc, is stored in the
64 user's home directory.
65
67 I write code for a living not literature, so any misspelled words in
68 any comments or anything, whoops ;)
69
71 pp, PAR
72
74 Tkpp was written by Doug Gruber. In the event this application breaks,
75 you get both pieces ;)
76
78 Copyright 2003, 2004, 2005, 2006 by Doug Gruber <doug(a)dougthug.com>,
79 Audrey Tang <cpan@audreyt.org>.
80
81 Neither this program nor the associated pp program impose any licensing
82 restrictions on files generated by their execution, in accordance with
83 the 8th article of the Artistic License:
84
85 "Aggregation of this Package with a commercial distribution is
86 always permitted provided that the use of this Package is embedded;
87 that is, when no overt attempt is made to make this Package's
88 interfaces visible to the end user of the commercial distribution.
89 Such use shall not be construed as a distribution of this Package."
90
91 Therefore, you are absolutely free to place any license on the
92 resulting executable, as long as the packed 3rd-party libraries are
93 also available under the Artistic License.
94
95 This program is free software; you can redistribute it and/or modify it
96 under the same terms as Perl itself.
97
98 See <http://www.perl.com/perl/misc/Artistic.html>
99
100
101
102perl v5.12.3 2006-04-27 TKPP(1)