view release on metacpan or  search on metacpan

devdata/perlbrew-help.0.75  view on Meta::CPAN

    one-line installer manually, this command is invoked automatically.

COMMAND: INFO
    info [module]
        Usage: perlbrew info [ <module> ]

        Display useful information about the perlbrew installation.

        If a module is given the version and location of the module is
        displayed.

COMMAND: INSTALL
    install [options] perl-<version>
    install [options] <version>
        Build and install the given version of perl.

        Version numbers usually look like "5.x.xx", or "perl-5.xx.x-RCx" for
        release candidates.

        The specified perl is downloaded from the official CPAN website or
        from the mirror site configured before.

        Add '--mirror $URL' to specify the URL of mirror site.

    install [options] perl-stable
    install [options] stable
        A convenient way to install the most recent stable version of Perl,
        of those that are available.

    install [options] perl-blead
    install [options] blead
        A special way to install the blead version of perl, which is
        downloaded from this specific URL regardless of mirror settings:

            http://perl5.git.perl.org/perl.git/snapshot/blead.tar.gz

    install [options] /path/to/perl/git/checkout/dir
        Build and install from the given git checkout dir.

    install [options] /path/to/perl-5.14.0.tar.gz
        Build and install from the given archive file.

    install [options] http://example.com/mirror/perl-5.12.3.tar.gz
        Build and install from the given URL. Supported URL schemes are
        "http://", "https://", "ftp://" and "file://".

    Options for "install" command:

        -f --force     Force installation
        -j $n          Parallel building and testing. ex. C<perlbrew install -j 5 perl-5.14.2>
        -n --notest    Skip testing

           --switch    Automatically switch to this Perl once successfully
                       installed, as if with `perlbrew switch <version>`

           --as        Install the given version of perl by a name.
                       ex. C<perlbrew install perl-5.6.2 --as legacy-perl>

           --noman     Skip installation of manpages

           --thread    Build perl with usethreads enabled
           --multi     Build perl with usemultiplicity enabled
           --64int     Build perl with use64bitint enabled
           --64all     Build perl with use64bitall enabled
           --ld        Build perl with uselongdouble enabled
           --debug     Build perl with DEBUGGING enabled
           --clang     Build perl using the clang compiler
           --no-patchperl
                       Skip calling patchperl

        -D,-U,-A       Switches passed to perl Configure script.
                       ex. C<perlbrew install perl-5.10.1 -D usemymalloc -U versiononly>

        --destdir $path
                       Install perl as per 'make install DESTDIR=$path'

        --sitecustomize $filename
                       Specify a file to be installed as sitecustomize.pl

    By default, all installations are configured after their name like this:

        sh Configure -de -Dprefix=$PERLBREW_ROOT/perls/<name>

COMMAND: INSTALL-MULTIPLE
    Usage: perlbrew install-multiple [options] <perl-version-1>
    <perl-version-2> ...

    Build and install the given versions of perl.

    "install-multiple" accepts the same set of options as the command
    "install" plus the following ones:

        --both $flavor       Where $flavor is one of C<thread>, C<multi>, C<ld>,
                             C<64int>, C<64all>, C<debug> and C<clang>.

                             For every given perl version, install two
                             flavors, one with the flag C<--$flavor> set
                             and the other with out. C<--both> can be
                             passed multiple times with different values
                             and in that case, all the possible
                             combinations are generated.

        --common-variations  equivalent to C<--both thread --both ld --both 64int>

        --all-variations     generates all the possible flavor combinations

        --append $string     Appends the given string to the generated names

    For instance:

        perlbrew install-multiple 5.18.0 blead --both thread --both debug

    Installs the following perls:

        perl-blead
        perl-blead-debug
        perl-blead-thread-multi
        perl-blead-thread-multi-debug
        perl-5.18.0
        perl-5.18.0-debug
        perl-5.18.0-thread-multi
        perl-5.18.0-thread-multi-debug

    (note that the "multi" flavor is selected automatically because "thread"
    requires it)

    Another example using custom compilation flags:

        perlbrew install-multiple 5.18.0 --both thread -Doptimize='-O3' --append='-O3'

COMMAND: UNINSTALL
    Usage: perlbrew uninstall <name>

    Uninstalls the given perl installation. The name is the installation
    name as in the output of `perlbrew list`. This effectively deletes the
    specified perl installation, and all libs associated with it.

COMMAND: USE
    Usage: perlbrew use [perl-<version> | <version> | <name>]

    Use the given version perl in current shell. This will not effect newly
    opened shells.

    Without a parameter, shows the version of perl currently in use.

COMMAND: SWITCH
    Usage: perlbrew switch [ <name> ]

    Switch to the given version, and makes it the default for this and all
    future terminal sessions.

    Without a parameter, shows the version of perl currently selected.

COMMAND: LIST
    Usage: perlbrew list

    List all perl installations inside perlbrew root specified by
    $PERLBREW_ROOT environment variable. By default, the value is
    "~/perl5/perlbrew".

    If there are libs associated to some perl installations, they will be
    included as part of the name. The output items in this list can be the
    argument in various other commands.

COMMAND: AVAILABLE
    Usage: perlbrew available [--all]

    List the recently available versions of perl on CPAN.

    The list is retrieved from the web page
    <http://www.cpan.org/src/README.html>, and is not the list of *all* perl
    versions ever released in the past.

    To get a list of all perls ever released, use the "--all" option.

    NOTICE: This command might be gone in the future and becomes an option
    of 'list' command.

COMMAND: OFF
    Usage: perlbrew off

    Temporarily disable perlbrew in the current shell. Effectively
    re-enables the default system Perl, whatever that is.

    This command works only if you add the statement of `source
    $PERLBREW_ROOT/etc/bashrc` in your shell initialization (bashrc /
    zshrc).

COMMAND: SWITCH-OFF