From owner-freebsd-doc  Tue Nov  6 10:10:14 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 37C3537B41A
	for <freebsd-doc@freebsd.org>; Tue,  6 Nov 2001 10:10:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA6IA1868361;
	Tue, 6 Nov 2001 10:10:01 -0800 (PST)
	(envelope-from gnats)
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id E5B7E37B416
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  6 Nov 2001 10:08:33 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id NAA96675;
	Tue, 6 Nov 2001 13:08:33 -0500 (EST)
	(envelope-from mwlucas)
Message-Id: <200111061808.NAA96675@blackhelicopters.org>
Date: Tue, 6 Nov 2001 13:08:33 -0500 (EST)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/31803: Handbook make world addition
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         31803
>Category:       docs
>Synopsis:       Handbook make world addition
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 06 10:10:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

current -doc tree

>Description:

Explanation of common steps to take when make world fails.  This crops
up every so often.

taken from email by:  cjc@freebsd.org

>How-To-Repeat:


>Fix:


*** en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml-dist	Tue Nov  6 12:36:21 2001
--- en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	Tue Nov  6 13:05:08 2001
***************
*** 1580,1585 ****
--- 1580,1612 ----
  	    </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>cd /usr/obj</userinput>
+ &prompt.root; <userinput>chflags -R noschg *</userinput>
+ &prompt.root; <userinput>rm -rf *</userinput>
+ &prompt.root; <userinput>cd /usr/src</userinput>
+ &prompt.root; <userinput>make cleandir</userinput>
+ &prompt.root; <userinput>make cleandir</userinput></screen>
+ 
+             <para>Then restart the whole process, starting
+               with<command> <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>
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message