[99866] trunk/doc-new/guide/xml/project.xml

[ryandesign at macports.org]

Revision: 99866
          https://trac.macports.org/changeset/99866
Author:   ryandesign at macports.org
Date:     2012-11-19 13:31:45 -0800 (Mon, 19 Nov 2012)
Log Message:
-----------
project.xml: ask users to clean and try again before filing a ticket

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

Modified: trunk/doc-new/guide/xml/project.xml
===================================================================
--- trunk/doc-new/guide/xml/project.xml	2012-11-19 21:10:26 UTC (rev 99865)
+++ trunk/doc-new/guide/xml/project.xml	2012-11-19 21:31:45 UTC (rev 99866)
@@ -21,8 +21,21 @@
 
       <itemizedlist>
         <listitem>
-          <para>Check the Problem HotList</para>
+          <para>Clean and try again</para>
           <para>
+            If a build fails or is otherwise interrupted, and you try again,
+            MacPorts tries to pick up where it left off. Sometimes this causes
+            new problems, and even if it doesn't, it means that log messages
+            from earlier steps, which can be essential for figuring out why a
+            build failed, are not included in the new log; MacPorts prints
+            "Skipping completed" in the log for each previously-completed phase
+            that was skipped. Before filing a ticket, "sudo port clean" the
+            port that failed, then try again.
+          </para>
+        </listitem>
+        <listitem>
+          <para>Check the problem hotlist</para>
+          <para>
             The <ulink
               url="https://trac.macports.org/wiki/ProblemHotlist">Problem
               Hotlist</ulink> contains possible solutions to problems that
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20121119/90d704fc/attachment.html>