X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=perl-policy.sgml;h=58c33328fb8eec1aea378294862c3df1cc79cc5c;hb=cc34dcc0;hp=ce9c4ee8e83c756dc87511a98847311d7b4e54ea;hpb=98a652c6d166ecc78182c29f3429c52c9f834315;p=debian%2Fdebian-policy.git
diff --git a/perl-policy.sgml b/perl-policy.sgml
index ce9c4ee..58c3332 100644
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -47,14 +47,26 @@
You can also obtain it by writing to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ Boston, MA 02110-1301, USA.
+
+ About this document
+
+ This document is distributed as the perl-policy files
+ in the Debian package
+ .
+ It is also available from the Debian web mirrors at
+ .
+
+
+
Perl Packaging
@@ -77,8 +89,11 @@
The perl-base package must provide
- perlapi-version for all released
- versions it is compatible with.
+ perlapi-abiname for all released
+ package versions it is compatible with. The choice of
+ abiname is arbitrary, but if it differs from
+ $Config{version}, it must be specified in
+ $Config{debian_abi}.
@@ -91,18 +106,18 @@
the binary and a basic set of modules.
- As Perl is currently used by such things as
- update-alternatives and some package maintainer
- scripts, it must be priority required and marked as
- essential.
+ As Perl has been part of the essential set for some time and is
+ used without dependencies by such things as package maintainer
+ scripts, perl-base must be
+ priority required and marked as essential.
Note that the perl-base package is intended
only to provide for exceptional circumstances and the contents
- may change. In general only packages which form part of the
- base system should declare a dependency on
- perl-base rather than
- perl.
+ may change. In general, only packages which form part of the
+ base system should use only the facilities
+ of perl-base rather than declaring a
+ dependency on perl.
@@ -307,10 +322,6 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr
(nominally just tmp)
-
- A Build-Depends on perl (>= 5.6.0-16) is
- required.
-
@@ -330,13 +341,6 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr
the minimum required version, or more simply the current
version.
-
- In the absence of an explicit requirement,
- architecture-independent modules must depend on a minimum
- perl or perl-base
- version of 5.6.0-16 due to the changes in
- @INC introduced by that version.
-
@@ -347,8 +351,9 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr
a minimum version of the perl package
used to build the module, and must additionally depend on
the expansion of
- perlapi-$Config{version} using
- the Config module.
+ perlapi-$Config{debian_abi} using
+ the Config module. If $Config{debian_abi}
+ is empty or not set, $Config{version} must be used.
@@ -358,8 +363,13 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr
Rather than hard-coding the dependencies into the control
file, using a substitution such as ${perl:Depends}
is suggested. This allows the dependencies to be determined
- as build time and written to the substvars file
- in the form perl:Depends=deps.
+ at build time and written to the substvars file
+ in the form
+ perl:Depends=deps.
+ Please note that dependencies caused by versioned
+ uses and on separately packaged modules are not included
+ in this variable and must be explicitly included.
+
Packages built with debhelper may use
@@ -471,3 +481,6 @@ perl -MExtUtils::Embed -e ldopts
+
+
+