[46783] trunk/doc-new/guide/xml/portfile-phase.xml

[markd at macports.org]

Revision: 46783
          http://trac.macports.org/changeset/46783
Author:   markd at macports.org
Date:     2009-02-12 18:07:00 -0800 (Thu, 12 Feb 2009)
Log Message:
-----------
Add a link that explains DESTDIR well to a note.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-phase.xml

Modified: trunk/doc-new/guide/xml/portfile-phase.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-phase.xml	2009-02-13 00:51:07 UTC (rev 46782)
+++ trunk/doc-new/guide/xml/portfile-phase.xml	2009-02-13 02:07:00 UTC (rev 46783)
@@ -94,6 +94,16 @@
           <varname>DESTDIR=${destroot}</varname>in
           <varname>${worksrcpath}</varname>.</para>
 
+          <note>
+            <para>Using a <ulink
+            url="http://www.gnu.org/prep/standards/html_node/DESTDIR.html"><varname>DESTDIR</varname>
+            variable</ulink> is a part of standard GNU coding practices, and
+            this variable must be supported in an application's install
+            routines for MacPorts' destroot phase to work without manual
+            Portfile scripting or source patching. Urge developers to fully
+            support <varname>DESTDIR</varname> in their applications.</para>
+          </note>
+
           <para>Understanding the destroot phase is critical to understanding
           MacPorts, because, unlike some port systems, MacPorts "stages" an
           installation into an intermediate location —not the final file
@@ -115,13 +125,6 @@
             </listitem>
           </itemizedlist>
 
-          <note>
-            <para>The <varname>DESTDIR</varname> variable must be supported in
-            an application's Makefile for the MacPorts destroot phase to work
-            properly. Urge developers to fully support
-            <varname>DESTDIR</varname> in their Makefiles.</para>
-          </note>
-
           <para>Any empty directories in <varname>${destroot}</varname> upon
           completion of the destroot phase are removed unless a directory name
           is placed in the value field of the optional
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090212/dd3ff7de/attachment.html>