From cc34dcc02a40f462b6ed38a568be624cf4c1f9c5 Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@debian.org>
Date: Thu, 3 Jun 2010 10:04:11 -0700
Subject: [PATCH] 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.
---
 debian/changelog         |  6 ++++++
 perl-policy.sgml         | 12 ++++++++----
 upgrading-checklist.sgml |  7 +++++++
 3 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index fbd6097..1f4831e 100644
--- 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 ef1fbe6..58c3332 100644
--- 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 91b4e17..0d3ca56 100644
--- 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
-- 
2.39.2