Perl Policy: Change perlapi provides to use an ABI version

Perl now provides perlapi-<abiversion> where <abiversion> may be
more than just the version of Perl.  Packages must update their
dependencies accordingly, using $Config{debian_abi} to form the
package dependency if set and falling back on $Config{version}
otherwise.

diff --git a/debian/changelog b/debian/changelog
index fbd6097abeb5a0ccbe0b2cb3fc3c8c53cca3db58..1f4831ef5a7f08fba7d5906833dc3b3b06e2f741 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -32,6 +32,12 @@ debian-policy (3.8.5.0) UNRELEASED; urgency=low
     Seconded: Raphael Hertzog <hertzog@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #562506
+  * Perl Policy: Change perlapi provides to use an ABI version
+    Wording: Niko Tyni <ntyni@debian.org>
+    Seconded: Russ Allbery <rra@debian.org>
+    Seconded: Brendan O'Dea <bod@debian.org>
+    Seconded: Damyan Ivanov <dmn@debian.org>
+    Closes: #579457
   * Standardize dpkg state wording and bring it in line with dpkg,
     renaming Failed-Config to Half-Configured and use uniform
     capitalization and punctuation.  (Closes: #442134)

diff --git a/perl-policy.sgml b/perl-policy.sgml
index ef1fbe64c479bb31637e785d27d4ede211345c95..58c33328fb8eec1aea378294862c3df1cc79cc5c 100644 (file)
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -89,8 +89,11 @@
        </p>
        <p>
          The <package>perl-base</package> package must provide
-         <package>perlapi-<var>version</var></package> for all released
-         versions it is compatible with.
+         <package>perlapi-<var>abiname</var></package> for all released
+         package versions it is compatible with. The choice of
+         <var>abiname</var> is arbitrary, but if it differs from
+         <tt>$Config{version}</tt>, it must be specified in
+         <tt>$Config{debian_abi}</tt>.
        </p>
       </sect>
 
@@ -348,8 +351,9 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/&lt;tmp&gt;/usr
            a minimum version of the <package>perl</package> package
            used to build the module, and must additionally depend on
            the expansion of
-           <package>perlapi-$Config{version}</package> using
-           the <tt>Config</tt> module.
+           <package>perlapi-$Config{debian_abi}</package> using
+           the <tt>Config</tt> module. If <tt>$Config{debian_abi}</tt>
+           is empty or not set, <tt>$Config{version}</tt> must be used.
          </p>
        </sect1>
 

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 91b4e172a90d2547320a564bf7818316ab6b9e94..0d3ca569964d82b1a2b0b58e9c2a12efb42317b3 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -47,6 +47,13 @@ Release Jun 2010.
   <item><file>init.d</file> scripts are a possible exception from the
   normal requirement to use <code>set -e</code> in each shell script.
   </item>
+<tag>perl</tag>
+  <item><package>perl-base</package> now
+  provides <package>perlapi-<var>abiname</var></package> instead of a
+  package based solely on the Perl version.  Perl packages must now depend
+  on <package>perlapi-$Config{debian_abi}</package>, falling back
+  on <tt>$Config{version}</tt> if <tt>$Config{debian_abi}</tt> is not set.
+  </item>
 </taglist></p>
 
 <sect> Version 3.8.4.0