NAME
par.pl - Run Perl Archives
SYNOPSIS
To use Hello.pm, lib/Hello.pm or lib/arch/Hello.pm from ./foo.par:
% par.pl -A./foo.par -MHello
% par.pl -A./foo -MHello # the .par part is optionalSame thing, but search foo.par in the @INC;
% par.pl -Ifoo.par -MHello
% par.pl -Ifoo -MHello # dittoRun test.pl or script/test.pl from foo.par:
% par.pl foo.par test.pl # only when the first argument ends in '.par'
% par.pl foo.par # looks for 'main.pl' by defaultYou can also make a self-reading script containing a PAR file :
% par.pl -O./foo.pl foo.par
% ./foo.pl test.pl # same as aboveDESCRIPTION
This stand-alone command offers roughly the same feature as perl -MPAR, except that it takes the pre-loaded .par files via -Afoo.par instead of -MPAR=foo.par.
The main purpose of this utility is to be feed to perlcc:
% perlcc -o par par.pland use the resulting stand-alone executable par to run .par files:
# runs script/run.pl in archive, uses its lib/* as libraries
% par myapp.par run.pl # runs run.pl or script/run.pl in myapp.par
% par myapp.par # runs main.pl or script/main.pl by defaultFinally, as an alternative to perl2exe or PerlApp, the -o option makes a stand-alone binary from a PAR file:
% par -Omyapp myapp.par # makes a stand-alone executable
% ./myapp run.pl # same as above
% ./myapp -Omyap2 myapp.par # makes a ./myap2, identical to ./myapp
% ./myapp -Omyap3 myap3.par # makes another app with different PARNOTES
After installation, if you want to enable stand-alone binary support, please apply the included patch to the B::C module first (5.8.0 only):
patch `perl -MB::C -e'print $INC{"B/C.pm"}'` < patches/perl580.diffAnd then:
perlcc -o /usr/local/bin/par script/par.plEnjoy. :-)
SEE ALSO
AUTHORS
Autrijus Tang <autrijus@autrijus.org>
COPYRIGHT
Copyright 2002 by Autrijus Tang <autrijus@autrijus.org>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.