From: Graham Knop <haarg@haarg.org>
Date: Mon, 23 Dec 2013 01:32:47 +0000 (-0500)
Subject: document limitations related to File::Spec
X-Git-Tag: v2.000_000~12
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2Flocal-lib.git;a=commitdiff_plain;h=6a9fd065cd02abf2d1f92b9333aab075d01fa6fc

document limitations related to File::Spec
---

diff --git a/lib/local/lib.pm b/lib/local/lib.pm
index c9f9f48..08b5533 100644
--- a/lib/local/lib.pm
+++ b/lib/local/lib.pm
@@ -1232,6 +1232,12 @@ not set, a Bourne-compatible shell is assumed.
 
 =item * Should probably auto-fixup CPAN config if not already done.
 
+=item * local::lib loads L<File::Spec>.  When used to set shell variables,
+this isn't a problem.  When used inside a perl script, any L<File::Spec>
+version inside the local::lib will be ignored.  A workaround for this is using
+C<use lib "$ENV{HOME}/perl5/lib/perl5";> inside the script instead of using
+C<local::lib> directly.
+
 =back
 
 Patches very much welcome for any of the above.