ExtUtils::InstallPAR(3User Contributed Perl DocumentatiExtUtils::InstallPAR(3)NAMEExtUtils::InstallPAR - Install .par's into any installed perl
SYNOPSIS
use ExtUtils::InstallPAR;
# Install into the currently running perl:
ExtUtils::InstallPAR::install(
par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
);
# Install into a different perl on the system,
# this requires the ExtUtils::Infer module.
ExtUtils::InstallPAR::install(
par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
perl => '/path/to/perl.exe',
);
# If LWP::Simple is available, it works with URLs, too:
ExtUtils::InstallPAR::install(
par => 'http://foo.com/Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
);
DESCRIPTION
This module installs PAR distributions (i.e. ".par" files) into any
perl installation on the system. The PAR::Dist module can install into
the currently running perl by default and provides the necessary
parameters to override any installation directories. Figuring out how
to use those overrides in order to install into an arbitrary perl
installation on the system may be beyond most users, however. Hence
this convenience wrapper using ExtUtils::InferConfig to automatically
determine the typical site installation paths of any perl interpreter
than can be executed by the current user.
FUNCTIONS
install
Install a PAR archive into any perl on the system. Takes named
parameters:
"par => '/path/to/foo.par'" or "par => 'http://URL/to/foo.par'"
specifies the path to the .par file to install or an URL to fetch it
from (of LWP::Simple is available). This parameter is mandatory.
The "perl => '/path/to/perl'" parameter can be used to specify the perl
interpreter to install into. If you omit this option or set it to
"undef", the currently running perl will be used as target. If you
want to install into different perls, you will need to install the
"ExtUtils::InferConfig" module.
"verbosity => $value" can be used to set the verbosity of the
installation process. Defaults to 1.
CAVEATSSEE ALSO
PAR and PAR::Dist for the gist on PAR distributions/archives.
ExtUtils::InferConfig for details on how the installation paths are
determined.
ExtUtils::Install is used to install the files into the system.
"PAR::Dist" can use LWP::Simple to fetch from URLs.
AUTHOR
Steffen Mueller, <smueller@cpan.org>
COPYRIGHT AND LICENSE
Copyright (C) 2008 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.
perl v5.14.1 2008-11-14 ExtUtils::InstallPAR(3)