r4611 - in /packages/libpar-perl/branches/upstream/current: ./
contrib/ inc/Module/Install/ lib/ lib/App/ lib/PAR/ lib/PAR/Filter/
lib/PAR/StrippedPARL/ myldr/ script/ t/
eloy at users.alioth.debian.org
eloy at users.alioth.debian.org
Fri Dec 8 14:13:03 CET 2006
Author: eloy
Date: Fri Dec 8 14:13:02 2006
New Revision: 4611
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=4611
Log:
Load /tmp/tmp.wJeSyP4045/libpar-perl-0.970 into
packages/libpar-perl/branches/upstream/current.
Removed:
packages/libpar-perl/branches/upstream/current/MANIFEST.SKIP
packages/libpar-perl/branches/upstream/current/contrib/
packages/libpar-perl/branches/upstream/current/inc/Module/Install/PAR.pm
packages/libpar-perl/branches/upstream/current/lib/App/
packages/libpar-perl/branches/upstream/current/lib/PAR/Filter/
packages/libpar-perl/branches/upstream/current/lib/PAR/Filter.pm
packages/libpar-perl/branches/upstream/current/lib/PAR/Packer.pm
packages/libpar-perl/branches/upstream/current/lib/PAR/StrippedPARL/
packages/libpar-perl/branches/upstream/current/myldr/
packages/libpar-perl/branches/upstream/current/script/
packages/libpar-perl/branches/upstream/current/t/10-parl-generation.t
packages/libpar-perl/branches/upstream/current/t/20-pp.t
packages/libpar-perl/branches/upstream/current/t/30-current_exec.t
packages/libpar-perl/branches/upstream/current/t/test-proc
Modified:
packages/libpar-perl/branches/upstream/current/AUTHORS
packages/libpar-perl/branches/upstream/current/ChangeLog
packages/libpar-perl/branches/upstream/current/MANIFEST
packages/libpar-perl/branches/upstream/current/META.yml
packages/libpar-perl/branches/upstream/current/Makefile.PL
packages/libpar-perl/branches/upstream/current/README
packages/libpar-perl/branches/upstream/current/SIGNATURE
packages/libpar-perl/branches/upstream/current/lib/PAR.pm
packages/libpar-perl/branches/upstream/current/lib/PAR/Environment.pod
Modified: packages/libpar-perl/branches/upstream/current/AUTHORS
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/AUTHORS?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/AUTHORS (original)
+++ packages/libpar-perl/branches/upstream/current/AUTHORS Fri Dec 8 14:13:02 2006
@@ -117,8 +117,9 @@
Simon Cozens (SIMON)
Sisyphus
Steffen Mueller (SMUELLER)
+Stephen Pick
Steve Hay (SHAY)
-Stephen Pick
+Steven Mackenzie
Thomas Loo (TLOO)
Thomas Rush
Tim Conrow
Modified: packages/libpar-perl/branches/upstream/current/ChangeLog
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/ChangeLog?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/ChangeLog (original)
+++ packages/libpar-perl/branches/upstream/current/ChangeLog Fri Dec 8 14:13:02 2006
@@ -1,3 +1,21 @@
+
+[Changes for 0.970 - Dec 3, 2006]
+* This release introduces some rather radical changes, so read carefully:
+* All PAR::Packer related logic has been moved to a separate distribution,
+ PAR-Packer. This includes pp, parl and all packaging tools. This way,
+ PAR becomes a pure-Perl distribution that can be most easily installed by
+ users of software which requires PAR.
+ Developers who want to use the PAR packager, pp, need to install the
+ PAR-Packer distribution from CPAN.
+
+[Changes for 0.961 - Nov 23, 2006]
+* Bug fixes, etc.
+ - PAR::StrippedPARL::Base->write_parl() failed to work if the @INC
+ directories contained spaces in 0.960. (Steven Mackenzie)
+ - Much improved documentation of the environment variables
+ (Glenn Linderman)
+ - Fix for a spaces-in-pathname problem on Windows for
+ t/30-current_exec.t. (Malcolm Nooning)
[Changes for 0.960 - Nov 21, 2006]
* Bug fixes, etc.
Modified: packages/libpar-perl/branches/upstream/current/MANIFEST
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/MANIFEST?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/MANIFEST (original)
+++ packages/libpar-perl/branches/upstream/current/MANIFEST Fri Dec 8 14:13:02 2006
@@ -1,21 +1,5 @@
AUTHORS
ChangeLog
-contrib/automated_pp_test/automated_pp_test.pl
-contrib/automated_pp_test/hello_tk.pl
-contrib/automated_pp_test/hi.ico
-contrib/automated_pp_test/pipe_a_command.pm
-contrib/automated_pp_test/prior_to_test.pm
-contrib/automated_pp_test/remove_file_and_try_executable_again.pm
-contrib/automated_pp_test/test_in_further_subdir.pm
-contrib/docs/where_is_it.txt
-contrib/docs/who_am_i.txt
-contrib/gui_pp/gpp
-contrib/gui_pp/gpp_readme.txt
-contrib/pare/pare
-contrib/pare/pare_readme.txt
-contrib/procedural_pp/pp_old
-contrib/stdio/Stdio.pm
-contrib/stdio/Stdio_readme.txt
inc/Module/AutoInstall.pm
inc/Module/Install.pm
inc/Module/Install/AutoInstall.pm
@@ -25,61 +9,24 @@
inc/Module/Install/Include.pm
inc/Module/Install/Makefile.pm
inc/Module/Install/Metadata.pm
-inc/Module/Install/PAR.pm
inc/Module/Install/Win32.pm
inc/Module/Install/WriteAll.pm
inc/Test/Builder.pm
inc/Test/Builder/Module.pm
inc/Test/More.pm
-lib/App/Packer/PAR.pm
lib/PAR.pm
lib/PAR/Environment.pod
lib/PAR/FAQ.pod
-lib/PAR/Filter.pm
-lib/PAR/Filter/Bleach.pm
-lib/PAR/Filter/Bytecode.pm
-lib/PAR/Filter/Obfuscate.pm
-lib/PAR/Filter/PatchContent.pm
-lib/PAR/Filter/PodStrip.pm
lib/PAR/Heavy.pm
-lib/PAR/Packer.pm
-lib/PAR/StrippedPARL/Base.pm
-lib/PAR/StrippedPARL/Dynamic.pm
-lib/PAR/StrippedPARL/Static.pm
lib/PAR/Tutorial.pod
Makefile.PL
MANIFEST This list of files
-MANIFEST.SKIP
META.yml
-myldr/encode_append.pl
-myldr/env.c
-myldr/file2c.pl
-myldr/usernamefrompwuid.c
-myldr/internals.c
-myldr/main.c
-myldr/Makefile.PL
-myldr/mktmpdir.c
-myldr/mktmpdir.h
-myldr/parlsig.pl
-myldr/sha1.c.PL
-myldr/static.c
-myldr/utils.c
-myldr/win32.coff
-myldr/win32.obj
-myldr/win32.res
README
-script/par.pl
-script/parl.pod
-script/pp
-script/tkpp
SIGNATURE
t/00-pod.t
t/01-basic.t
-t/10-parl-generation.t
-t/20-pp.t
-t/30-current_exec.t
t/40-par-hashref.t
t/hello.par
t/Hello.pm
-t/test-proc
TODO
Modified: packages/libpar-perl/branches/upstream/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/META.yml?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/META.yml (original)
+++ packages/libpar-perl/branches/upstream/current/META.yml Fri Dec 8 14:13:02 2006
@@ -10,48 +10,18 @@
- inc
- t
provides:
- App::Packer::PAR:
- file: lib/App/Packer/PAR.pm
- version: 0.91
PAR:
file: lib/PAR.pm
- version: 0.960
- PAR::Filter:
- file: lib/PAR/Filter.pm
- version: 0.02
- PAR::Filter::Bleach:
- file: lib/PAR/Filter/Bleach.pm
- PAR::Filter::Bytecode:
- file: lib/PAR/Filter/Bytecode.pm
- PAR::Filter::Obfuscate:
- file: lib/PAR/Filter/Obfuscate.pm
- PAR::Filter::PatchContent:
- file: lib/PAR/Filter/PatchContent.pm
- PAR::Filter::PodStrip:
- file: lib/PAR/Filter/PodStrip.pm
+ version: 0.970
PAR::Heavy:
file: lib/PAR/Heavy.pm
version: 0.09
- PAR::Packer:
- file: lib/PAR/Packer.pm
- version: 0.17
- PAR::StrippedPARL::Base:
- file: lib/PAR/StrippedPARL/Base.pm
- version: 0.958
- PAR::StrippedPARL::Dynamic:
- file: lib/PAR/StrippedPARL/Dynamic.pm
- version: 0.958
- PAR::StrippedPARL::Static:
- file: lib/PAR/StrippedPARL/Static.pm
- version: 0.958
recommends:
Digest: Module::Signature
requires:
Archive::Zip: 1
Compress::Zlib: 1.3
File::Temp: 0.05
- Getopt::ArgvFile: 1.07
- Module::ScanDeps: 0.69
PAR::Dist: 0.21
perl: 5.6.0
-version: 0.960
+version: 0.970
Modified: packages/libpar-perl/branches/upstream/current/Makefile.PL
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/Makefile.PL?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/Makefile.PL (original)
+++ packages/libpar-perl/branches/upstream/current/Makefile.PL Fri Dec 8 14:13:02 2006
@@ -10,16 +10,7 @@
requires 'File::Temp' => 0.05;
requires 'Compress::Zlib' => ($^O eq 'MSWin32') ? 1.16 : 1.30;
requires 'Archive::Zip' => 1.00;
-requires 'Module::ScanDeps' => 0.69;
requires 'PAR::Dist' => 0.21;
-requires 'Getopt::ArgvFile' => 1.07;
-
-if ($^O eq 'MSWin32') {
- feature 'Windows --icon and --info support',
- recommends
- 'Parse::Binary' => 0.04,
- 'Win32::Exe' => 0.04;
-}
if (can_use('Crypt::OpenPGP') or can_run('gpg')) {
my $has_sha1 = (
@@ -41,102 +32,4 @@
auto_install_now -default => 0;
auto_provides;
-par_base 'SMUELLER';
-
-par_prehook();
WriteAll sign => 1;
-par_posthook();
-
-my %no_parl = ();
-
-use strict; use warnings;
-sub par_prehook {
- my $bork = $no_parl{$^O};
- my $cc;
- $cc = can_cc unless $bork;
- my $par;
- $par = fetch_par('', '', !$cc) unless ($cc or $bork);
- my $exe = $Config::Config{_exe};
- my $dynperl = $Config::Config{useshrplib} && ($Config::Config{useshrplib} ne 'false');
-
- if ($bork) {
- warn "Binary loading known to fail on $^O; won't generate 'script/parl$exe'!\n";
- }
- elsif (!$par and !$cc) {
- warn "No compiler found, won't generate 'script/parl$exe'!\n";
- }
-
- # XXX: this branch is currently not entered
- if ($cc and $par) {
- my $answer = prompt(
- "*** Pre-built PAR package found. Use it instead of recompiling [y/N]?"
- );
- if ($answer !~ /^[Yy]/) {
- load('preamble')->{preamble} = '';
- $par = '';
- }
- }
-
- my @bin = ("script/parl$exe", "myldr/par$exe");
- push @bin, ("script/parldyn$exe", "myldr/static$exe") if $dynperl;
-
- $FindBin::Bin = '.' unless -e "$FindBin::Bin/Makefile.PL";
- my $par_exe = "$FindBin::Bin/$bin[1]";
-
- if ($par) {
- open my $fh, '>', $par_exe or die "Cannot write to $par_exe";
- close $fh;
- }
- elsif (-f $par_exe and not -s $par_exe) {
- unlink $par_exe;
- }
-
- clean_files(@bin) if $par or $cc;
-
- makemaker_args(
- MAN1PODS => {
- 'script/par.pl' => 'blib/man1/par.pl.1',
- 'script/pp' => 'blib/man1/pp.1',
- 'script/tkpp' => 'blib/man1/tkpp.1',
- ($par or $cc) ? (
- 'script/parl.pod' => 'blib/man1/parl.1',
- ) : (),
- },
- EXE_FILES => [
- 'script/par.pl',
- 'script/pp',
- 'script/tkpp',
- (!$par and $cc) ? (
- "script/parl$exe",
- $dynperl ? (
- "script/parldyn$exe",
- ) : (),
- ) : (),
- ],
- DIR => [
- (!$par and $cc) ? (
- 'myldr'
- ) : (),
- ],
- NEEDS_LINKING => 1,
- );
-}
-
-sub par_posthook {
- my $exe = $Config::Config{_exe};
- return unless $exe eq '.exe';
-
- open my $in, '<', "$FindBin::Bin/Makefile" or return;
- open my $out, '>', "$FindBin::Bin/Makefile.new" or return;
- while (<$in>) {
- next if /^\t\$\(FIXIN\) .*\Q$exe\E$/;
- next if /^\@\[$/ or /^\]$/;
- print $out $_;
- }
- close $out;
- close $in;
- unlink "$FindBin::Bin/Makefile";
- rename "$FindBin::Bin/Makefile.new" => "$FindBin::Bin/Makefile";
-}
-
-1;
Modified: packages/libpar-perl/branches/upstream/current/README
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/README?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/README (original)
+++ packages/libpar-perl/branches/upstream/current/README Fri Dec 8 14:13:02 2006
@@ -4,13 +4,18 @@
Please type "perldoc PAR" after installation to see the module usage
information, and "perldoc PAR::FAQ" for frequently answered questions.
-For packing scripts with prerequisite modules into stand-alone scripts
-or executables (aka PerlApp, Perl2exe, or 'perlcc that works'), see
-"perldoc pp" and "perldoc tkpp".
+As of version 0.97 of PAR, the logic for generating stand-alone executables
+has been refactored into the PAR-Packer distribution. It should be available
+from the same source you got PAR from. Hence, for packing scripts with
+prerequisite modules into stand-alone scripts or executables
+(aka PerlApp, Perl2exe, or 'perlcc that works'), see "perldoc pp"
+and "perldoc tkpp".
-For running ".par" files directly, see "perldoc parl".
+For running ".par" files directly, please install PAR-Packer and
+see "perldoc parl".
-To generate/execute self-contained perl scripts, see "perldoc par.pl".
+To generate/execute self-contained perl scripts, install PAR-Packer
+and see "perldoc par.pl" or "perldoc pp".
An extensive "Cross-Platform Packaging and Deployment with PAR" tutorial
is available as "perldoc PAR::Tutorial". A slightly outdated version is
@@ -26,33 +31,9 @@
make test
make install
-If your system has a C compiler, or if somebody has built a PAR package for
-your architecture, the 'pp' tool and a stand-alone binary version of par.pl
-will be installed, so you can generate self-executable binaries like this:
-
- pp -o foo.exe /home/test.pl
-
-* Binary installation with pre-built PAR files
-
-This distribution uses the Module::Install framework to offer
-pre-compiled, architecture-dependent PAR packages to save your
-compilation time. This process is completely automatic -- no
-actions are required on your part.
-
-However, if nobody has generated such a package for your architecture,
-you will see a short messages like this:
-
- Fetching 'PAR-0.91-i386-freebsd-5.8.0.par' from www.cpan.org...
- *** No installation package available for your architecture.
- However, you may wish to generate one with 'make par' and send
- it to <AUTRIJUS at cpan.org>, so other people on the same platform
- can benefit from it.
- *** Proceeding with normal installation...
-
-If you are on a platform where normal users do not have a C compiler
-installed (MSWin32, darwin, etc.), please follow the instruction above
-and mail the generated PAR package (or more preferably, a URL to download
-that package) to me. Thanks!
+Since version 0.97 of PAR, you do not need a C compiler any more to build it.
+All logic that required a C compiler previously was moved into the PAR-Packer
+distribution.
* Notes for Windows users
@@ -75,55 +56,6 @@
You may then resume the installation process above, but replace 'make'
with 'nmake' in the last three lines.
-
-Also, if you do not have the compiler used to compile your version or
-Perl (e.g. MinGW, GCC on Cygwin, or Microsoft Visual C++ for ActivePerl),
-and nobody has generated a Windows-specific PAR yet, you will not be able to
-generate binary executables using 'pp'.
-
-Microsoft Visual C++ users: Do not forget to run "vcvars32.bat" (or equivalent)
-before "perl Makefile.PL"!
-
-* Typical Usage
-
-Here are some recipes showing how to utilize pp to bundle source.pl with
-all its dependencies, on target machines with different expected
-settings:
-
-- Stand-alone setup
-
- % pp -o packed.exe source.pl # makes packed.exe
- # Now, deploy 'packed.exe' to target machine...
- $ packed.exe # run it
-
-- Perl interpreter only, without core modules:
-
- % pp -B -p source.pl # makes source.par
- % par.pl -B -Opacked.pl source.par # makes packed.pl
- # Now, deploy 'packed.pl' to target machine...
- $ perl packed.pl # run it
-
-- Perl with core module installed:
-
- % pp -p source.pl # makes source.par
- % par.pl -b -Opacked.pl source.par # makes packed.pl
- # Now, deploy 'packed.pl' to target machine...
- $ perl packed.pl # run it
-
-- Perl with PAR.pm and its dependencies installed:
-
- % pp -p source.pl # makes source.par
- % echo "use PAR 'source.par';" > packed.pl;
- % cat source.pl >> packed.pl; # makes packed.pl
- # Now, deploy 'source.par' and 'packed.pl' to target machine...
- $ perl packed.pl # run it
-
-Note that if your perl was built with a shared library, the
-'Stand-alone setup' above will still need a separate perl5x.dll or
-libperl.so to function correctly. Patches to include a copy
-of libperl with the executable are most welcome.
-
-Please consult the documentation of 'pp' for more information.
* Source Repository
Modified: packages/libpar-perl/branches/upstream/current/SIGNATURE
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/SIGNATURE?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/SIGNATURE (original)
+++ packages/libpar-perl/branches/upstream/current/SIGNATURE Fri Dec 8 14:13:02 2006
@@ -14,30 +14,13 @@
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
-SHA1 5e4dcc7292860e3e2077bfce25626b46f967ff3b AUTHORS
-SHA1 3cba6be40a40bc0247826a0f7f94666c8bab5c33 ChangeLog
-SHA1 36d2015565cb954ff7ae7c897af65823d2e7cfd8 MANIFEST
-SHA1 53fd3487a9020e8df59375f2f2a4d0c81863ecb5 MANIFEST.SKIP
-SHA1 757cdebcbc40c55ba4afc30a66c963ab7c50bd10 META.yml
-SHA1 af2dbb8a899331bc1a648a040fcc4f798dd1a5cf Makefile.PL
-SHA1 44d54db39e89f38c714e334a3174d51d4a12b6d9 README
+SHA1 97ae61ef8c3eedba7be1360e4cdd5274c9e381d5 AUTHORS
+SHA1 e7f154622d57623f1a6ca5777c652b6a1f666374 ChangeLog
+SHA1 ec41e643f2f59c03202f5f2a5b6c145c0bcf3746 MANIFEST
+SHA1 d0c0e75a24cfd89f351ffafd59d192e4b396bb78 META.yml
+SHA1 823ad5a9fecaf217864959398d09b6172c754210 Makefile.PL
+SHA1 8c2f9ec457ddd9089b1e2ca642a7e139d620c76e README
SHA1 886fa7bf70cf69d8b6050355754f6d9ec2567115 TODO
-SHA1 e269003c5fdafb845308658383c23cddeae088f6 contrib/automated_pp_test/automated_pp_test.pl
-SHA1 31c0a2375a9f05052499fce55574b0411786f372 contrib/automated_pp_test/hello_tk.pl
-SHA1 3a32ffa47e874433d554b80633a3e125901d1bcf contrib/automated_pp_test/hi.ico
-SHA1 d5d0c6cc0d13ed428ce51d99387e366471f1ac70 contrib/automated_pp_test/pipe_a_command.pm
-SHA1 b71b276dc9bd9fef3dc534ead9c9aea001f83b12 contrib/automated_pp_test/prior_to_test.pm
-SHA1 b59d11c31c7f5d8f1ad5e8e67bb08008d8ec74a5 contrib/automated_pp_test/remove_file_and_try_executable_again.pm
-SHA1 6491158cf82d6682209955c1ad9a26c1759790b6 contrib/automated_pp_test/test_in_further_subdir.pm
-SHA1 2b131d29057aeb0b63d4b98e80eeeebc62002a27 contrib/docs/where_is_it.txt
-SHA1 de2340efaea767d9367c1f92c7e117c747dfd48c contrib/docs/who_am_i.txt
-SHA1 5f6ae715822f2483c9ada55ab32dfcaf2798667a contrib/gui_pp/gpp
-SHA1 13db62c6e2077cd551d2aaee85fab52795440e4a contrib/gui_pp/gpp_readme.txt
-SHA1 0e486fcdfccc73b120b72aad213a0a3b87e4a347 contrib/pare/pare
-SHA1 0d80cbbe5457a5a2db9c3cf7115c828d46ad1fe4 contrib/pare/pare_readme.txt
-SHA1 f1a564c8a7cf5ed4cbb893f2f9277527661fc44b contrib/procedural_pp/pp_old
-SHA1 eff2e79f0964da302217673f16abea9424a2bbdd contrib/stdio/Stdio.pm
-SHA1 e44e340a0a4b63c57a81173f3592c6f9c21c0d4d contrib/stdio/Stdio_readme.txt
SHA1 603bb9de29fb8cba7f13409c546750972eff645d inc/Module/AutoInstall.pm
SHA1 9b2f9d83bcf77860f53a0c07c90a4a59ad9f5df1 inc/Module/Install.pm
SHA1 ad955f51ad2c40d4ba35395c27f5ed899a80bf7a inc/Module/Install/AutoInstall.pm
@@ -47,61 +30,25 @@
SHA1 0606a8b02a420600bc3e2b65ab82f70266784926 inc/Module/Install/Include.pm
SHA1 2249171a2b72cd73ff2c0a06597d29f86e5df456 inc/Module/Install/Makefile.pm
SHA1 381bb98ea3877bba49ae85e7a7ea130645fd3dbf inc/Module/Install/Metadata.pm
-SHA1 2098283bd4b97844e01e820671f3a520c0367d30 inc/Module/Install/PAR.pm
SHA1 0c2118868ef82ac517eb6d9c3bd93e6eb9bbf83e inc/Module/Install/Win32.pm
SHA1 e827d6d43771032fa3df35c0ad5e5698d0e54cda inc/Module/Install/WriteAll.pm
SHA1 ae96dc4c051a202e5db3fa73133e6183ee4910b2 inc/Test/Builder.pm
SHA1 a9037004a2c3096d77169a16da95743eeb813539 inc/Test/Builder/Module.pm
SHA1 45d0149fee8d12082d0aa00fd9202f4b29126824 inc/Test/More.pm
-SHA1 f2e051c0866a1e186ef57fe4360651fac64d858d lib/App/Packer/PAR.pm
-SHA1 0de0458c814a4f229eed8bbddc444884cb7eccb2 lib/PAR.pm
-SHA1 740a9c133c4d0d1aac8675451924526a897483fc lib/PAR/Environment.pod
+SHA1 bbaa53e28a211707f7d88b0250fef089d37c3a6f lib/PAR.pm
+SHA1 457e7dcab77a9a1a1ba77ea155be709598296326 lib/PAR/Environment.pod
SHA1 1d7e734ec9cfec7a53b13e63542308c799881c5d lib/PAR/FAQ.pod
-SHA1 b236006a3343ad736a4d5352dc1e017627c6f8b8 lib/PAR/Filter.pm
-SHA1 caeff2887611bb028f49ecc16f91be3e2005f952 lib/PAR/Filter/Bleach.pm
-SHA1 22fe366553e51dd33226a70f15b939213b9b91a9 lib/PAR/Filter/Bytecode.pm
-SHA1 3d05249a79d9534ea8565b984ea9dd23a86f7d2e lib/PAR/Filter/Obfuscate.pm
-SHA1 650fa094245de4f5b9ed03ae5257fb9b3d8ddba6 lib/PAR/Filter/PatchContent.pm
-SHA1 8a40b2673f73887cd05f2c66e08f01919f81db38 lib/PAR/Filter/PodStrip.pm
SHA1 e153f2a9808b2d1c78af6d4f065209b52be502ff lib/PAR/Heavy.pm
-SHA1 e936bc39e49358e26f8efe6b0cb161851bbbe278 lib/PAR/Packer.pm
-SHA1 74f4099284c1d6e5fc4bae617e7ab113fe547ca7 lib/PAR/StrippedPARL/Base.pm
-SHA1 6712ed7fe23fcde5a19d6df18eaaa77729d6a457 lib/PAR/StrippedPARL/Dynamic.pm
-SHA1 aae2dd3825709c3e771b202bae80c47895fdb670 lib/PAR/StrippedPARL/Static.pm
SHA1 44d0f288e8c9a7362697b5d64c4272da16cfe0c9 lib/PAR/Tutorial.pod
-SHA1 98f65730e7efb31f07acd51ec9136bc6b5604121 myldr/Makefile.PL
-SHA1 9be4aa1f08dd1cfae0ed6ab51978d3fc78cdf2a5 myldr/encode_append.pl
-SHA1 c279afbd04fdc682c0889743f1ecfbec4d5c2e8f myldr/env.c
-SHA1 22dd487f91ff6160afdda9bf5db8cc1f169191f7 myldr/file2c.pl
-SHA1 2ffdb6b3ea71d075a15b81453984a0f60f60d53b myldr/internals.c
-SHA1 867e346fca981617b48b505bf494f999950fff0c myldr/main.c
-SHA1 76a8e87b782ffc0a621d3a59fa4bcf5b17500b2c myldr/mktmpdir.c
-SHA1 20147ca3292113752bcdcea31713e43dda0c8bb9 myldr/mktmpdir.h
-SHA1 72afd945a0dc5ed00ab5af9ab962727fcf555525 myldr/parlsig.pl
-SHA1 89862cdbf80d79e6525966589bc6cd3df93fb785 myldr/sha1.c.PL
-SHA1 d0000c41f32824cd565465b985ac18feb49bcf7d myldr/static.c
-SHA1 8e62c3245b92ea09539ba3d44a533e70e3fcea08 myldr/usernamefrompwuid.c
-SHA1 bb4324cdb17f8ad58d677efa6e4f3239445a2bdb myldr/utils.c
-SHA1 7b3e5be07f3db44c7f1a37ece3feea173e39fa9d myldr/win32.coff
-SHA1 32d843a5700babb314f255c171c4852637d66b1f myldr/win32.obj
-SHA1 fa6066c09715081d4d3f36685852207ff70caf9e myldr/win32.res
-SHA1 3fa53f47701f2f0709e4bc868e7fa4a27d0d9eeb script/par.pl
-SHA1 8ec91bc589fc78cf9d4d8f0ee6bc0a62eebfae3b script/parl.pod
-SHA1 75f8113e2888f6cc14da784a2e58c74e5651e89f script/pp
-SHA1 8fa71d5726e8c6c0e484d6ccb20cc0bd83b669b6 script/tkpp
SHA1 3467e6bd4b5227f8e1e21f45832b279c2e8c5b7f t/00-pod.t
SHA1 dc1c8eb9ff09172ea1df02257b68032695673e2e t/01-basic.t
-SHA1 ecc2a196239e92b39b71eeb5d31817584ff8a74f t/10-parl-generation.t
-SHA1 3b8ab1207b358709716fc05aa5da339f630d44b6 t/20-pp.t
-SHA1 00e6bafec09e62af47d0bb44feaeabdb3b0db5b6 t/30-current_exec.t
SHA1 82548e8de5a8d7a451d33cfcdece13f613d0efc2 t/40-par-hashref.t
SHA1 0ebe6181affc8afe78fad4446075d8f0ee420cfd t/Hello.pm
SHA1 a0258484d56cc699190be4cd93a16d145a0e1d16 t/hello.par
-SHA1 0146f0bd0bac69300c4317accbe2d9c69e18fef7 t/test-proc
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)
-iD8DBQFFYuq4ZCuimE51gxcRAo6GAKC5Uj8fU7nlVhxj6GE9wnyovbwRiQCdGyWa
-CMIRiqhT4V0WLLqYPxvfdj8=
-=zLhG
+iD8DBQFFcwimZCuimE51gxcRAuKLAJwOkLTslxePnKVP+Na873+nzo1DXgCeMjB2
+iyUUZOP7CAaXHxC9NNRILbQ=
+=sUbQ
-----END PGP SIGNATURE-----
Modified: packages/libpar-perl/branches/upstream/current/lib/PAR.pm
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/lib/PAR.pm?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/lib/PAR.pm (original)
+++ packages/libpar-perl/branches/upstream/current/lib/PAR.pm Fri Dec 8 14:13:02 2006
@@ -1,5 +1,5 @@
package PAR;
-$PAR::VERSION = '0.960';
+$PAR::VERSION = '0.970';
use 5.006;
use strict;
@@ -13,15 +13,16 @@
=head1 VERSION
-This document describes version 0.960 of PAR, released November 21, 2006.
+This document describes version 0.970 of PAR, released December 3, 2006.
=head1 SYNOPSIS
(If you want to make an executable that contains all module, scripts and
-data files, please consult the bundled L<pp> utility instead.)
-
-Following examples assume a F<foo.par> file in Zip format; support for
-compressed tar (F<*.tgz>/F<*.tbz2>) format is under consideration.
+data files, please consult the L<pp> utility instead. L<pp> used to be
+part of the PAR distribution but is not shipped as part of the L<PAR::Packer>
+distribution instead.)
+
+Following examples assume a F<foo.par> file in Zip format.
To use F<Hello.pm> from F<./foo.par>:
@@ -121,15 +122,16 @@
=head1 DESCRIPTION
-This module lets you easily bundle a typical F<blib/> tree into a zip
-file, called a Perl Archive, or C<PAR>.
+This module lets you use special zip files, called B<P>erl B<Ar>chives, as
+libraries from which Perl modules can be loaded.
It supports loading XS modules by overriding B<DynaLoader> bootstrapping
methods; it writes shared object file to a temporary file at the time it
is needed.
-To generate a F<.par> file, all you have to do is compress the modules
-under F<arch/> and F<lib/>, e.g.:
+A F<.par> file is mostly a zip of the F<blib/> directory after the build
+process of a CPAN distribution. To generate a F<.par> file yourself, all
+you have to do is compress the modules under F<arch/> and F<lib/>, e.g.:
% perl Makefile.PL
% make
@@ -137,19 +139,21 @@
% zip -r mymodule.par arch/ lib/
Afterward, you can just use F<mymodule.par> anywhere in your C<@INC>,
-use B<PAR>, and it will Just Work.
+use B<PAR>, and it will Just Work. Support for generating F<.par> files
+is going to be in the next (beyond 0.2805) release of Module::Build.
For convenience, you can set the C<PERL5OPT> environment variable to
C<-MPAR> to enable C<PAR> processing globally (the overhead is small
if not used); setting it to C<-MPAR=/path/to/mylib.par> will load a
specific PAR file. Alternatively, consider using the F<par.pl> utility
-bundled with this module, or using the self-contained F<parl> utility
+bundled with the L<PAR::Packer> distribution, or using the
+self-contained F<parl> utility which is also distributed with L<PAR::Packer>
on machines without PAR.pm installed.
Note that self-containing scripts and executables created with F<par.pl>
and F<pp> may also be used as F<.par> archives:
- % pp -o packed.exe source.pl # generate packed.exe
+ % pp -o packed.exe source.pl # generate packed.exe (see PAR::Packer)
% perl -MPAR=packed.exe other.pl # this also works
% perl -MPAR -Ipacked.exe other.pl # ditto
@@ -170,7 +174,7 @@
verbatim: 0 # was packed prerequisite's PODs preserved?
version: x.xx # PAR.pm version that generated this PAR
-User-defined environment variables, like I<PAR_CLEAN>, always
+User-defined environment variables, like I<PAR_GLOBAL_CLEAN>, always
overrides the ones set in F<META.yml>. The algorithm for generating
caching/temporary directory is as follows:
@@ -202,7 +206,7 @@
I<TEMP> is a temporary directory, which can be set via
C<$ENV{PAR_GLOBAL_TMPDIR}>,
-C<$ENV{PAR_TMPDIR}>, C<$ENV{TMPDIR}>, C<$ENV{TEMPDIR}>, C<$ENV{TEMP}>
+C<$ENV{TMPDIR}>, C<$ENV{TEMPDIR}>, C<$ENV{TEMP}>
or C<$ENV{TMP}>, in that order of priority.
If none of those are set, I<C:\TEMP>, I</tmp> are checked. If neither
of them exists, I<.> is used.
@@ -907,7 +911,8 @@
L<PAR::Tutorial>, L<PAR::FAQ> (For a more
current FAQ, refer to the homepage.)
-L<par.pl>, L<parl>, L<pp>
+The L<PAR::Packer> distribution which contains the packaging utilities:
+L<par.pl>, L<parl>, L<pp>.
L<PAR::Dist> for details on PAR distributions.
Modified: packages/libpar-perl/branches/upstream/current/lib/PAR/Environment.pod
URL: http://svn.debian.org/wsvn/pkg-perl/packages/libpar-perl/branches/upstream/current/lib/PAR/Environment.pod?rev=4611&op=diff
==============================================================================
--- packages/libpar-perl/branches/upstream/current/lib/PAR/Environment.pod (original)
+++ packages/libpar-perl/branches/upstream/current/lib/PAR/Environment.pod Fri Dec 8 14:13:02 2006
@@ -35,10 +35,15 @@
par.pl foo.par bar.pl
then the C<PAR_0> variable will contain something like
-C</tmp/par-tsee/cache-b175f53eb731da9594e0dde337d66013ddf25a44/495829f0.pl>
-where C<tsee> is my username and
-C</tmp/par-tsee/cache-b175f53eb731da9594e0dde337d66013ddf25a44/> is the
+C</tmp/par-youser/cache-b175f53eb731da9594e0dde337d66013ddf25a44/495829f0.pl>
+where C<youser> is your username and
+C</tmp/par-youser/cache-b175f53eb731da9594e0dde337d66013ddf25a44/> is the
PAR cache directory (C<PAR_TEMP>).
+
+The name of the PAR cache directory can take a number of different forms,
+so use C<PAR_0> if you want to find the extracted program's .pl file --
+attempting to construct the name yourself requires complex logic that
+has already produced the value in C<PAR_0>.
This works the same for executable binaries (F<.exe>, ...).
@@ -64,41 +69,67 @@
=head2 PAR_CLEAN
-# FIXME
+Users should set C<PAR_GLOBAL_CLEAN> instead.
+Recreated from C<PAR_GLOBAL_CLEAN> and the value of C<-C> from the YAML file
+by the PAR loader, and used within loader to control the initial behavior
+of extraction, and the final behavior of cleanup. The user can reference
+C<PAR_CLEAN> in the application to determine which of these behaviors
+is being used for this run of the application.
=head2 PAR_DEBUG
+
+Users should set C<PAR_GLOBAL_DEBUG> instead.
If this variable is set to a true value and F<par.pl> is run,
verbose output is sent to STDOUT or the logging filehandle.
-This is overridden by the C<-q> option to F<par.pl>.
-
-This currently onlys influences F<par.pl>. Whether this is the intended
-behaviour remains to be verified. # FIXME
+This is overridden by the C<-q> option to F<par.pl>,
+for steps after argument parsing occurs.
+
+This currently only influences F<par.pl>. Whether this is the intended
+behaviour remains to be verified.
=head2 PAR_GLOBAL_CLEAN
-# FIXME
+Setting C<PAR_GLOBAL_CLEAN> alters the behavior of par applications
+which see that environment variable at launch.
+C<PAR_GLOBAL_CLEAN> overrides the C<-C> option.
+Settings of 0 and 1 are supported. 0 corresponds to not using C<-C> on the
+pp command line; 1 corresponds to using C<-C> on the pp command line.
+C<PAR_GLOBAL_CLEAN> is ignored if C<PAR_GLOBAL_TEMP> is set, yet it
+controls the form of C<PAR_TEMP> when C<PAR_GLOBAL_TEMP> is not set.
+
+=head2 PAR_GLOBAL_DEBUG
+
+The PAR loader becomes more verbose when C<PAR_DEBUG> is set.
+Setting C<PAR_GLOBAL_DEBUG> guarantees that C<PAR_DEBUG> will be set
+internally, initially. See C<PAR_DEBUG> for more details.
=head2 PAR_GLOBAL_TEMP
-# FIXME
+Contributes to the calculation of C<PAR_TEMP>, and is further explained
+there.
=head2 PAR_GLOBAL_TMPDIR
-# FIXME
-
-=head2 PAR_GLOBAL_DEBUG
-
-# FIXME
+Contributes to the calculation of C<PAR_TEMP>, and is further explained
+there.
=head2 PAR_INITIALIZED
This environment variable is for internal use by the PAR binary loader
only.
+Documented only to avoid surprises if spawned applications expect
+to see a value initialized by the user.
=head2 PAR_PROGNAME
-# FIXME
+C<PAR_PROGNAME> is set to the fully-qualified path name of the executable
+program.
+On Windows, this is reliably obtained from the C<GetModuleFileName> API.
+On other OSes, if the C runtime is given a qualified path name, it is used,
+or the unqualified file name given is qualified by walking the path.
+This is reasonably reliable given normal program spawning conventions,
+but cannot be guaranteed to be correct in all circumstances.
=head2 PAR_RUN
@@ -116,33 +147,22 @@
F<who_am_i.txt> documentation file in the PAR source distribution
which was contributed by Alan Stewart. Related: C<PAR_ARGC>, C<PAR_ARGV_*>
+Documented only to avoid surprises if spawned applications expect
+to see a value initialized by the user.
+
=head2 PAR_TEMP
-# FIXME
+Users should set C<PAR_GLOBAL_TEMP> instead.
+C<PAR_TEMP> is calculated from a variety of other variables.
+See the C<NOTES> section in the pod for PAR.pm for
+a complete description of how the calculation proceeds.
+C<PAR_TEMP>, once calculated, is used as the location
+where PAR stores its extracted, temporary file cache.
=head2 PAR_TMPDIR
-B<This needs some attention!>
-
-Do not set C<PAR_TMPDIR>. Set C<PAR_GLOBAL_TMPDIR> or
-C<PAR_GLOBAL_TEMP> instead.
-
-While determining where to create the temporary directory C<PAR_TEMP>
-for the PAR cache of the running executable or PAR archive,
-F<PAR.pm> and the corresponding C code in F<myldr/mktmpdir.c>
-try to find the systems temporary path via various means.
-
-First, the environment variable C<PAR_TMPDIR> is tried and used
-if it exists, then in order C<TMPDIR>, C<TEMPDIR>
-(since 0.958), C<TEMP>, C<TMP>.
-
-Finally, the literal paths C<C:\\TEMP>, C</tmp> and C<.> are
-tried as fallbacks.
-
-Don't get this mixed up with C<PAR_TEMP>. C<PAR_TEMP> contains the
-temporary directory of this specific cache. If C<PAR_TMP> is, for
-example C</tmp/foo>, then the cache directory (C<PAR_TEMP>) will
-be something like C</tmp/foo/cache-XXXXXXXXXXXXXXXX>.
+Contributes to the calculation of C<PAR_TEMP>, and is further explained
+there. Users should set C<PAR_GLOBAL_TMPDIR> instead.
=head2 PAR_VERBATIM
@@ -158,6 +178,8 @@
C<-F PodStrip> on the C<pp> command line, the C<PodStrip> filter
will be applied.
+C<PAR_VERBATIM> is not used by the PAR application.
+
=head2 PAR_VERBOSE
Setting this environment variable to a positive integer
More information about the Pkg-perl-cvs-commits
mailing list