From: Russ Allbery <rra@debian.org>
Date: Fri, 4 Jun 2010 16:24:20 +0000 (-0700)
Subject: Perl: Recommend DESTDIR instead of PREFIX with Makefile.PL
X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=commitdiff_plain;h=f89783dabbfed9db41daa96a6cbca081ebaaf372

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 c74d052..25c429e 100644
--- 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 58c3332..4f34758 100644
--- 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 639e117..f58d9e6 100644
--- 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