=encoding utf8

=head1 NAME

perlbrew - Perl 環境マネージャー

=head1 SYNOPSIS

=begin original

    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

=end original

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

    # 初期化
    perlbrew init

    # CPAN ミラーの選択
    perlbrew mirror

    # 任意の Perl をインストール
    perlbrew install perl-5.12.1
    perlbrew install perl-5.13.3

    # git チェックアウトからのインストール
    cd /path/to/src/perl
    perlbrew install .

    # インストールされている perl の一覧
    perlbrew installed

    # $PATH にある perl の切り替え (hash -r はシェルでの PATH キャッシュを消す)
    perlbrew switch perl-5.13.3
    hash -r
    perl -v

    # off にすれば無効化されます
    perlbrew off

    # 再び有効化します
    perlbrew switch perl-5.13.3

=head1 CONFIGURATION

=begin original

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

=end original

デフォルトでは、perlbrew は C<$ENV{HOME}/perl5/perlbrew> に perl のコピーを作り、
インストールします。perlbrew を実行する前にシェル変数 C<PERLBREW_ROOT>
を設定することで、別のディレクトリを使うことができます。

=head1 COMMANDS

=over 4

=item init

=begin original

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

=end original

perl のインストール先の C<perlbrew> ディレクトリを準備するために最初に実行してください。
C<PERLBREW_ROOT> を変更したいときにも、これを再び実行してください。

=item mirror

=begin original

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.

=end original

perl をインストールするときに使う CPAN ミラーを選択するときに実行します。
ミラーの一覧が表示されるので、そこから選択してください。
「q」を打てば選択をキャンセルできます。

=item install perl-<version>

=begin original

Build and install the given version of perl.

=end original

指定したバージョンの perl のビルドとインストールを実行します。

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

=begin original

Build and install from the given git checkout dir.

=end original

git チェックアウトしたディレクトリからビルドとインストールを実行します。

=item installed

=begin original

List the installed versions of perl.

=end original

インストールされている perl のバージョンの一覧表示。

=item switch perl-<version>

=begin original

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

=end original

指定したバージョンに切り替えます。このコマンドの後に 'rehash'
(もしくは 'hash -r') の実行が必要になるかもしれません。

=item off

=begin original

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

=end original

perlbrew を無効化します。C<switch> コマンドを使うことで再び有効化することができます。
キャッシュの削除には 'rehash' か 'hash -r' を使います。

=back

=head1 OPTIONS

=over 4

=item B<-?| --help>

=begin original

prints this help.

=end original

このヘルプを表示します。

=item B<-?| --help>

=begin original

prints the version of App::perlbrew.

=end original

App::perlbrew のバージョンを表示します。

=item B<-f| --force>

=begin original

Force installation of a perl.

=end original

perl を強制インストールします。

=item B<-n| --notest>

=begin original

Skip the test suite

=end original

テストをスキップします。

=item B<-q| --quiet>

=begin original

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

=end original

ログの出力先を STDOUT (標準出力) ではなくファイルにします。この挙動が初期値です。
ログファイルは F<$ROOT/build.log> に保存されます。

=item B<-v| --verbose>

=begin original

Log output to STDOUT rather than a logfile.

=end original

ログの出力先をログファイルではなく STDOUT (標準出力) にします。

=item B<--as>

=begin original

Install a given perl under an alias.

=end original

インストールする perl の名前を指定します。

    perlbrew install perl-5.6.2 -as legacy-perl

=item B<-D>, B<-U>, B<-A>

=begin original

pass through switches to the perl Configure script.

=end original

perl の Configure スクリプトにスイッチをそのまま渡します。

    perlbrew install perl-5.10.1 -D usemymalloc -U uselargefiles

=back

=head1 DESCRIPTION

=begin original

Read L<App::perlbrew> for more complete documentation.

=end original

更なる完璧なドキュメントは L<App::perlbrew> を読んでください。

=head1 翻訳について

翻訳者：IWAI, Masaharu E<lt>iwaim.sub@gmail.comE<gt>

Perlドキュメント日本語訳 Project にて、
Perlモジュール、ドキュメントの翻訳を行っております。

 http://sourceforge.jp/projects/perldocjp/
 http://www.freeml.com/ctrl/html/MLInfoForm/perldocjp@freeml.com
 http://perldoc.jp/


=cut