This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Make INSTALL -Duserelocatableinc aware
authornperez <nperez@cpan.org>
Wed, 24 Jun 2009 01:32:31 +0000 (20:32 -0500)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Thu, 9 Jul 2009 13:05:41 +0000 (15:05 +0200)
INSTALL

diff --git a/INSTALL b/INSTALL
index d2f072f..50eeea6 100644 (file)
--- 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"