[perl #72892] Perl should support PERLmmnnLIB environment variable
authorAndy Dougherty <doughera@lafayette.edu>
Wed, 20 Feb 2013 13:58:49 +0000 (08:58 -0500)
committerAndy Dougherty <doughera@lafayette.edu>
Wed, 20 Feb 2013 13:58:49 +0000 (08:58 -0500)
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.

pod/perlrun.pod

index 2038c3c..8ef53b4 100644 (file)
@@ -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