From: Matt Lawrence <matt.lawrence@virgin.net>
Date: Thu, 31 Oct 2013 19:25:54 +0000 (-0400)
Subject: fix lib::core::only docs when combining with local::lib
X-Git-Tag: 1.008025~3
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=cde83945fa04a676c2a234e5202e5e97cf406a2f;p=p5sagit%2Flocal-lib.git

fix lib::core::only docs when combining with local::lib
---

diff --git a/lib/lib/core/only.pm b/lib/lib/core/only.pm
index 9c7be40..48adc8e 100644
--- a/lib/lib/core/only.pm
+++ b/lib/lib/core/only.pm
@@ -19,12 +19,17 @@ lib::core::only - Remove all non-core paths from @INC to avoid site/vendor dirs
 
 To get only the core directories plus the ones for the local::lib in scope:
 
-  $ perl -Mlib::core::only -Mlocal::lib=~/perl5 myscript.pl
+  $ perl -mlocal::lib -Mlib::core::only -Mlocal::lib=~/perl5 myscript.pl
 
 To attempt to do a self-contained build (but note this will not reliably
 propagate into subprocesses, see the CAVEATS below):
 
-  $ PERL5OPT='-Mlib::core::only -Mlocal::lib=~/perl5' cpan
+  $ PERL5OPT='-mlocal::lib -Mlib::core::only -Mlocal::lib=~/perl5' cpan
+
+Please note that it is necessary to use C<local::lib> twice for this to work.
+First so that C<lib::core::only> doesn't prevent C<local::lib> from loading
+(it's not currently in core) and then again after C<lib::core::only> so that
+the local paths are not removed.
 
 =head1 DESCRIPTION