The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

cpan2par - Create PAR distributions from CPAN

SYNOPSIS

cpan2par --help

cpan2par [-v -f -t -o DIR] -p MODULEPATTERN

DESCRIPTION

This script creates PAR distributions from any number of modules from CPAN. The only mandatory parameter is a pattern matching the modules you wish to create PAR distributions from. This works the same way as, for example cpan install MODULEPATTERN.

Parameters

  -v --verbose
    Sets the verbose mode.
  -p --pattern
    The module pattern to use.
  -o --out
    Sets the output directory. (default: .)
  -f --follow
    Follow dependencies and recursively generate PAR distributions.
  -t --test
    Indicates whether the modules' tests will be run before the PAR
    distribution is created.
  -m --merge
    Merge all modules into the main PAR distribution instead
    of creating separate .par files for each dependency.
    (This step is carried out at the end. If something goes wrong,
     it will be skipped.)
  --no-docs
    Strip all documentation (man pages, html documentation) from the
    resulting PAR distribution.
    (This step is carried out at the end. If something goes wrong,
     it will be skipped.)
  -s --skip
    Skip modules that match this regex. (May be specified multiple
    times.)
  -a --auto-detect-pure-perl
    Auto-detect whether a distribution is pure-Perl (i.e. does not
    contain portions that require a C compiler) and flag the
    produced distribution as such by changing its name.
  --perl --perlversion
    Defaults to your version of Perl. Used to determine
    which modules are core perl and thus will be skipped.
    Set this to 0 to package all core modules as well.

SEE ALSO

This tool is implemented using the PAR::Dist::FromCPAN module. Please refer to that module's documentation for details on how this all works.

PAR has a mailing list, <par@perl.org>, that you can write to; send an empty mail to <par-subscribe@perl.org> to join the list and participate in the discussion.

Please send bug reports to <bug-par-dist-fromcpan@rt.cpan.org>.

The official PAR website may be of help, too: http://par.perl.org

AUTHOR

Steffen Mueller, <smueller at cpan dot org>

COPYRIGHT AND LICENSE

Copyright (C) 2006-2009 by Steffen Mueller

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6 or, at your option, any later version of Perl 5 you may have available.