summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorAndy Dougherty <doughera@lafayette.edu>2013-02-20 08:58:49 -0500
committerAndy Dougherty <doughera@lafayette.edu>2013-02-20 08:58:49 -0500
commit4b85e17e39a85dc677455d8480c7a6c403ec00bc (patch)
tree995c993d7021df367130d3c3e9c0641f25144271 /pod
parent615e2f774517c03a3a6c4d123a812299d9465d74 (diff)
downloadperl-4b85e17e39a85dc677455d8480c7a6c403ec00bc.tar.gz
[perl #72892] Perl should support PERLmmnnLIB environment variable
This patch to perlrun.pod expands the documentation of the directory hierarchy searched under the locations specified by PERL5LIB. It now explicitly mentions the version- and architecture-specific directories added, and also notes that $Config{inc_version_list} directories are added. These additions were suggested by Damon Atkins.
Diffstat (limited to 'pod')
-rw-r--r--pod/perlrun.pod10
1 files changed, 7 insertions, 3 deletions
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index 2038c3cf44..8ef53b4f9d 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -979,9 +979,13 @@ X<PERL5LIB>
A list of directories in which to look for Perl library
files before looking in the standard library and the current
-directory. Any architecture-specific directories under the specified
-locations are automatically included if they exist, with this lookup
-done at interpreter startup time.
+directory. Any architecture-specific and version-specific directories,
+such as F<version/archname/>, F<version/>, or F<archname/> under the
+specified locations are automatically included if they exist, with this
+lookup done at interpreter startup time. In addition, any directories
+matching the entries in C<$Config{inc_version_list}> are added.
+(These typically would be for older compatible perl versions installed
+in the same directory tree.)
If PERL5LIB is not defined, PERLLIB is used. Directories are separated
(like in PATH) by a colon on Unixish platforms and by a semicolon on