-=encoding utf8\r
-\r
-=head1 NAME\r
-\r
-local::lib~[de] - Erschaffen und benutzen von Perl Modulen in einem lokalen lib/ Verzeichnis mit PERL5LIB\r
-\r
-=head1 SYNOPSIS\r
-\r
-Im Code -\r
-\r
- use local::lib; # Benutzt das Verzeichnis ~/perl5 zum anlegen des lokalen lib/ Verzeichnisses\r
-\r
- use local::lib '~/foo'; # das selbe, aber mit ~/foo\r
-\r
- # Oder...\r
- use FindBin;\r
- use local::lib "$FindBin::Bin/../support"; # Applikationsspezifische Sammlung von Modulen\r
-\r
-Von der Shell -\r
-\r
- # Installiert LWP und alle notwendigen Abhängigkeiten in das '~/perl5' Verzeichnis\r
- perl -MCPAN -Mlocal::lib -e 'CPAN::install(LWP)'\r
-\r
- # Gibt die Shell Kommandos aus um die Umgebung vorzubereiten\r
- $ perl -Mlocal::lib\r
- export MODULEBUILDRC=/home/username/perl/.modulebuildrc\r
- export PERL_MM_OPT='INSTALL_BASE=/home/username/perl'\r
- export PERL5LIB='/home/username/perl/lib/perl5:/home/username/perl/lib/perl5/i386-linux'\r
- export PATH="/home/username/perl/bin:$PATH"\r
-\r
-=head2 Die Bootstrapping Methode\r
-\r
-Ein typischer Weg um local::lib zu benutzen ist die sogenannte "Bootstrapping" Methode.\r
-Diese Methode wird benutzt wenn noch kein local::lib auf dem System installiert ist.\r
-In diesem Fall kannst du einfach local::lib direkt in deinem Home-Verzeichnis installieren.\r
-\r
-Selbst wenn du administrative Rechte hast, ist es wichtig das die Umgebungsvariablen von\r
-Schritt 4 in deinem Shell Startup Skript gesetzt werden. Ohne diesen Schritt werden die\r
-Module von CPAN weiterhin im System installiert und auch Perl Skripte die du startest\r
-würden das von local::lib erstellte lib/ Verzeichnis nicht nutzen.\r
-\r
-Windows Benutzern müssen ausserdem dies hier lesen: \r
-L</Unterschiede bei Benutzung dieses Module mit Win32>.\r
-\r
-1. Lade das Tar-Archiv von CPAN runter (Suche nach "Download" auf der CPAN Seite von\r
-local::lib) und entpacke es in einem beliebigem Verzeichnis. Um das obige Problem zu\r
-vermeiden, sollte man dies als normaler User tun und nicht als root oder Administrator.\r
-\r
-2. Starte in dem entstandenen Verzeichnis folgenden Befehl:\r
-\r
- perl Makefile.PL --bootstrap\r
-\r
-Wenn das System dir vorschlägt gewisse Dinge eigenständig zu konfigurieren ist es in\r
-fast allen Fällen vollkommen in Ordnung einfach "yes" zu antworten.\r
-\r
-Falls du local::lib nicht in das Standard Verzeichnis installieren willst, musst du\r
-dieses Verzeichnis als Parameter angeben:\r
-\r
- perl Makefile.PL --bootstrap=~/foo\r
-\r
-3. Danach folgenden Befehl starten: (local::lib erwartet make auf dem System)\r
-\r
- make test && make install\r
-\r
-4. Nun müssen wir die benötigten Umgebungsvariablen, damit Perl unser neu generiertes\r
-lib/ Verzeichnis benutzt. Wenn du bash oder eine andere Bourne Shell benutzt, kannst \r
-du es über diesen Weg zu deinem Shell Startup Skript hinzufügen:\r
-\r
- echo 'eval $(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)' >>~/.bashrc\r
-\r
-Wenn du C Shell benutzt, du kannst das gleiche hiermit erreichen:\r
-\r
- /bin/csh\r
- echo $SHELL\r
- /bin/csh\r
- perl -I$HOME/perl5/lib/perl5 -Mlocal::lib >> ~/.cshrc\r
-\r
-Wenn du beim bootstrappen ein anderes Verzeichnis benutzt als das Standardverzeichnis,\r
-dann musst du dieses Verzeichnis als Parameter beim Laden des Modules local::lib angeben:\r
-\r
- echo 'eval $(perl -I$HOME/foo/lib/perl5 -Mlocal::lib=$HOME/foo)' >>~/.bashrc\r
-\r
-Nachdem diese Änderungen in deinem Shell Startup Skript gemacht wurden, ist es nun wichtig\r
-das diese Umgebungsvariablen auch gesetzt sind in deiner aktuellen Umgebung. In Bourne\r
-Shells macht man dies z.B. mit C<. ~/.bashrc>, und in C Shell würde man es mit: \r
-C<source ~/.cshrc> mit.\r
-\r
-Wenn du eine sehr langsames System hast, oder du unter drakonischen Regulierungen des\r
-Plattenplatz leben musst, kann man die automatische Generierung der manpages vom POD\r
-bei der Installation des Moduls deaktivieren beim bootstrapping mit dem C<--no-manpages>\r
-Parameter:\r
-\r
- perl Makefile.PL --bootstrap --no-manpages\r
-\r
-Wenn du mehrere lokale lib/ Installationen nutzen möchtest, z.B. für verschiedene\r
-Applikationen. Hierfür kannst du local::lib einfach einm\r
-\r
-Um zu vermeiden das man mehrere bootstraps macht um z.B. für verschiedene Applikationen\r
-eigene local::lib Installationen zu nutzen, kann man eine dieser Umgebungen benutzen\r
-um einfach in beliebigen anderen Verzeichnis Module zu installieren und somit weitere\r
-eigenständige lib/ Umgebungen zu bekommen:\r
-\r
- cd ~/mydir1\r
- perl -Mlocal::lib=./\r
- eval $(perl -Mlocal::lib=./) ### Um die Umgebungsvariablen für die\r
- ### aktuelle Shell zusetzen\r
-\r
- printenv ### Hier kannst du sehen das ~/mydir1\r
- ### in der PERL5LIB Umgebungsvariable\r
- ### steht\r
-\r
- perl -MCPAN -e install ... ### welche Module auch immer ...\r
- cd ../mydir2\r
-\r
- ... WIEDERHOLEN ...\r
-\r
-Für mehrere Umgebungen in dieser Form brauch man eine Modifikation in der\r
-Benutzung von C<< use FindBin >> in dem "Im Code" Beispiel oben.\r
-Wenn du sowas machst, und du hast damit z.B. Perl Module nach C<<\r
-~/mydir1/lib >> installiert und du hast ein Script in C<< \r
-~/mydir1/scripts/myscript.pl >>, du musst dort angeben das die Module\r
-die es braucht im Verzeichnis C<< ~/mydir1/lib >> liegen.\r
-\r
-In C<< ~/mydir1/scripts/myscript.pl >> steht dann:\r
-\r
- use strict;\r
- use warnings;\r
- use local::lib "$FindBin::Bin/.."; ### zeigt auf ~/mydir1 und local::lib \r
- ### findet dort lib\r
- use lib "$FindBin::Bin/../lib"; ### zeigt auf ~/mydir1/lib\r
-\r
-Setze das vor jeden BEGIN { ... } Block der die Module braucht die du\r
-installiert hast.\r
-\r
-=head2 Unterschiede bei Benutzung dieses Module mit Win32\r
-\r
-Um die nötigen Umgebungsvariablen für diese Variablen in der derzeitigen\r
-Sitzung mit C<CMD.EXE> zu setzen, kann man folgendes kommando nutzen:\r
-\r
- C:\>perl -Mlocal::lib\r
- set MODULEBUILDRC=C:\DOCUME~1\ADMINI~1\perl5\.modulebuildrc\r
- set PERL_MM_OPT=INSTALL_BASE=C:\DOCUME~1\ADMINI~1\perl5\r
- set PERL5LIB=C:\DOCUME~1\ADMINI~1\perl5\lib\perl5;C:\DOCUME~1\ADMINI~1\perl5\lib\perl5\MSWin32-x86-multi-thread\r
- set PATH=C:\DOCUME~1\ADMINI~1\perl5\bin;%PATH%\r
- \r
- ### Um die Umgebungsvariablen für diese Shell alleine zu setzen\r
- C:\>perl -Mlocal::lib > %TEMP%\tmp.bat && %TEMP%\tmp.bat && del %TEMP%\temp.bat\r
- ### anstelle von $(perl -Mlocal::lib=./) in bash.\r
-\r
-Wenn du willst das die Umgebungsvariablen dauerhaft gesetzt sind, musst du diese\r
-in Systemsteuerung / System dauerhaft selber eintragen oder \r
-L<App::local::lib::Win32Helper> benutzen.\r
-\r
-Die "~" wird übersetzt zu dem Benutzer Profil Verzeichnis (das Verzeichnis was\r
-beim User als "Dokumente und Einstellungen" bekannt ist unter Windows XP und\r
-vorher oder das "Benutzer" Verzeichnis bei Windows Vista und später, solange\r
-$ENV{HOME} nicht gesetzt ist. Das Verzeichnis wird hierbei zu dem korrekten\r
-Kurznamen umgewandelt, und muss daher definitiv existieren, und wird um die\r
-nötigen Unterverzeichnise erweitert.\r
-\r
-=head1 GRUNDPRINZIP\r
-\r
-Die Version von den Perl Paketen die man benötigt für spezifische Aufgaben sind\r
-sehr häufig nicht die richtigen oder korrekten Versionen auf dem System\r
-vorinstalliert. Ein Updaten von diesen Modulen ist in vielen Fällen einfach\r
-nicht möglich weil die nötigen Rechte fehlen. Ausserdem ist es generell nicht\r
-gut eigenständig die Versionen der Module auf dem System auszutauschen, weil\r
-natürlich der Rest des Systems genau die Version erwartet die von der\r
-Systemverwaltung auch installiert wurde.\r
-\r
-local::lib löst dieses Problem, es erlaubt dir dein komplett eigenes Verzeichnis\r
-für deine CPAN Module zu haben und bist so nicht genötigt die Module vom\r
-System zu nutzen oder andersrum andere User nicht mit individuellen \r
-Modulwünschen zu Überarbeitung ihres Codes zu zwingen, weil bestimmte Module\r
-zentral für alle auf neuere Version upgedatet werden. Die Installation findet\r
-hierbei dann z.B. im Home Verzeichnis statt. Es werden nur Umgebungsvariablen\r
-gesetzt die das installierte Perl dazu bewegen die im Homeverzeichnis \r
-installierten Module zu benutzen, zusätzlich und vorgezogen zu denen auf dem\r
-System.\r
-\r
-Daher muss man sich wenn man ein Paket System benutzt, wie z.b. Debian, garnicht\r
-mehr Sorgen machen, irgendwas auf dem System zu verletzten nur durch die\r
-Installation von Perl Modulen.\r
-\r
-=head1 BESCHREIBUNG\r
-\r
-Dieses Modul bietet eine schnelle und legitime Art und Weise ein sogenanntes\r
-bootstrapping zu machen um in einem User Homeverzeichnis eine Sammlung von\r
-Modulen zu installieren. Es erstellt auch die nötigen Umgebungsvariablen\r
-die benötigt werden um diese Module zu nutzen, passend zu der Shell die der\r
-User in der Umgebungsvariable C<SHELL> angegeben hat, um dann direkt passend\r
-in die entsprechenden Konfigurationsdateien der Shell einfügt zu werden.\r
-\r
-Weitergehend ist local::lib in der Lage Module zu nutzen die nicht im\r
-standardmäßigen C<@INC> Pfad von Perl enthalten sind. Das macht es einfacher\r
-für bestimmte Applikationen ein bestimmtes Set von Modulen zu installieren\r
-ohne die anderen Module auf dem System in irgendeiner Art anzufassen.\r
-Damit es z.B. auch sicherer Module zu installieren die vom Maintainer noch\r
-nicht als Release verfügbar sind.\r
-\r
-Beim Import setzt local::lib die folgenden Umgebungsvariablen zu den\r
-nötigen Werten:\r
-\r
-=over 4\r
-\r
-=item MODULEBUILDRC\r
-\r
-=item PERL_MM_OPT\r
-\r
-=item PERL5LIB\r
-\r
-=item PATH\r
-\r
-Am PATH wird natürlich angehangen, und nicht ersetzt.\r
-\r
-=back\r
-\r
-Diese Werte sind dann verfügbar für jeden Code der danach importiert wurde.\r
-\r
-=head1 CREATING A SELF-CONTAINED SET OF MODULES\r
-\r
-C<Übersetzung fehlt...>\r
-\r
-=head1 METHODS\r
-\r
-C<Übersetzung fehlt...>\r
-\r
-=head1 A WARNING ABOUT UNINST=1\r
-\r
-Wenn man local::lib in Kombination mit "make install UNINST=1" benutzt, muss\r
-man vorsichtig sein über die Tatsache das der Prozess über die Neuinstallation\r
-eine nicht ausreichende Sicherheit hat bezüglich wo er nun installieren muss.\r
-Hierdurch mann es passieren das beim deinstallieren eines Modul u.U. das\r
-globale Modul deinstalliert wird (wenn die Rechte vorhanden sind) aber die\r
-neue Version nur in der lokalen Version installiert ist. Es ist hier also sehr\r
-wichtig das man "make install UNINST=1" und local::lib nur gleichzeitig\r
-benutzt wenn man sehr sicher darüber ist welche Konsequenzen einem\r
-entgegenkommen.\r
-\r
-=head1 EINSCHRÄNKUNGEN\r
-\r
-Die Shell Erkennung ist sehr primitiv. Derzeit ist es so das alles was "csh"\r
-im Namen hat auch als C Shell eingeordnet wird, und alles andere wird als\r
-Bourne Shell betrachet, ausser auf Win32 Systemen. Wenn die C<SHELL> Variable\r
-nicht gesetzt ist, eine Bourne Shell wird angenommen.\r
-\r
-Bootstrap ist leider ein Hack, und wird auf jedenfall CPAN.pm benutzen für\r
-ExtUtils::MakeMaker, auch wenn CPANPLUS installiert ist.\r
-\r
-Es setzt definitiv PERL5LIB, PERL_MM_OPT und MODULEBUILDRC neu und vernichtet\r
-jeden Wert der vorher gesetzt war.\r
-\r
-Es sollte vielleicht eine automatische Korrektur der CPAN Config machen, wenn\r
-das nicht schon gemacht wurde.\r
-\r
-"Patches Welcome" - Patches sind immer willkommen beim Autor oder den anderen\r
-Mitwirkenden.\r
-\r
-Auf Win32 Systemen werden die Umgebungsvariablen nicht direkt in die Registrierung\r
-geschrieben damit sie auch nach dem Neustarten erhalten bleiben.\r
-\r
-=head1 FEHLERANALYSE\r
-\r
-Wenn du local::lib konfiguriert hast CPAN Module in deinem Home Verzeichnis\r
-zu installieren, und du danach versuchst mit C<cpan -i Foo::Bar> ein Modul\r
-zu installieren, und dabei einen Fehler bekommst, wie: C<Warning: You do not \r
-have permissions to install into /usr/lib64/perl5/site_perl/5.8.8/x86_64-linux at\r
-/usr/lib64/perl5/5.8.8/Foo/Bar.pm> und in der installationsausgabe steht\r
-irgendwo ein Fehler der sagt C<'INSTALL_BASE' is not a known MakeMaker parameter \r
-name>, dann hast du aus irgendeinem Grund dein neue Version von ExtUtils::MakeMaker\r
-verloren.\r
-\r
-Um dies zu korrigieren, einfach nochmal die bootstrapping Methode laufen lassen,\r
-wie oben beschrieben.\r
-\r
-Dann starte C<rm -r ~/.cpan/build/Foo-Bar*>\r
-\r
-Abschliessend dann nochmal mit C<cpan -i Foo::Bar> installieren und die Probleme\r
-sollten verschwunden sein.\r
-\r
-=head1 UMGEBUNGSVARIABLEN\r
-\r
-=over 4\r
-\r
-=item SHELL\r
-\r
-=item COMSPEC\r
-\r
-local::lib schaut in die C<SHELL> Umgebungsvariable um die korrekten Kommandos\r
-zu der Shell Konfiguration hinzuzufügen.\r
-\r
-Auf Win32 Systemen, C<COMSPEC> wird auch analysiert.\r
-\r
-=back\r
-\r
-=head1 AUTOR DER ÜBERSETZUNG\r
-\r
-Torsten Raudssus <torsten@raudssus.de> http://www.raudssus.de/\r
-\r
-=head1 URHEBERRECHT\r
-\r
-Copyright (c) 2007 - 2010 von den local::lib L</AUTHOR> und L</CONTRIBUTORS>\r
-aufgelistet in L<local::lib|local::lib>.\r
-\r
-=head1 LIZENZ\r
-\r
-Diese Sammlung ist freie Software und kann unter der selben Lizenz verbreitet\r
-werden wie Perl selber.\r
-\r
-=cut\r
-\r
-1;\r
+=encoding utf8
+
+=head1 NAME
+
+local::lib~[de] - Erschaffen und benutzen von Perl Modulen in einem lokalen lib/ Verzeichnis mit PERL5LIB
+
+=head1 SYNOPSIS
+
+Im Code -
+
+ use local::lib; # Benutzt das Verzeichnis ~/perl5 zum anlegen des lokalen lib/ Verzeichnisses
+
+ use local::lib '~/foo'; # das selbe, aber mit ~/foo
+
+ # Oder...
+ use FindBin;
+ use local::lib "$FindBin::Bin/../support"; # Applikationsspezifische Sammlung von Modulen
+
+Von der Shell -
+
+ # Installiert LWP und alle notwendigen Abhängigkeiten in das '~/perl5' Verzeichnis
+ perl -MCPAN -Mlocal::lib -e 'CPAN::install(LWP)'
+
+ # Gibt die Shell Kommandos aus um die Umgebung vorzubereiten
+ $ 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"
+
+=head2 Die Bootstrapping Methode
+
+Ein typischer Weg um local::lib zu benutzen ist die sogenannte "Bootstrapping" Methode.
+Diese Methode wird benutzt wenn noch kein local::lib auf dem System installiert ist.
+In diesem Fall kannst du einfach local::lib direkt in deinem Home-Verzeichnis installieren.
+
+Selbst wenn du administrative Rechte hast, ist es wichtig das die Umgebungsvariablen von
+Schritt 4 in deinem Shell Startup Skript gesetzt werden. Ohne diesen Schritt werden die
+Module von CPAN weiterhin im System installiert und auch Perl Skripte die du startest
+würden das von local::lib erstellte lib/ Verzeichnis nicht nutzen.
+
+Windows Benutzern müssen ausserdem dies hier lesen:
+L</Unterschiede bei Benutzung dieses Module mit Win32>.
+
+1. Lade das Tar-Archiv von CPAN runter (Suche nach "Download" auf der CPAN Seite von
+local::lib) und entpacke es in einem beliebigem Verzeichnis. Um das obige Problem zu
+vermeiden, sollte man dies als normaler User tun und nicht als root oder Administrator.
+
+2. Starte in dem entstandenen Verzeichnis folgenden Befehl:
+
+ perl Makefile.PL --bootstrap
+
+Wenn das System dir vorschlägt gewisse Dinge eigenständig zu konfigurieren ist es in
+fast allen Fällen vollkommen in Ordnung einfach "yes" zu antworten.
+
+Falls du local::lib nicht in das Standard Verzeichnis installieren willst, musst du
+dieses Verzeichnis als Parameter angeben:
+
+ perl Makefile.PL --bootstrap=~/foo
+
+3. Danach folgenden Befehl starten: (local::lib erwartet make auf dem System)
+
+ make test && make install
+
+4. Nun müssen wir die benötigten Umgebungsvariablen, damit Perl unser neu generiertes
+lib/ Verzeichnis benutzt. Wenn du bash oder eine andere Bourne Shell benutzt, kannst
+du es über diesen Weg zu deinem Shell Startup Skript hinzufügen:
+
+ echo 'eval $(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)' >>~/.bashrc
+
+Wenn du C Shell benutzt, du kannst das gleiche hiermit erreichen:
+
+ /bin/csh
+ echo $SHELL
+ /bin/csh
+ perl -I$HOME/perl5/lib/perl5 -Mlocal::lib >> ~/.cshrc
+
+Wenn du beim bootstrappen ein anderes Verzeichnis benutzt als das Standardverzeichnis,
+dann musst du dieses Verzeichnis als Parameter beim Laden des Modules local::lib angeben:
+
+ echo 'eval $(perl -I$HOME/foo/lib/perl5 -Mlocal::lib=$HOME/foo)' >>~/.bashrc
+
+Nachdem diese Änderungen in deinem Shell Startup Skript gemacht wurden, ist es nun wichtig
+das diese Umgebungsvariablen auch gesetzt sind in deiner aktuellen Umgebung. In Bourne
+Shells macht man dies z.B. mit C<. ~/.bashrc>, und in C Shell würde man es mit:
+C<source ~/.cshrc> mit.
+
+Wenn du eine sehr langsames System hast, oder du unter drakonischen Regulierungen des
+Plattenplatz leben musst, kann man die automatische Generierung der manpages vom POD
+bei der Installation des Moduls deaktivieren beim bootstrapping mit dem C<--no-manpages>
+Parameter:
+
+ perl Makefile.PL --bootstrap --no-manpages
+
+Wenn du mehrere lokale lib/ Installationen nutzen möchtest, z.B. für verschiedene
+Applikationen. Hierfür kannst du local::lib einfach einm
+
+Um zu vermeiden das man mehrere bootstraps macht um z.B. für verschiedene Applikationen
+eigene local::lib Installationen zu nutzen, kann man eine dieser Umgebungen benutzen
+um einfach in beliebigen anderen Verzeichnis Module zu installieren und somit weitere
+eigenständige lib/ Umgebungen zu bekommen:
+
+ cd ~/mydir1
+ perl -Mlocal::lib=./
+ eval $(perl -Mlocal::lib=./) ### Um die Umgebungsvariablen für die
+ ### aktuelle Shell zusetzen
+
+ printenv ### Hier kannst du sehen das ~/mydir1
+ ### in der PERL5LIB Umgebungsvariable
+ ### steht
+
+ perl -MCPAN -e install ... ### welche Module auch immer ...
+ cd ../mydir2
+
+ ... WIEDERHOLEN ...
+
+Für mehrere Umgebungen in dieser Form brauch man eine Modifikation in der
+Benutzung von C<< use FindBin >> in dem "Im Code" Beispiel oben.
+Wenn du sowas machst, und du hast damit z.B. Perl Module nach C<<
+~/mydir1/lib >> installiert und du hast ein Script in C<<
+~/mydir1/scripts/myscript.pl >>, du musst dort angeben das die Module
+die es braucht im Verzeichnis C<< ~/mydir1/lib >> liegen.
+
+In C<< ~/mydir1/scripts/myscript.pl >> steht dann:
+
+ use strict;
+ use warnings;
+ use local::lib "$FindBin::Bin/.."; ### zeigt auf ~/mydir1 und local::lib
+ ### findet dort lib
+ use lib "$FindBin::Bin/../lib"; ### zeigt auf ~/mydir1/lib
+
+Setze das vor jeden BEGIN { ... } Block der die Module braucht die du
+installiert hast.
+
+=head2 Unterschiede bei Benutzung dieses Module mit Win32
+
+Um die nötigen Umgebungsvariablen für diese Variablen in der derzeitigen
+Sitzung mit C<CMD.EXE> zu setzen, kann man folgendes kommando nutzen:
+
+ C:\>perl -Mlocal::lib
+ set MODULEBUILDRC=C:\DOCUME~1\ADMINI~1\perl5\.modulebuildrc
+ 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%
+
+ ### Um die Umgebungsvariablen für diese Shell alleine zu setzen
+ C:\>perl -Mlocal::lib > %TEMP%\tmp.bat && %TEMP%\tmp.bat && del %TEMP%\temp.bat
+ ### anstelle von $(perl -Mlocal::lib=./) in bash.
+
+Wenn du willst das die Umgebungsvariablen dauerhaft gesetzt sind, musst du diese
+in Systemsteuerung / System dauerhaft selber eintragen oder
+L<App::local::lib::Win32Helper> benutzen.
+
+Die "~" wird übersetzt zu dem Benutzer Profil Verzeichnis (das Verzeichnis was
+beim User als "Dokumente und Einstellungen" bekannt ist unter Windows XP und
+vorher oder das "Benutzer" Verzeichnis bei Windows Vista und später, solange
+$ENV{HOME} nicht gesetzt ist. Das Verzeichnis wird hierbei zu dem korrekten
+Kurznamen umgewandelt, und muss daher definitiv existieren, und wird um die
+nötigen Unterverzeichnise erweitert.
+
+=head1 GRUNDPRINZIP
+
+Die Version von den Perl Paketen die man benötigt für spezifische Aufgaben sind
+sehr häufig nicht die richtigen oder korrekten Versionen auf dem System
+vorinstalliert. Ein Updaten von diesen Modulen ist in vielen Fällen einfach
+nicht möglich weil die nötigen Rechte fehlen. Ausserdem ist es generell nicht
+gut eigenständig die Versionen der Module auf dem System auszutauschen, weil
+natürlich der Rest des Systems genau die Version erwartet die von der
+Systemverwaltung auch installiert wurde.
+
+local::lib löst dieses Problem, es erlaubt dir dein komplett eigenes Verzeichnis
+für deine CPAN Module zu haben und bist so nicht genötigt die Module vom
+System zu nutzen oder andersrum andere User nicht mit individuellen
+Modulwünschen zu Überarbeitung ihres Codes zu zwingen, weil bestimmte Module
+zentral für alle auf neuere Version upgedatet werden. Die Installation findet
+hierbei dann z.B. im Home Verzeichnis statt. Es werden nur Umgebungsvariablen
+gesetzt die das installierte Perl dazu bewegen die im Homeverzeichnis
+installierten Module zu benutzen, zusätzlich und vorgezogen zu denen auf dem
+System.
+
+Daher muss man sich wenn man ein Paket System benutzt, wie z.b. Debian, garnicht
+mehr Sorgen machen, irgendwas auf dem System zu verletzten nur durch die
+Installation von Perl Modulen.
+
+=head1 BESCHREIBUNG
+
+Dieses Modul bietet eine schnelle und legitime Art und Weise ein sogenanntes
+bootstrapping zu machen um in einem User Homeverzeichnis eine Sammlung von
+Modulen zu installieren. Es erstellt auch die nötigen Umgebungsvariablen
+die benötigt werden um diese Module zu nutzen, passend zu der Shell die der
+User in der Umgebungsvariable C<SHELL> angegeben hat, um dann direkt passend
+in die entsprechenden Konfigurationsdateien der Shell einfügt zu werden.
+
+Weitergehend ist local::lib in der Lage Module zu nutzen die nicht im
+standardmäßigen C<@INC> Pfad von Perl enthalten sind. Das macht es einfacher
+für bestimmte Applikationen ein bestimmtes Set von Modulen zu installieren
+ohne die anderen Module auf dem System in irgendeiner Art anzufassen.
+Damit es z.B. auch sicherer Module zu installieren die vom Maintainer noch
+nicht als Release verfügbar sind.
+
+Beim Import setzt local::lib die folgenden Umgebungsvariablen zu den
+nötigen Werten:
+
+=over 4
+
+=item MODULEBUILDRC
+
+=item PERL_MM_OPT
+
+=item PERL5LIB
+
+=item PATH
+
+Am PATH wird natürlich angehangen, und nicht ersetzt.
+
+=back
+
+Diese Werte sind dann verfügbar für jeden Code der danach importiert wurde.
+
+=head1 CREATING A SELF-CONTAINED SET OF MODULES
+
+C<Übersetzung fehlt...>
+
+=head1 METHODS
+
+C<Übersetzung fehlt...>
+
+=head1 A WARNING ABOUT UNINST=1
+
+Wenn man local::lib in Kombination mit "make install UNINST=1" benutzt, muss
+man vorsichtig sein über die Tatsache das der Prozess über die Neuinstallation
+eine nicht ausreichende Sicherheit hat bezüglich wo er nun installieren muss.
+Hierdurch mann es passieren das beim deinstallieren eines Modul u.U. das
+globale Modul deinstalliert wird (wenn die Rechte vorhanden sind) aber die
+neue Version nur in der lokalen Version installiert ist. Es ist hier also sehr
+wichtig das man "make install UNINST=1" und local::lib nur gleichzeitig
+benutzt wenn man sehr sicher darüber ist welche Konsequenzen einem
+entgegenkommen.
+
+=head1 EINSCHRÄNKUNGEN
+
+Die Shell Erkennung ist sehr primitiv. Derzeit ist es so das alles was "csh"
+im Namen hat auch als C Shell eingeordnet wird, und alles andere wird als
+Bourne Shell betrachet, ausser auf Win32 Systemen. Wenn die C<SHELL> Variable
+nicht gesetzt ist, eine Bourne Shell wird angenommen.
+
+Bootstrap ist leider ein Hack, und wird auf jedenfall CPAN.pm benutzen für
+ExtUtils::MakeMaker, auch wenn CPANPLUS installiert ist.
+
+Es setzt definitiv PERL5LIB, PERL_MM_OPT und MODULEBUILDRC neu und vernichtet
+jeden Wert der vorher gesetzt war.
+
+Es sollte vielleicht eine automatische Korrektur der CPAN Config machen, wenn
+das nicht schon gemacht wurde.
+
+"Patches Welcome" - Patches sind immer willkommen beim Autor oder den anderen
+Mitwirkenden.
+
+Auf Win32 Systemen werden die Umgebungsvariablen nicht direkt in die Registrierung
+geschrieben damit sie auch nach dem Neustarten erhalten bleiben.
+
+=head1 FEHLERANALYSE
+
+Wenn du local::lib konfiguriert hast CPAN Module in deinem Home Verzeichnis
+zu installieren, und du danach versuchst mit C<cpan -i Foo::Bar> ein Modul
+zu installieren, und dabei einen Fehler bekommst, wie: C<Warning: You do not
+have permissions to install into /usr/lib64/perl5/site_perl/5.8.8/x86_64-linux at
+/usr/lib64/perl5/5.8.8/Foo/Bar.pm> und in der installationsausgabe steht
+irgendwo ein Fehler der sagt C<'INSTALL_BASE' is not a known MakeMaker parameter
+name>, dann hast du aus irgendeinem Grund dein neue Version von ExtUtils::MakeMaker
+verloren.
+
+Um dies zu korrigieren, einfach nochmal die bootstrapping Methode laufen lassen,
+wie oben beschrieben.
+
+Dann starte C<rm -r ~/.cpan/build/Foo-Bar*>
+
+Abschliessend dann nochmal mit C<cpan -i Foo::Bar> installieren und die Probleme
+sollten verschwunden sein.
+
+=head1 UMGEBUNGSVARIABLEN
+
+=over 4
+
+=item SHELL
+
+=item COMSPEC
+
+local::lib schaut in die C<SHELL> Umgebungsvariable um die korrekten Kommandos
+zu der Shell Konfiguration hinzuzufügen.
+
+Auf Win32 Systemen, C<COMSPEC> wird auch analysiert.
+
+=back
+
+=head1 SUPPORT
+
+IRC:
+
+ Wir sind im Channel #local-lib auf dem Server irc.perl.org.
+
+=head1 AUTOR DER ÜBERSETZUNG
+
+Torsten Raudssus <torsten@raudssus.de> http://www.raudssus.de/
+
+=head1 URHEBERRECHT
+
+Copyright (c) 2007 - 2010 von den local::lib L</AUTHOR> und L</CONTRIBUTORS>
+aufgelistet in L<local::lib|local::lib>.
+
+=head1 LIZENZ
+
+Diese Sammlung ist freie Software und kann unter der selben Lizenz verbreitet
+werden wie Perl selber.
+
+=cut
+
+1;
projects / p5sagit/local-lib.git / commitdiff