From: Graham Knop <haarg@haarg.org>
Date: Mon, 23 Dec 2013 12:12:54 +0000 (-0500)
Subject: document conflicts with PREFIX/--prefix options
X-Git-Tag: v2.000_001~8
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0921389e0d7c2019ee181c9d6419aac422d13cab;p=p5sagit%2Flocal-lib.git

document conflicts with PREFIX/--prefix options
---

diff --git a/lib/local/lib.pm b/lib/local/lib.pm
index ceee4aa..7ce445b 100644
--- a/lib/local/lib.pm
+++ b/lib/local/lib.pm
@@ -1260,6 +1260,16 @@ 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.
 
+=item * Conflicts with L<ExtUtils::MakeMaker>'s C<PREFIX> option.
+C<local::lib> uses the C<INSTALL_BASE> option, as it has more predictable and
+sane behavior.  If something attempts to use the C<PREFIX> option when running
+a F<Makefile.PL>, L<ExtUtils::MakeMaker> will refuse to run, as the two
+options conflict.  This can be worked around by temporarily unsetting the
+C<PERL_MM_OPT> environment variable.
+
+=item * Conflicts with L<Module::Build>'s C<--prefix> option.  Similar to the
+previous limitation, but any C<--prefix> option specified will be ignored.
+
 =back
 
 Patches very much welcome for any of the above.