NAME

perlbrew - Perl Environment manager.

SYNOPSIS

perlbrew [options] [init|install|installed|switch]

# Initialize
perlbrew init

# Pick a prefered CPAN mirror
perlbrew mirror

# Install some Perls
perlbrew install perl-5.12.1
perlbrew install perl-5.13.3

# Install from a git checkout
cd /path/to/src/perl
perlbrew install .

# List which perls are installed
perlbrew installed

# Switch perl in the $PATH (hash -r clears the PATH cache in the shell)
perlbrew switch perl-5.13.3
hash -r
perl -v

# Turn it off. Disable it.
perlbrew off

# Turn it back on. Re-enable it.
perlbrew switch perl-5.13.3

CONFIGURATION

By default perlbrew builds and installs copies of perl into $ENV{HOME}/perl5/perlbrew. To use a different directory, set the PERLBREW_ROOT shell variable before running perlbrew.

COMMANDS

init

Run this once to setup the perlbrew directory ready for installing perls into. Run it again if you decide to change PERLBREW_ROOT.

mirror

Run this if you want to choose a specific CPAN mirror to install the perls from. It will display a list of mirrors for you to pick from. Hit 'q' to cancel the selection.

install perl-<version>

Build and install the given version of perl.

install /path/to/perl/git/checkout/dir

Build and install from the given git checkout dir.

installed

List the installed versions of perl.

switch perl-<version>

Switch to the given version. You may need to run 'rehash' (or 'hash -r') after this command.

off

Disable perlbrew. Use switch command to re-enable it. Use 'rehash' or 'hash -r' again to clear the cache.

OPTIONS

-?| --help

prints this help.

-?| --help

prints the version of App::perlbrew.

-f| --force

Force installation of a perl.

-n| --notest

Skip the test suite

-q| --quiet

Log output to a log file rather than STDOUT. This is the default. The log file is saved in $ROOT/build.log

-v| --verbose

Log output to STDOUT rather than a logfile.

--as

Install a given perl under an alias.

perlbrew install perl-5.6.2 -as legacy-perl

-D, -U, -A

pass through switches to the perl Configure script.

perlbrew install perl-5.10.1 -D usemymalloc -U uselargefiles

DESCRIPTION

Read App::perlbrew for more complete documentation.