Perl: Recommend DESTDIR instead of PREFIX with Makefile.PL

[debian/debian-policy.git] / upgrading-checklist.sgml

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 5f960c7e1a3c8a762c46f5862732422f407b17d5..f58d9e6ed23ea06ba9b0552718a160022a6137ce 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -46,6 +46,13 @@ Release Jun 2010.
   Architecture fields, and in architecture restrictions in build
   relationships.
   </item>
+<tag>6.3</tag>
+  <item>Maintainer scripts are no longer guaranteed to run with a
+  controlling terminal and must be able to fall back to noninteractive
+  behavior (debconf handles this).  Maintainer scripts may abort if there
+  is no controlling terminal and no reasonable default for a high-priority
+  question, but should avoid this if possible.
+  </item>
 <tag>9.2.2</tag>
   <item>The UID range of user accounts is extended to 1000-59999.
   </item>
@@ -60,6 +67,11 @@ Release Jun 2010.
   on <package>perlapi-$Config{debian_abi}</package>, falling back
   on <tt>$Config{version}</tt> if <tt>$Config{debian_abi}</tt> is not set.
   </item>
+<tag>perl</tag>
+  <item>Packages using <file>Makefile.PL</file> should use
+  <tt>DESTDIR</tt> rather than <tt>PREFIX</tt> to install into the package
+  staging area.  <tt>PREFIX</tt> only worked due to a Debian-local patch.
+  </item>
 </taglist></p>
 
 <sect> Version 3.8.4.0