1App::perlbrew(3pm)    User Contributed Perl Documentation   App::perlbrew(3pm)
2
3
4

NAME

6       App::perlbrew - Manage perl installations in your "$HOME"
7

SYNOPSIS

9           # Installation
10           curl -L https://install.perlbrew.pl | bash
11
12           # Initialize
13           perlbrew init
14
15           # See what is available
16           perlbrew available
17
18           # Install some Perls
19           perlbrew install 5.32.1
20           perlbrew install perl-5.28.3
21           perlbrew install perl-5.33.6
22
23           # See what were installed
24           perlbrew list
25
26           # Swith to an installation and set it as default
27           perlbrew switch perl-5.32.1
28
29           # Temporarily use another version only in current shell.
30           perlbrew use perl-5.28.3
31           perl -v
32
33           # Turn it off and go back to the system perl.
34           perlbrew off
35
36           # Turn it back on with 'switch', or 'use'
37           perlbrew switch perl-5.32.1
38           perlbrew use perl-5.32.1
39
40           # Exec something with all perlbrew-ed perls
41           perlbrew exec -- perl -E 'say $]'
42

DESCRIPTION

44       perlbrew is a program to automate the building and installation of perl
45       in an easy way. It provides multiple isolated perl environments, and a
46       mechanism for you to switch between them.
47
48       Everything are installed unter "~/perl5/perlbrew". You then need to
49       include a bashrc/cshrc provided by perlbrew to tweak the PATH for you.
50       You then can benefit from not having to run "sudo" commands to install
51       cpan modules because those are installed inside your "HOME" too.
52
53       For the documentation of perlbrew usage see perlbrew command on
54       MetaCPAN <https://metacpan.org/>, or by running "perlbrew help", or by
55       visiting perlbrew's official website <https://perlbrew.pl/>. The
56       following documentation features the API of "App::perlbrew" module, and
57       may not be remotely close to what your want to read.
58

INSTALLATION

60       It is the simplest to use the perlbrew installer, just paste this
61       statement to your terminal:
62
63           curl -L https://install.perlbrew.pl | bash
64
65       Or this one, if you have "fetch" (default on FreeBSD):
66
67           fetch -o- https://install.perlbrew.pl | sh
68
69       After that, "perlbrew" installs itself to "~/perl5/perlbrew/bin", and
70       you should follow the instruction on screen to modify your shell rc
71       file to put it in your PATH.
72
73       The installed perlbrew command is a standalone executable that can be
74       run with system perl. The minimum required version of system perl is
75       5.8.0, which should be good enough for most of the OSes these days.
76
77       A fat-packed version of patchperl is also installed to
78       "~/perl5/perlbrew/bin", which is required to build old perls.
79
80       The directory "~/perl5/perlbrew" will contain all install perl
81       executables, libraries, documentations, lib, site_libs. In the
82       documentation, that directory is referred as "perlbrew root". If you
83       need to set it to somewhere else because, say, your "HOME" has limited
84       quota, you can do that by setting "PERLBREW_ROOT" environment variable
85       before running the installer:
86
87           export PERLBREW_ROOT=/opt/perl5
88           curl -L https://install.perlbrew.pl | bash
89
90       As a result, different users on the same machine can all share the same
91       perlbrew root directory (although only original user that made the
92       installation would have the permission to perform perl installations.)
93
94       You may also install perlbrew from CPAN:
95
96           cpan App::perlbrew
97
98       In this case, the perlbrew command is installed as "/usr/bin/perlbrew"
99       or "/usr/local/bin/perlbrew" or others, depending on the location of
100       your system perl installation.
101
102       Please make sure not to run this with one of the perls brewed with
103       perlbrew. It's the best to turn perlbrew off before you run that, if
104       you're upgrading.
105
106           perlbrew off
107           cpan App::perlbrew
108
109       You should always use system cpan (like /usr/bin/cpan) to install
110       "App::perlbrew" because it will be installed under a system PATH like
111       "/usr/bin", which is not affected by perlbrew "switch" or "use"
112       command.
113
114       The "self-upgrade" command will not upgrade the perlbrew installed by
115       cpan command, but it is also easy to upgrade perlbrew by running "cpan
116       App::perlbrew" again.
117

PROJECT DEVELOPMENT

119       perlbrew project <https://perlbrew.pl/> uses github
120       <https://github.com/gugod/App-perlbrew/issues> for issue tracking.
121       Issues sent to these two systems will eventually be reviewed and
122       handled. To participate, you need a github account.
123
124       Please briefly read the short instructions about how to get your work
125       released to CPAN:
126
127       <https://github.com/gugod/App-perlbrew/blob/develop/CONTRIBUTING.md>
128

AUTHOR

130       Kang-min Liu  "<gugod@gugod.org>"
131
133       Copyright (c) 2022 Kang-min Liu "<gugod@gugod.org>".
134

LICENCE

136       The MIT License
137

DISCLAIMER OF WARRANTY

139       BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
140       FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
141       WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
142       PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
143       EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
144       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
145       ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
146       YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
147       NECESSARY SERVICING, REPAIR, OR CORRECTION.
148
149       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
150       WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
151       REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE
152       TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
153       CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
154       SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
155       RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
156       FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
157       SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
158       DAMAGES.
159
160
161
162perl v5.36.0                      2022-08-01                App::perlbrew(3pm)
Impressum