From scottro@scottro.net  Sun Jul 17 17:14:50 2005
Return-Path: <scottro@scottro.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 34A3316A41C
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 17 Jul 2005 17:14:50 +0000 (GMT)
	(envelope-from scottro@scottro.net)
Received: from ms-smtp-01.rdc-nyc.rr.com (ms-smtp-01-smtplb.rdc-nyc.rr.com [24.29.109.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D087B43D46
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 17 Jul 2005 17:14:49 +0000 (GMT)
	(envelope-from scottro@scottro.net)
Received: from mail.scottro.net (cpe-68-175-68-211.nyc.res.rr.com [68.175.68.211])
	by ms-smtp-01.rdc-nyc.rr.com (8.12.10/8.12.7) with ESMTP id j6HHElT3014276
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 17 Jul 2005 13:14:47 -0400 (EDT)
Received: by mail.scottro.net (Postfix, from userid 1001)
	id ED70240D0; Sun, 17 Jul 2005 13:14:46 -0400 (EDT)
Message-Id: <20050717171446.ED70240D0@mail.scottro.net>
Date: Sun, 17 Jul 2005 13:14:46 -0400 (EDT)
From: Scott@scottro.net, Robbins@scottro.net
Reply-To: scottro@nyc.rr.com
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: p	patch: Minor omissions in /usr/src/UPDATING
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         83621
>Category:       docs
>Synopsis:       [patch]: Minor omissions in /usr/src/UPDATING
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 17 17:20:12 GMT 2005
>Closed-Date:    Tue Jan 22 15:09:06 UTC 2008
>Last-Modified:  Tue Jan 22 15:10:02 UTC 2008
>Originator:     Scott Robbins <scottro@nyc.rr.com>
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD mail.scottro.net 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Sun Jul 17 11:02:38 EDT 2005 root@mail.scottro.net:/usr/obj/usr/src/sys/S11 i386


	
>Description:
	/usr/src/UPDATING, although mentioning that disabling malloc debugging 
	flags will improve performance, doesn't give the method to do so.  
	Therefore, the question often comes up on the mailing lists.
	Additionally, UPDATING doesn't mention the relatively new 
	make cleanworld target.  (The handbook doesn't either.)  
>How-To-Repeat:
>Fix:

--- UPDATING	Sun Jul 17 12:49:19 2005
+++ UPDATING.new	Sun Jul 17 12:59:12 2005
@@ -19,7 +19,8 @@
 	related kernel options, INVARIANTS, malloc debugging flags
 	in userland, and various verbose features in the kernel.  Many
 	developers choose to disable these features on build machines
-	to maximize performance.
+	to maximize performance.  (To disable malloc debugging, 
+	ln -s aj /etc/malloc.conf)
 
 20050711:
 	RELENG_6 branched here.
@@ -227,6 +228,10 @@
 	prefix all make commands with 'env -i '.  See the env(1) manual
 	page for more details.
 
+	As of FreeBSD-5.x there is now a make cleanworld target.  This
+	This removes the cruft of previous builds from /usr/obj.
+
+
 	To build a kernel
 	-----------------
 	If you are updating from a prior version of FreeBSD (even one just
@@ -264,6 +269,7 @@
 	# is listed here if you are upgrading from a really old current.
 
 	<make sure you have good level 0 dumps>
+	make cleanworld
 	make buildworld
 	make kernel KERNCONF=YOUR_KERNEL_HERE
 							[1]
@@ -301,6 +307,7 @@
 	To upgrade in-place from 5.x-stable to current
 	----------------------------------------------
 	<make sure you have good level 0 dumps>
+	make cleanworld
 	make buildworld					[9]
 	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
 							[1]


	
Err, google?


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Jan 22 15:05:40 UTC 2008 
State-Changed-Why:  
The comment about disabling malloc flags was merged into CURRENT; however, the 
cleanworld target did not get merged.  The cleandir target works fine and 
cleanworld is already documented in build.7.  As far as I know, it's not a 
required step.  Thanks for the submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Jan 22 15:05:40 UTC 2008 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=83621 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/83621: commit references a PR
Date: Tue, 22 Jan 2008 15:05:38 +0000 (UTC)

 trhodes     2008-01-22 15:05:22 UTC
 
   FreeBSD src repository
 
   Modified files:
     .                    UPDATING 
   Log:
   Quick note on how to disable malloc debugging in the top entry in this file.
   
   PR:             83621
   Submitted by:   Scott Robbins <scottro@nyc.rr.com> (original version)
   Reviewed by:    imp
   
   Revision  Changes    Path
   1.515     +2 -1      src/UPDATING
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
