From owner-freebsd-stable  Wed Nov  7  5: 4:45 2001
Delivered-To: freebsd-stable@freebsd.org
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id 12FB537B405
	for <freebsd-stable@FreeBSD.ORG>; Wed,  7 Nov 2001 05:04:41 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id IAA01009;
	Wed, 7 Nov 2001 08:04:33 -0500 (EST)
	(envelope-from mwlucas)
Date: Wed, 7 Nov 2001 08:04:33 -0500
From: Michael Lucas <mwlucas@blackhelicopters.org>
To: Marcel Moolenaar <marcel@xcllnt.net>
Cc: cjclark@alum.mit.edu, Larry Rosenman <ler@lerctr.org>,
	freebsd-stable@FreeBSD.ORG
Subject: Re: Cleaning /usr/obj
Message-ID: <20011107080433.A942@blackhelicopters.org>
References: <200111060218.fA62ILs61502@freefall.freebsd.org> <20011105215308.A11461@lerami.lerctr.org> <20011105195947.A2591@dhcp01.pn.xcllnt.net> <20011106014026.A23162@lerami.lerctr.org> <20011106014651.D2494@blossom.cjclark.org> <20011106051432.A3878@lerami.lerctr.org> <20011106122327.A6685@kayak.xcllnt.net> <20011106130859.B386@blossom.cjclark.org> <20011106165053.A7262@kayak.xcllnt.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20011106165053.A7262@kayak.xcllnt.net>; from marcel@xcllnt.net on Tue, Nov 06, 2001 at 04:50:53PM -0800
Sender: owner-freebsd-stable@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-stable.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-stable>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-stable>
X-Loop: FreeBSD.ORG

On Tue, Nov 06, 2001 at 04:50:53PM -0800, Marcel Moolenaar wrote:
> > The Handbook has long said,
> > 
> >   19.4.5 Remove /usr/obj
> > 
> >   [snip]
> > 
> >   You can speed up the ``make world'' process, and possibly save
> >   yourself some dependency headaches by removing this directory as 
> >   well.
> 
> The documentation is stale for a long time :-)

I just submitted a PR doc/31803 to add "what happens if I have
problems?" that includes explicitly blowing away /usr/obj and doing
make cleandir twice.  It's been discussed on -doc and updated a few
times to answer people's objections.  Here's the latest:

*** 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	Wed Nov  7 07:28:14 2001
***************
*** 1580,1585 ****
--- 1580,1614 ----
  	    </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>


==ml

-- 
Michael Lucas
mwlucas@blackhelicopters.org
http://www.blackhelicopters.org/~mwlucas/
Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons

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