From: Torsten Raudssus Date: Thu, 12 Aug 2010 19:22:16 +0000 (+0200) Subject: Updated Changes, Changed methods look in documentation X-Git-Tag: 1.006009~11 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2Flocal-lib.git;a=commitdiff_plain;h=a949ebcdd05aaff4f4e224f6c35c56a9edde4a1a Updated Changes, Changed methods look in documentation --- diff --git a/Changes b/Changes old mode 100644 new mode 100755 index 518d4eb..eba77a1 --- a/Changes +++ b/Changes @@ -1,5 +1,11 @@ Revision history for local::lib +1.006006 2010-08-12 + + - Added portugese translation + - Several minor fixes in the documentation + - Changed methods look in documentation + 1.006005 2010-07-13 - Added support informations (also for german) diff --git a/lib/POD2/DE/local/lib.pod b/lib/POD2/DE/local/lib.pod index 3576020..f36d42c 100755 --- a/lib/POD2/DE/local/lib.pod +++ b/lib/POD2/DE/local/lib.pod @@ -216,13 +216,177 @@ Am PATH wird natürlich angehangen, und nicht ersetzt. Diese Werte sind dann verfügbar für jeden Code der danach importiert wurde. -=head1 CREATING A SELF-CONTAINED SET OF MODULES +=head1 ERSTELLEN EINES EIGENSTÄNDIGE SAMMLUNG VON MODULEN -C<Übersetzung fehlt...> +Mit L besteht eine Möglichkeit dieses zutun, aber beachte das +hier eine Menge von Fallstricken und Problemen existieren, und man sollte +immer darauf achten das man auf einem Perl aufbaut was sowenig wie möglich +verändert wurde (d.h. site und vendor Verzeichnis so leer wie möglich). -=head1 METHODS +=head1 METHODEN -C<Übersetzung fehlt...> +=head2 ensure_dir_structure_for + +=over 4 + +=item Parameter: $path + +=item Rückgabewert: Keiner + +=back + +Versucht den angegebenen Pfad anzulegen, mit allen nötigen drüberliegenden +Verzeichnissen. Im Fehlerfall wird eine Exception geworfen. + +=head2 print_environment_vars_for + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: Keiner + +=back + +Gibt die Umgebungsvariablen aus, die benötigt werden um den angegebenen Pfad +als Basis Verzeichnis zu nutzen. + +=head2 build_environment_vars_for + +=over 4 + +=item Parameter: $pfad, $interpolate + +=item Rückgabewert: \%umgebungs_variablen + +=back + +=head2 setup_env_hash_for + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: Keiner + +=back + +Setzt die C<%ENV> Einträge basierend auf dem Aufruf von +L. + +=head2 install_base_perl_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $module_installations_pfad + +=back + +Gibt den Pfad zurück der benutzt wird um Perl Module zu installieren bei +dem gegebenen Pfad als Basis. Prinzipiell wird nur C und C als +Pfadelemente angehangen. + +=head2 install_base_arch_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $architektur_module_installations_pfad + +=back + +Gibt den Pfad zurück der benutzt wird um die Architektur-abhängigen Perl +Module zu installieren basirend auf dem angegebenen Pfad als Basis. Basierend +auf dem was L zurückgibt, and appends the value of +C<$Config{archname}>.asis. + +=head2 install_base_bin_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $ausfuehrbare_programme_installations_pfad + +=back + +Gibt den Pfad zurück, wo ausführbare Programme installiert werden, basierend +auf der Basis des angegebenen Pfad. Basierend auf L +Rückgabewert, hängt diese Methode noch C an. + +=head2 modulebuildrc_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $modulebuildrc_pfad + +=back + +Gibt den Pfad zurück wo die C<.modulebuildrc> Datei angelegt wird, basierend +auf der Basis des angegebenen Pfad. + +=head2 resolve_empty_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $basis_pfad + +=back + +Erstellt und gibt zurück den Pfad der benutzt wird als Basis zur Installation +der Module. Standardmäßig dies ist C<~/perl5>. + +=head2 resolve_home_path( $path ) + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $home + +=back + +Versucht das Home Verzeichnis vom aktullen User zu finden. Wenn C +installiert ist, für dieses benutzt dafür. Es wird eine Exception geworfen, wenn +kein Home Verzeichnis ermittelt werden konnte. + +=head2 resolve_relative_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $absoluter_pfad + +=back + +Macht aus dem angegebenen Pfad einen absoluten Pfad. + +=head2 resolve_path + +=over 4 + +=item Parameter: $pfad + +=item Rückgabewert: $absoluter_pfad + +=back + +Hierbei wird der Pfad durch die folgende Methoden gegeben, wobei der Rückgabewert +der ersten an die nächste weitergeben wird, um die Umgebung zu konfigurieren +für die lokale Bibliotheks Installation: L, +L, L. +Der daraus resultierende Pfad wird zu L übergeben, dessen +Resultat dann weitergegeben wird an L, wessen Resultat dann +weitergegeben wird an L. Dieses Resultat wird dann final +an L übergeben, welches dann den Rückgabewert stellt. =head1 EINE WARNUNG VOR UNINST=1 diff --git a/lib/POD2/PT_BR/local/lib.pod b/lib/POD2/PT_BR/local/lib.pod old mode 100644 new mode 100755 index 071a7d9..51e3efd --- a/lib/POD2/PT_BR/local/lib.pod +++ b/lib/POD2/PT_BR/local/lib.pod @@ -216,11 +216,13 @@ o mais vazios possível). =head1 MÉTODOS -=head2 ensure_directory_structure_for +=head2 ensure_dir_structure_for =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: None =back @@ -230,18 +232,32 @@ Tenta criar o caminho fornecido, e todos os diretórios superiores necessários. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: None =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: $path, $interpolate + +=item Valor de Retorno: \%environment_vars + +=back + =head2 setup_env_hash_for =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: None =back @@ -252,7 +268,9 @@ C. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $install_base_perl_path =back @@ -264,7 +282,9 @@ e C ao final do caminho fornecido. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $install_base_arch_path =back @@ -277,7 +297,9 @@ adicionando o valor de C<$Config{archname}>. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $install_base_bin_path =back @@ -289,7 +311,9 @@ método L, adicionando o diretório C. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $modulebuildrc_path =back @@ -300,7 +324,9 @@ C<.modulebuildrc>, baseado no caminho fornecido. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $base_path =back @@ -311,7 +337,9 @@ módulos deve ser feita. O padrão é C<~/perl5>. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $home_path =back @@ -323,7 +351,9 @@ resultado definitivo. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $absolute_path =back @@ -333,7 +363,9 @@ Transforma o caminho fornecido em um caminho absoluto. =over 4 -=item Argumentos: caminho de diretório +=item Argumentos: $path + +=item Valor de Retorno: $absolute_path =back diff --git a/lib/local/lib.pm b/lib/local/lib.pm index a60a80f..2427f51 100755 --- a/lib/local/lib.pm +++ b/lib/local/lib.pm @@ -11,7 +11,7 @@ use File::Path (); use Carp (); use Config; -our $VERSION = '1.006005'; # 1.6.5 +our $VERSION = '1.006006'; # 1.6.6 our @KNOWN_FLAGS = qw(--self-contained); @@ -570,17 +570,19 @@ These values are then available for reference by any code after import. =head1 CREATING A SELF-CONTAINED SET OF MODULES -See L for one way to do this - but note that +See L for one way to do this - but note that there are a number of caveats, and the best approach is always to perform a build against a clean perl (i.e. site and vendor as close to empty as possible). =head1 METHODS -=head2 ensure_directory_structure_for +=head2 ensure_dir_structure_for =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: None =back @@ -591,29 +593,45 @@ an exception on failure. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: None =back Prints to standard output the variables listed above, properly set to use the given path as the base directory. +=head2 build_environment_vars_for + +=over 4 + +=item Arguments: $path, $interpolate + +=item Return value: \%environment_vars + +=back + =head2 setup_env_hash_for =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: None =back Constructs the C<%ENV> keys for the given path, by calling -C. +L. =head2 install_base_perl_path =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $install_base_perl_path =back @@ -625,7 +643,9 @@ path. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $install_base_arch_path =back @@ -638,7 +658,9 @@ C<$Config{archname}>. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $install_base_bin_path =back @@ -650,7 +672,9 @@ return value, and appends the directory C. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $modulebuildrc_path =back @@ -661,7 +685,9 @@ the given path. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $base_path =back @@ -672,7 +698,9 @@ installation. Defaults to C<~/perl5>. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $home_path =back @@ -683,7 +711,9 @@ for this purpose. If no definite answer is available, throws an exception. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $absolute_path =back @@ -693,7 +723,9 @@ Translates the given path into an absolute path. =over 4 -=item Arguments: path +=item Arguments: $path + +=item Return value: $absolute_path =back @@ -790,7 +822,7 @@ Patches to correctly output commands for csh style shells, as well as some documentation additions, contributed by Christopher Nehren . Doc patches for a custom local::lib directory, more cleanups in the english -documentation and a german documentation contributed by Torsten Raudssus +documentation and a L contributed by Torsten Raudssus . Hans Dieter Pearcey sent in some additional tests for ensuring @@ -813,7 +845,7 @@ Mark Stosberg provided the code for the now deleted Documentation patches to make win32 usage clearer by David Mertens (run4flat). -Brazilian portuguese translation and minor doc patches contributed by Breno +Brazilian L and minor doc patches contributed by Breno G. de Oliveira . =head1 COPYRIGHT