From 12edac9ef8492c9bc85bb4b757c092e4c964dcba Mon Sep 17 00:00:00 2001
From: "Bruce A. Mah" <bmah@FreeBSD.org>
Date: Wed, 14 Nov 2001 00:10:38 +0000
Subject: [PATCH] Add "what do I do if something goes wrong during buildworld"
 FAQ to cutting-edge chapter.

PR:		31803
Submitted by:	mwlucas@blackhelicopters.org
---
 .../books/handbook/cutting-edge/chapter.sgml  | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
index 54f0eb3599..d80b9396b6 100644
--- a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
@@ -1580,6 +1580,35 @@ Building everything..
 	    </itemizedlist>
 	  </answer>
 	</qandaentry>
+
+        <qandaentry>
+          <question>
+            <para>What do I do if something goes wrong?</para>
+          </question>
+
+          <answer>
+            <para>Make absolutely sure your environment has no
+              extraneous cruft from earlier builds.  This is simple
+              enough.</para>
+
+            <screen>&prompt.root; <userinput>chflags -R noschg /usr/obj/usr</userinput>
+&prompt.root; <userinput>rm -rf /usr/obj/usr</userinput>
+&prompt.root; <userinput>cd /usr/src</userinput>
+&prompt.root; <userinput>make cleandir</userinput>
+&prompt.root; <userinput>make cleandir</userinput></screen>
+
+            <para>Yes, <command>make cleandir</command> really should
+              be run twice.</para>
+
+            <para>Then restart the whole process, starting
+              with <command>make buildworld</command>.</para>
+
+            <para>If you still have problems, send the error and the
+              output of <command>uname -a</command>to &a.questions;.
+              Be prepared to answer other questions about your
+              setup!</para>
+          </answer>
+        </qandaentry>
       </qandaset>
     </sect2>
   </sect1>