[Catalyst-commits] r14184 - trunk/examples/CatalystAdvent/root/2011/pen

[dpetrov at dev.catalyst.perl.org]

Author: dpetrov
Date: 2011-12-06 08:45:04 +0000 (Tue, 06 Dec 2011)
New Revision: 14184

Modified:
   trunk/examples/CatalystAdvent/root/2011/pen/dpetrov_local_lib_cpanm.pod
Log:
add NOTE

Modified: trunk/examples/CatalystAdvent/root/2011/pen/dpetrov_local_lib_cpanm.pod
===================================================================
--- trunk/examples/CatalystAdvent/root/2011/pen/dpetrov_local_lib_cpanm.pod	2011-12-05 18:00:26 UTC (rev 14183)
+++ trunk/examples/CatalystAdvent/root/2011/pen/dpetrov_local_lib_cpanm.pod	2011-12-06 08:45:04 UTC (rev 14184)
@@ -8,20 +8,20 @@
 =head2 Installing cpanminus and local::lib
 
 Before we start, we should say a few words about cpanminus and local::lib.
-L<cpanminus|App::cpanminus> is a script to get, unpack, build and install
-modules from CPAN and L<local::lib> is a greet tool to create and use local lib/
-for perl modules.
+L<cpanminus|App::cpanminus> is a great script to get, unpack, build and
+install modules from CPAN and L<local::lib> is a greet tool to create and use
+local lib/ for perl modules.
 
 Installing modules locally has never been easier. 
 First we need to install App::cpanminus and local::lib locally:
 
   curl -L http://cpanmin.us | perl - -l ~/perl5 App::cpanminus local::lib
 
-this will install either cpanminus and local::lib (and all other required
+This will install either cpanminus and local::lib (and all other required
 modules) locally into $HOME/perl5 directory.
 
-All we need to do is now to specify the appropriate environment variables to
-tell Perl where to look for installed modules.
+Now all we need to do is now to specify the appropriate environment variables
+to tell Perl where to look for installed modules.
 
   eval `perl -I ~/perl5/lib/perl5 -Mlocal::lib=~/perl5`
   echo 'eval $(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)' >> ~/.bashrc
@@ -61,7 +61,7 @@
   perl-5.14.2
   ...
 
-And finally we can brew the latest available Perl version.
+And finally we can brew the some of the latest available Perl versions.
 
   dpetrov at vaio:~$ perlbrew install 5.14.2
   ...
@@ -79,6 +79,15 @@
 Now you can enjoy using perl 5.14.2 and you can switch back to the system Perl
 version simply by turning C<perlbrew off>.
 
+=head2 NOTE
+
+We should mention that L<local::lib> was not designed to work with multiple
+Perl versions. That's so because usually XS modules are not compatible
+across major Perl releases. That's usually not such a big issue, because
+using L<perlbrew|App::perlbrew> you have your own Perl, which allows you to
+install different module versions across different Perl versions (and all
+that is locally).
+
 =head2 Summary
 
 =head1 AUTHOR