Document that @INC has /usr/lib/perl/5.18, not /usr/lib/perl/5.18.2

[debian/debian-policy.git] / perl-policy.sgml

diff --git a/perl-policy.sgml b/perl-policy.sgml
index 70c5bfcc7ab149b9a86fe2bbd4b03ad8aeea842c..abe04d9a47d63c537a75dc9a8b5fcad150e233a3 100644 (file)
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -168,9 +168,11 @@
              <p>
                Modules included in the core Perl distribution.
                <example>
-/usr/lib/perl/<var>version</var>
-/usr/share/perl/<var>version</var>
+/usr/lib/perl/<var>shortversion</var>
+/usr/share/perl/<var>shortversion</var>
                </example>
+               Where <var>shortversion</var> indicates the current Perl major
+               version (for example <tt>5.18</tt>).
              </p>
            </item>
            <tag><var>site</var> (old)</tag>
@@ -197,8 +199,8 @@
          package.
        </p>
        <p>
-         Manual pages distributed with Perl packages must be installed
-         into the standard directories:
+         Manual pages distributed with packages built from the perl
+         source package must be installed into the standard directories:
          <taglist>
            <tag>Programs</tag>
            <item>
@@ -217,6 +219,8 @@
              </p>
            </item>
          </taglist>
+         The extensions used for manual pages distributed with module
+         packages are different.  See <ref id="vendor_dirs">.
        </p>
       </sect>
     </chapt>