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.
123
124       See <https://github.com/gugod/App-perlbrew/contributors> for a list of
125       project contributors.
126

AUTHOR

128       Kang-min Liu  "<gugod@gugod.org>"
129
131       Copyright (c) 2021 Kang-min Liu "<gugod@gugod.org>".
132

LICENCE

134       The MIT License
135

DISCLAIMER OF WARRANTY

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