From: nperez <nperez@cpan.org>
Date: Wed, 24 Jun 2009 01:32:31 +0000 (-0500)
Subject: Make INSTALL -Duserelocatableinc aware
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=32878f30ba1216461c8932946f0868cda9920d62;p=p5sagit%2Fp5-mst-13.2.git

Make INSTALL -Duserelocatableinc aware
---

diff --git a/INSTALL b/INSTALL
index d2f072f..50eeea6 100644
--- a/INSTALL
+++ b/INSTALL
@@ -772,6 +772,21 @@ simply do:
 
 =back
 
+=head2 Relocatable @INC
+
+To create a relocatable perl tree, use the following command line:
+
+    sh Configure -Duserelocatableinc
+
+Then the paths in @INC (and everything else in %Config) can be
+optionally located via the path of the perl executable.
+
+That means that, if the string ".../" is found at the start of any
+path, it's substituted with the directory of $^X. So, the relocation
+can be configured on a per-directory basis, although the default with
+"-Duserelocatableinc" is that everything is relocated. The initial
+install is done to the original configured prefix.
+
 =head2 Site-wide Policy settings
 
 After Configure runs, it stores a number of common site-wide "policy"