README
1This is the README file for PAR, a toolkit to create and use perl scripts
2and modules stored inside compressed .par files.
3
4Please type "perldoc PAR" after installation to see the module usage
5information, and "perldoc PAR::FAQ" for frequently answered questions.
6
7For running ".par" files directly, please install PAR-Packer and
8see "perldoc parl".
9
10To generate/execute self-contained perl scripts, install PAR-Packer
11and see "perldoc par.pl" or "perldoc pp".
12
13An extensive "Cross-Platform Packaging and Deployment with PAR" tutorial
14is available as "perldoc PAR::Tutorial". A slightly outdated version is
15also available online at <http://www.autrijus.org/par-tutorial/>.
16
17* Installation
18
19PAR uses the standard perl module install process:
20
21 perl Makefile.PL
22 make
23 make test
24 make install
25
26* Historic note
27
28With version 0.97 of PAR, the logic for generating stand-alone executables
29has been refactored into the PAR-Packer distribution. It should be available
30from the same source you got PAR from. Hence, for packing scripts with
31prerequisite modules into stand-alone scripts or executables
32(aka PerlApp, Perl2exe, or 'perlcc that works'), see "perldoc pp"
33and "perldoc tkpp".
34
35Since version 0.97 of PAR, you do not need a C compiler any more to build it.
36All logic that required a C compiler previously was moved into the PAR-Packer
37distribution.
38
39* Source Repository
40
41You can check out the most recent revision from PAR's GitHub repository:
42
43 https://github.com/rschupp/PAR
44
45* Contact
46
47You can write
48to the mailing list at <par@perl.org>, or send an empty mail to
49<par-subscribe@perl.org> to participate in the discussion.
50
51Please submit bug reports to <bug-par@rt.cpan.org>.
52
53* Copyright
54
55Copyright 2002-2010 by Audrey Tang <cpan@audreyt.org>.
56
57Copyright 2006-2010 by Steffen Mueller <smueller@cpan.org>.
58
59All rights reserved. You can redistribute and/or modify
60this bundle under the same terms as Perl itself.
61
62See LICENSE.
63