X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FPOD2%2FPT_BR%2Flocal%2Flib.pod;h=38ffed5e7e5629282e87d4d7ad4621ab30c2006a;hb=8522f4d534fb0a64f7be010048e988dfda658258;hp=51e3efdeda49a6005ff3745bd6e974d2be972ebb;hpb=a949ebcdd05aaff4f4e224f6c35c56a9edde4a1a;p=p5sagit%2Flocal-lib.git diff --git a/lib/POD2/PT_BR/local/lib.pod b/lib/POD2/PT_BR/local/lib.pod old mode 100755 new mode 100644 index 51e3efd..38ffed5 --- a/lib/POD2/PT_BR/local/lib.pod +++ b/lib/POD2/PT_BR/local/lib.pod @@ -1,8 +1,8 @@ =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 @@ -23,10 +23,10 @@ Pela linha de comando (shell) - # 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' @@ -35,10 +35,10 @@ técnica de "bootstrapping". É uma boa abordagem caso seu administrador de 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. @@ -85,9 +85,10 @@ precisará indicá-lo na chamada ao local::lib, dessa forma: 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. +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. 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 @@ -110,12 +111,13 @@ instalar módulos em diretórios diferentes da seguinte forma: 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 >>: @@ -132,11 +134,11 @@ Para configurar as variáveis de ambiente apropriadas para sua sessão atual do C, 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=./) @@ -159,7 +161,7 @@ Talvez você não tenha privilégios de administrador do sistema; ou talvez 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 @@ -192,7 +194,7 @@ seguintes variáveis de ambiente: =over 4 -=item MODULEBUILDRC +=item PERL_MB_OPT =item PERL_MM_OPT @@ -220,9 +222,9 @@ o mais vazios possível). =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: None +=item Valor de Retorno: Nenhum =back @@ -232,9 +234,9 @@ Tenta criar o caminho fornecido, e todos os diretórios superiores necessários. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: None +=item Valor de Retorno: Nenhum =back @@ -245,19 +247,22 @@ para utilizar o caminho fornecido como diretório base. =over 4 -=item Argumentos: $path, $interpolate +=item Argumentos: $caminho_do_diretorio, $interpolar -=item Valor de Retorno: \%environment_vars +=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: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: None +=item Valor de Retorno: Nenhum =back @@ -268,9 +273,9 @@ C. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $install_base_perl_path +=item Valor de Retorno: $caminho_base_de_instalacao =back @@ -282,9 +287,9 @@ e C ao final do caminho fornecido. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $install_base_arch_path +=item Valor de Retorno: $caminho_base_de_instalacao_arch =back @@ -297,9 +302,9 @@ adicionando o valor de C<$Config{archname}>. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $install_base_bin_path +=item Valor de Retorno: $caminho_base_de_instalacao_bin =back @@ -307,26 +312,13 @@ Retorna um caminho de diretório indicando onde instalar programas executáveis para essa instalação local de bibliotecas. Baseia-se no valor de retorno do método L, adicionando o diretório C. -=head2 modulebuildrc_path - -=over 4 - -=item Argumentos: $path - -=item Valor de Retorno: $modulebuildrc_path - -=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: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $base_path +=item Valor de Retorno: $caminho_base_de_instalacao =back @@ -337,9 +329,9 @@ módulos deve ser feita. O padrão é C<~/perl5>. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $home_path +=item Valor de Retorno: $caminho_para_home =back @@ -351,9 +343,9 @@ resultado definitivo. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $absolute_path +=item Valor de Retorno: $caminho_absoluto =back @@ -363,9 +355,9 @@ Transforma o caminho fornecido em um caminho absoluto. =over 4 -=item Argumentos: $path +=item Argumentos: $caminho_do_diretorio -=item Valor de Retorno: $absolute_path +=item Valor de Retorno: $caminho_absoluto =back @@ -408,7 +400,7 @@ A técnica de bootstrap é um hack e usará o CPAN.pm para o ExtUtils::MakeMaker 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. @@ -466,8 +458,8 @@ para o L durante a Copa de 2010. =head1 COPYRIGHT -Copyright (c) 2007 - 2010 L e L do local::lib como -listados em L. +Copyright (c) 2007 - 2010 L +e L do local::lib como listados em L. =head1 LICENÇA