This is the README file for PAR, a toolkit to create and use perl scripts
and modules stored inside compressed .par files.

Please type "perldoc PAR" after installation to see the module usage information.

For running ".par" files directly, please install PAR-Packer and
see "perldoc parl".

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
also available online at <http://www.autrijus.org/par-tutorial/>.

* Installation

PAR uses the standard perl module install process:

    perl Makefile.PL
    make
    make test
    make install

* Historic note

With 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".

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.

* Source Repository

You can check out the most recent revision from PAR's GitHub repository:

    https://github.com/rschupp/PAR

* Contact

You can write to the mailing list at <par@perl.org> (no subscription
required).  Archives of the mailing list are available at
<http://www.nntp.perl.org/group/perl.par>
or <https://www.mail-archive.com/par@perl.org/>.

Please submit bug reports to <https://github.com/rschupp/PAR/issues>.

* Copyright

Copyright 2002-2010 by Audrey Tang <cpan@audreyt.org>.

Copyright 2006-2010 by Steffen Mueller <smueller@cpan.org>.

All rights reserved.  You can redistribute and/or modify
this bundle under the same terms as Perl itself.

See LICENSE.
