Perl: Recommend DESTDIR instead of PREFIX with Makefile.PL

Packages using Makefile.PL should use DESTDIR rather than PREFIX
to install into the package staging area.  PREFIX only worked due
to a Debian-local patch.

diff --git a/debian/changelog b/debian/changelog
index c74d05275acf67839fb0a1d56d0c2d3fd30ad0d8..25c429ee9fa6d92e8dd4da4fd6a06d3a3913ebb4 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -51,6 +51,11 @@ debian-policy (3.8.5.0) UNRELEASED; urgency=low
     Seconded: Brendan O'Dea <bod@debian.org>
     Seconded: Damyan Ivanov <dmn@debian.org>
     Closes: #579457
+  * Perl Policy: Recommend DESTDIR instead of PREFIX with Makefile.PL
+    Wording: Niko Tyni <ntyni@debian.org>
+    Seconded: Russ Allbery <rra@debian.org>
+    Seconded: Raphael Hertzog <hertzog@debian.org>
+    Closes: #579461
   * 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 58c33328fb8eec1aea378294862c3df1cc79cc5c..4f34758e8f458aeb0248f575dd4a548dccb4523b 100644 (file)
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -316,7 +316,7 @@ $(MAKE) OPTIMIZE="-O2 -g -Wall"
          </example>
          and this one to install the results into the temporary tree:
          <example>
-$(MAKE) install PREFIX=$(CURDIR)/debian/&lt;tmp&gt;/usr
+$(MAKE) install DESTDIR=$(CURDIR)/debian/&lt;tmp&gt;
          </example><footnote>
            <p>Replace &lt;tmp&gt; with the appropriate directory
            (nominally just tmp)</p>

diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 639e1171152efbe7d5e97c68565ba041d6923950..f58d9e6ed23ea06ba9b0552718a160022a6137ce 100644 (file)
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -67,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