1ExtUtils::InstallPAR(3)User Contributed Perl DocumentatioEnxtUtils::InstallPAR(3)
2
3
4

NAME

6       ExtUtils::InstallPAR - Install .par's into any installed perl
7

SYNOPSIS

9         use ExtUtils::InstallPAR;
10
11         # Install into the currently running perl:
12         ExtUtils::InstallPAR::install(
13           par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
14         );
15
16         # Install into a different perl on the system,
17         # this requires the ExtUtils::Infer module.
18         ExtUtils::InstallPAR::install(
19           par => './Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
20           perl => '/path/to/perl.exe',
21         );
22
23         # If LWP::Simple is available, it works with URLs, too:
24         ExtUtils::InstallPAR::install(
25           par => 'http://foo.com/Foo-Bar-0.01-MSWin32-multi-thread-5.10.0.par',
26         );
27

DESCRIPTION

29       This module installs PAR distributions (i.e. ".par" files) into any
30       perl installation on the system. The PAR::Dist module can install into
31       the currently running perl by default and provides the necessary
32       parameters to override any installation directories.  Figuring out how
33       to use those overrides in order to install into an arbitrary perl
34       installation on the system may be beyond most users, however. Hence
35       this convenience wrapper using ExtUtils::InferConfig to automatically
36       determine the typical site installation paths of any perl interpreter
37       than can be executed by the current user.
38

FUNCTIONS

40   install
41       Install a PAR archive into any perl on the system. Takes named
42       parameters:
43
44       "par => '/path/to/foo.par'" or "par => 'http://URL/to/foo.par'"
45       specifies the path to the .par file to install or an URL to fetch it
46       from (of LWP::Simple is available). This parameter is mandatory.
47
48       The "perl => '/path/to/perl'" parameter can be used to specify the perl
49       interpreter to install into. If you omit this option or set it to
50       "undef", the currently running perl will be used as target.  If you
51       want to install into different perls, you will need to install the
52       "ExtUtils::InferConfig" module.
53
54       "verbosity => $value" can be used to set the verbosity of the
55       installation process. Defaults to 1.
56

CAVEATS

SEE ALSO

59       PAR and PAR::Dist for the gist on PAR distributions/archives.
60
61       ExtUtils::InferConfig for details on how the installation paths are
62       determined.
63
64       ExtUtils::Install is used to install the files into the system.
65
66       "PAR::Dist" can use LWP::Simple to fetch from URLs.
67

AUTHOR

69       Steffen Mueller, <smueller@cpan.org>
70
72       Copyright (C) 2008 by Steffen Mueller
73
74       This library is free software; you can redistribute it and/or modify it
75       under the same terms as Perl itself, either Perl version 5.6 or, at
76       your option, any later version of Perl 5 you may have available.
77
78
79
80perl v5.28.1                      2008-11-14           ExtUtils::InstallPAR(3)
Impressum