NAME
    Perl::Build - perl builder

SYNOPSIS
        # install perl from CPAN
        Perl::Build->install_from_cpan(
            '5.16.2' => (
                dst_path          => '/path/to/perl-5.16.2/',
                configure_options => ['-des'],
            )
        );

        # install perl from tar ball
        Perl::Build->install_from_cpan(
            'path/to/perl-5.16.2.tar.gz' => (
                dst_path          => '/path/to/perl-5.16.2/',
                configure_options => ['-des'],
            )
        );

DESCRIPTION
    This is yet another perl builder module.

    THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.

METHODS
    Perl::Build->install_from_cpan($version, %args)
        Install $version perl from CPAN. This method fetches tar ball from
        CPAN, build, and install it.

        You can pass following options in %args.

        dst_path
            Destination directory to install perl.

        configure_options : ArrayRef(Optional)
            Command line arguments for ./Configure.

            (Default: ['-de'])

        tarball_dir(Optional)
            Temporary directory to put tar ball.

        build_dir(Optional)
            Temporary directory to build binary.

        patchperl(Optional)
            Path to patchperl. patchperl is a patch set for older perls.

            (Default: 'patchperl')

    Perl::Build->install_from_tarball($dist_tarball_path, %args)
        Install perl from tar ball. This method extracts tar ball, build,
        and install.

        You can pass following options in %args.

        dst_path(Required)
            Destination directory to install perl.

        configure_options : ArrayRef(Optional)
            Command line arguments for ./Configure.

            (Default: ['-de'])

        build_dir(Optional)
            Temporary directory to build binary.

        patchperl(Optional)
            Path to patchperl. patchperl is a patch set for older perls.

            (Default: 'patchperl')

    Perl::Build->install(%args)
        Build and install Perl5 from extracted source directory.

        src_path(Required)
            Source code directory to build. That contains extracted Perl5
            source code.

        dst_path(Required)
            Destination directory to install perl.

        configure_options : ArrayRef(Optional)
            Command line arguments for ./Configure.

            (Default: ['-de'])

        patchperl(Optional)
            Path to patchperl. patchperl is a patch set for older perls.

            (Default: 'patchperl')

        test: Bool(Optional)
            If you set this value as true, Perl::Build runs "make test"
            after building.

            (Default: 0)

    Perl::Build->symlink_devel_executables($bin_dir:Str)
        Perl5 binary generated with " -Dusedevel ", is "perl-5.12.2" form.
        This method symlinks "perl-5.12.2" to "perl".

THANKS TO
    most of the code was taken from App::perlbrew.

AUTHOR
    Tokuhiro Matsuno <tokuhirom AAJKLFJEF@ GMAIL COM>

LICENSE
    This software takes most of the code from App::perlbrew.

    Perl::Build uses same license with perlbrew.

