Bug#587991: perl-policy: /etc/perl missing from Module Path

[Jonathan Nieder]

Hi,

Ansgar Burchardt noticed:

> perl/5.8.0-7 added /etc/perl to @INC:
>
>   * Prepend /etc/perl to @INC to provide a standard location for
>     configuration modules:
>
> But this addition has never been documented in the Debian Perl Policy.

Russ Allbery wrote:

> Good point.  Here's updated proposed wording.

I see this has been seconded by

 Niko Tyni <nt...@debian.org> (message #25)

and I imagine that Russ might be willing to second this, but that
still leaves us one DD short[1].  Seconds?  Objections?
Clarifications?

A refreshed patch is attached for reference.

Thanks,
Jonathan

[1] http://wiki.debian.org/PolicyChangesProcess#StateE.3AWordingproposed

diff --git a/perl-policy.sgml b/perl-policy.sgml
index b9f3277..b41342d 100644
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -128,17 +128,27 @@
       <sect id="paths">
        <heading>Module Path</heading>
        <p>
-         Perl searches three different locations for modules, referred
-         to in this document as <var>core</var> in which modules
-         distributed with Perl are installed, <var>vendor</var> for
-         packaged modules and <var>site</var> for modules installed by
-         the local administrator.
+         Perl searches four different locations for modules, referred to
+         in this document as <var>etc</var> for system configuration
+         modules, <var>core</var> in which modules distributed with Perl
+         are installed, <var>vendor</var> for packaged modules,
+         and <var>site</var> for modules installed by the local
+         administrator.
        </p>
        <p>
          The module search path (<tt>@INC</tt>) in the Debian packages
          has been ordered to include these locations in the following
          order:
          <taglist>
+           <tag><var>etc</var></tag>
+           <item>
+             <p>
+               Configuration modules (see <ref id="config_modules">).
+               <example>
+/etc/perl
+               </example>
+             </p>
+           </item>
            <tag><var>site</var> (current)</tag>
            <item>
              <p>
@@ -393,6 +403,17 @@ $(MAKE) install DESTDIR=$(CURDIR)/debian/&lt;tmp&gt;
          </p>
        </sect1>
       </sect>
+
+      <sect id="config_modules">
+       <heading>Configuration Modules</heading>
+       <p>
+         Some Perl packages load system-wide configuration from a
+         dedicated Perl module whose purpose is solely to contain
+         configuration settings.  The module often contains only variable
+         settings.  Such modules should be treated as configuration files
+         and installed under <file>/etc/perl</file>.
+       </p>
+      </sect>
     </chapt>
 
     <chapt id="programs">