=encoding utf8
-=head1 NOME
+=head1 NAME
-local::lib~[pt_br] - crie e use um lib/ local para módulos perl com PERL5LIB
+local::lib~[pt_br] - crie e use um diretório lib/ local para módulos perl com PERL5LIB
=head1 SINOPSE
# Apenas exibe alguns comandos úteis para a shell
$ perl -Mlocal::lib
- export MODULEBUILDRC=/home/username/perl/.modulebuildrc
- export PERL_MM_OPT='INSTALL_BASE=/home/username/perl'
- export PERL5LIB='/home/username/perl/lib/perl5:/home/username/perl/lib/perl5/i386-linux'
- export PATH="/home/username/perl/bin:$PATH"
+ export PERL_MB_OPT='--install_base /home/username/perl5'
+ export PERL_MM_OPT='INSTALL_BASE=/home/username/perl5'
+ export PERL5LIB='/home/username/perl5/lib/perl5/i386-linux:/home/username/perl5/lib/perl5'
+ export PATH="/home/username/perl5/bin:$PATH"
=head2 A técnica de 'bootstrapping'
sistemas não tenha instalado o local::lib. Nesse caso, você precisará
instalar o local::lib em seu diretório de usuário.
-Caso você tenha privilégios de administrador, você ainda assim deverá
-configurar suas variáveis de ambiente, como discutido no passo 4. Sem elas,
-você ainda instalará módulos no CPAN do sistema e seus scripts Perl não
-utilizarão o caminho para o lib/ que você definiu com o local::lib.
+Caso você tenha privilégios de administrador, ainda assim deverá
+configurar suas variáveis de ambiente, como discutido no passo 4, abaixo.
+Sem elas, você ainda instalará módulos no CPAN do sistema e seus scripts
+Perl não utilizarão o caminho para o lib/ que você definiu com o local::lib.
Por padrão, o local::lib instala os módulos do CPAN e a si próprio em ~/perl5.
echo 'eval $(perl -I$HOME/foo/lib/perl5 -Mlocal::lib=$HOME/foo)' >>~/.bashrc
-Após atualizar seu arquivo de configuração da shell, certifique-se de processá-lo
-novamente para obter as modificações em sua shell atual. Shells Bourne usam
-C<. ~/.bashrc> para isso, enquanto shells C usam C<source ~/.cshrc>.
+Após atualizar seu arquivo de configuração da shell, certifique-se de
+processá-lo novamente para obter as modificações em sua shell atual.
+Shells Bourne usam C<. ~/.bashrc> para isso, enquanto shells C
+usam C<source ~/.cshrc>.
Se estiver em uma máquina lenta ou operando com grandes limitações de
espaço em disco, você pode desativar a geração automática de manpages a
cd ../meudir2
... REPITA ...
-Para múltiplos ambientes para múltiplos aplicativos você pode precisar incluir
-uma versão modificada das instruções de C<< use FindBin >> no exemplo
-"No código" acima. Caso tenha feito algo como o que foi descrito acima, terá
-um conjunto de módulos Perl em C<< ~/meudir1/lib >>. Caso tenha um script em
-C<< ~/meudir1/scripts/meuscript.pl >>, você precisará indicar a ele onde
-encontrar os módulos que instalou para ele em C<< ~/meudir1/lib >>.
+Para múltiplos ambientes destinados a múltiplos aplicativos, você pode
+precisar incluir uma versão modificada das instruções de C<< use FindBin >>
+no exemplo "No código" acima. Caso tenha feito algo como o que foi descrito
+acima, terá um conjunto de módulos Perl em C<< ~/meudir1/lib >>. Caso
+tenha um script em C<< ~/meudir1/scripts/meuscript.pl >>, você precisará
+indicar a ele onde encontrar os módulos que instalou para ele
+em C<< ~/meudir1/lib >>.
Em C<< ~/meudir1/scripts/meuscript.pl >>:
do C<CMD.exe>, você pode fazer assim:
C:\>perl -Mlocal::lib
- set MODULEBUILDRC=C:\DOCUME~1\ADMINI~1\perl5\.modulebuildrc
+ set PERL_MB_OPT=--install_base C:\DOCUME~1\ADMINI~1\perl5
set PERL_MM_OPT=INSTALL_BASE=C:\DOCUME~1\ADMINI~1\perl5
set PERL5LIB=C:\DOCUME~1\ADMINI~1\perl5\lib\perl5;C:\DOCUME~1\ADMINI~1\perl5\lib\perl5\MSWin32-x86-multi-thread
set PATH=C:\DOCUME~1\ADMINI~1\perl5\bin;%PATH%
-
+
### Para configurar o ambiente apenas dessa shell
C:\>perl -Mlocal::lib > %TEMP%\tmp.bat && %TEMP%\tmp.bat && del %TEMP%\temp.bat
### em vez de $(perl -Mlocal::lib=./)
esteja usando um sistema de gerenciamento de pacotes como o do Debian,
e ainda não exista um pacote disponível na versão desejada.
-local::lib resolve esse probleme possibilitando a criação de seu próprio
+local::lib resolve esse problema possibilitando a criação de seu próprio
diretório de pacotes Perl obtidos do CPAN (em sistemas multi-usuário, isso
normalmente fica dentro do diretório de seu usuário). A instalação do Perl
no sistema permanece inalterada; você simplesmente chama o Perl com opções
=over 4
-=item MODULEBUILDRC
+=item PERL_MB_OPT
=item PERL_MM_OPT
=head1 MÉTODOS
-=head2 ensure_directory_structure_for
+=head2 ensure_dir_structure_for
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: Nenhum
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: Nenhum
=back
Exibe na saída padrão as variáveis listadas acima, devidamente ajustadas
para utilizar o caminho fornecido como diretório base.
+=head2 build_environment_vars_for
+
+=over 4
+
+=item Argumentos: $caminho_do_diretorio, $interpolar
+
+=item Valor de Retorno: %variaveis_de_ambiente
+
+=back
+
+Retorna hash contendo as variáveis de ambiente listadas acima, devidamente
+ajustadas para utilizar o caminho fornecido como diretório base.
+
=head2 setup_env_hash_for
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: Nenhum
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_base_de_instalacao
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_base_de_instalacao_arch
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_base_de_instalacao_bin
=back
para essa instalação local de bibliotecas. Baseia-se no valor de retorno do
método L</install_base_perl_path>, adicionando o diretório C<bin>.
-=head2 modulebuildrc_path
-
-=over 4
-
-=item Argumentos: caminho de diretório
-
-=back
-
-Retorna um caminho de diretório indicando onde instalar o arquivo
-C<.modulebuildrc>, baseado no caminho fornecido.
-
=head2 resolve_empty_path
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_base_de_instalacao
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_para_home
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_absoluto
=back
=over 4
-=item Argumentos: caminho de diretório
+=item Argumentos: $caminho_do_diretorio
+
+=item Valor de Retorno: $caminho_absoluto
=back
mesmo que você tenha o CPANPLUS instalado.
Destrói qualquer valor pré-existente nas variáveis de ambiente PERL5LIB,
-PERL_MM_OPT e MODULEBUILDRC.
+PERL_MM_OPT e PERL_MB_OPT.
Provavelmente deveria auto-configurar o CPAN caso isso ainda não tenha
sido feito.
=head1 COPYRIGHT
-Copyright (c) 2007 - 2010 L</AUTOR> e L</COLABORADORES> do local::lib como
-listados em L<local::lib>.
+Copyright (c) 2007 - 2010 L<local::lib/"AUTHOR">
+e L<local::lib/"CONTRIBUTORS"> do local::lib como listados em L<local::lib>.
=head1 LICENÇA