From mwlucas@blackhelicopters.org  Tue Nov  6 10:08:34 2001
Return-Path: <mwlucas@blackhelicopters.org>
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
Subject: Handbook make world addition
X-Send-Pr-Version: 3.2

>Number:         31803
>Category:       docs
>Synopsis:       Handbook make world addition
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 06 10:10:01 PST 2001
>Closed-Date:    Tue Nov 13 16:10:16 PST 2001
>Last-Modified:  Tue Nov 13 16:11:26 PST 2001
>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:

From: Ceri <ceri@techsupport.co.uk>
To: mwlucas@blackhelicopters.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31803: Handbook make world addition
Date: Tue, 6 Nov 2001 18:15:04 +0000

 On Tue, Nov 06, 2001 at 01:08:33PM -0500, mwlucas@blackhelicopters.org said:
 
 > + &prompt.root; <userinput>make cleandir</userinput>
 > + &prompt.root; <userinput>make cleandir</userinput></screen>
 
 I think it would be worth an additional note stating that this step
 is intended to be repeated.
 
 Ceri
 
 -- 
 I probably wouldn't like you. Really.
 I really probably wouldn't like you.

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: Ceri <ceri@techsupport.co.uk>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31803: Handbook make world addition
Date: Tue, 6 Nov 2001 13:30:43 -0500

 On Tue, Nov 06, 2001 at 06:15:04PM +0000, Ceri wrote:
 > I think it would be worth an additional note stating that this step
 > is intended to be repeated.
 
 But our users really do type everything in exactly as they're told,
 don't they?  ;-)
 
 Good idea, how's this?
 
 
 *** 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:29:19 2001
 ***************
 *** 1580,1585 ****
 --- 1580,1615 ----
   	    </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>Yes, <command>make cleandir</command> really should
 +               be run twice.</para>
 + 
 +             <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>
 
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons

From: Ceri <ceri@techsupport.co.uk>
To: Michael Lucas <mwlucas@blackhelicopters.org>
Cc: freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/31803: Handbook make world addition
Date: Tue, 6 Nov 2001 19:00:10 +0000

 On Tue, Nov 06, 2001 at 10:40:02AM -0800, Michael Lucas said:
 >  
 >  Good idea, how's this?
 
 Looks good to me.
 
 Ceri
 

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: Giorgos Keramidas <charon@labs.gr>
Cc: freebsd-doc@FreeBSD.ORG, freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/31803: Handbook make world addition
Date: Tue, 6 Nov 2001 19:06:26 -0500

 --ikeVEW9yuYc//A+q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 > Play safe here.  Don't suggest commands that contain wildcard
 > characters, since Bad Things(TM) can happen if someone runs the
 > commands and somehow ``fails'' to change to the proper directory.
 
 You know, I give you people something for free, and you just gripe.  :)
 How's this?
 
 ==ml
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons
 
 --ikeVEW9yuYc//A+q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename=build-errors
 
 *** 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:29:19 2001
 ***************
 *** 1580,1585 ****
 --- 1580,1615 ----
   	    </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>Yes, <command>make cleandir</command> really should
 +               be run twice.</para>
 + 
 +             <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>
 
 --ikeVEW9yuYc//A+q--

From: Munehiro Matsuda <haro@tt.kubota.co.jp>
To: freebsd-gnats-submit@FreeBSD.org, mwlucas@blackhelicopters.org
Cc:  
Subject: Re: docs/31803: Handbook make world addition
Date: Wed, 07 Nov 2001 12:51:24 +0900

 > +             <screen>&prompt.root; <userinput>cd /usr/obj</userinput>
 > + &prompt.root; <userinput>chflags -R noschg *</userinput>
 > + &prompt.root; <userinput>rm -rf *</userinput>
 
 I've heard that doing following command is much more faster, than the above.
    cd /usr/obj
    rm -rf *
    chflags -R noschg *
    rm -rf *
 
 Just my $0.02,
   Haro
 =-----------------------------------------------------------------------
            _ _    Munehiro (haro) Matsuda
  -|- /_\  |_|_|   e-Collaboration Group, Kubota Graphics Technology Inc.
  /|\ |_|  |_|_|   2-8-8 Shinjuku, Shinjuku-ku Tokyo 160-0022, Japan
                   Tel: +81-3-3225-0936  Fax: +81-3-3225-0740
                   Email: haro@kubota.co.jp

From: Michael Lucas <mwlucas@blackhelicopters.org>
To: haro@kubota.co.jp
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/31803: Handbook make world addition
Date: Wed, 7 Nov 2001 07:44:09 -0500

 On Wed, Nov 07, 2001 at 12:51:24PM +0900, Munehiro Matsuda wrote:
 > > +             <screen>&prompt.root; <userinput>cd /usr/obj</userinput>
 > > + &prompt.root; <userinput>chflags -R noschg *</userinput>
 > > + &prompt.root; <userinput>rm -rf *</userinput>
 > 
 > I've heard that doing following command is much more faster, than the above.
 >    cd /usr/obj
 >    rm -rf *
 >    chflags -R noschg *
 >    rm -rf *
 
 It is faster, but it's (IMHO) not always as correct.
 
 First, I've redone the patch at multiple requests to eliminate the
 wildcards.  It's been pointed out that "rm -rf *" isn't a good thing
 to recommend.
 
 Under earlier versions of FreeBSD, some files in /usr/obj were marked
 noschg.  A user could use your example to delete the tree if he didn't
 care about the errors.
 
 Under newer versions of FreeBSD, /usr/obj has no schg files.  The
 first rm -rf will delete the whole tree, and the other commands will
 either generate errors or have no effect.
 
 I'm trying to write a single entry that covers all versions of
 FreeBSD.  More experienced readers will easily understand that we're
 telling them to remove /usr/obj/usr by any means necessary, and will
 use their preferred method to do so.
 
 ==ml
 
 -- 
 Michael Lucas
 mwlucas@blackhelicopters.org
 http://www.blackhelicopters.org/~mwlucas/
 Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons
State-Changed-From-To: open->closed 
State-Changed-By: bmah 
State-Changed-When: Tue Nov 13 16:10:16 PST 2001 
State-Changed-Why:  
Committed, per version of patch posted to -doc.  Gracias! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31803 
>Unformatted:
