[27990] trunk/doc/guide/new/xml/portfileref.xml

[source_changes at macosforge.org]

Revision: 27990
          http://trac.macosforge.org/projects/macports/changeset/27990
Author:   markd at macports.org
Date:     2007-08-17 00:02:16 -0700 (Fri, 17 Aug 2007)

Log Message:
-----------
Add some missing destroot keywords.

Modified Paths:
--------------
    trunk/doc/guide/new/xml/portfileref.xml

Modified: trunk/doc/guide/new/xml/portfileref.xml
===================================================================
--- trunk/doc/guide/new/xml/portfileref.xml	2007-08-17 06:21:53 UTC (rev 27989)
+++ trunk/doc/guide/new/xml/portfileref.xml	2007-08-17 07:02:16 UTC (rev 27990)
@@ -103,6 +103,12 @@
         properly. Urge developers to fully support
         <varname>$(DESTDIR)</varname> in their Makefiles.</para>
       </note>
+
+      <para>At the beginning of the destroot phase, all the directories in the
+      file <filename>${prefix}/etc/macports/prefix.mtree</filename> are
+      created. Any directories still empty upon completion of the destroot
+      phase are removed unless a directory is listed using a destroot.keepdirs
+      keyword.</para>
     </section>
 
     <section>
@@ -1565,6 +1571,32 @@
             </note>
           </listitem>
         </varlistentry>
+
+        <varlistentry>
+          <term>destroot.keepdirs</term>
+
+          <listitem>
+            <para>A list of directories that should not be removed if empty
+            upon destroot completion.</para>
+
+            <programlisting>destroot.keepdirs \
+                ${destroot}${prefix}/var/run \
+                ${destroot}${prefix}/var/log \
+                ${destroot}${prefix}/var/cache/mrtg</programlisting>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term>destroot.violate_mtree</term>
+
+          <listitem>
+            <para>MacPorts tests for compliance to the common directory
+            structure in ${prefix}; the default is "no". If a port is not
+            compliant with the standard, set it to "yes".</para>
+
+            <programlisting>destroot.violate_mtree    yes</programlisting>
+          </listitem>
+        </varlistentry>
       </variablelist>
     </section>
   </section>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20070817/35847b39/attachment.html