Re: perl-policy: /etc/perl missing from Module Path
- To: 587991@bugs.debian.org
- Cc: debian-perl@lists.debian.org
- Subject: Re: perl-policy: /etc/perl missing from Module Path
- From: Jonathan Nieder <jrnieder@gmail.com>
- Date: Fri, 4 Mar 2011 20:15:28 -0600
- Message-id: <20110305021528.GA22659@elie>
- In-reply-to: <87lj8biv25.fsf@windlord.stanford.edu>
- References: <20100703170802.14818.68528.reportbug@marvin.43-1.org> <878w59ediw.fsf@windlord.stanford.edu> <20100808184143.GB12226@madeleine.local.invalid> <87lj8biv25.fsf@windlord.stanford.edu>
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 <ntyni@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/<tmp>
</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">
Reply to: