From root@dpk2.hosting.flyingcroc.net  Mon Apr 17 23:10:00 2006
Return-Path: <root@dpk2.hosting.flyingcroc.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7793216A400
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 17 Apr 2006 23:10:00 +0000 (UTC)
	(envelope-from root@dpk2.hosting.flyingcroc.net)
Received: from dpk2.hosting.flyingcroc.net (dpk2.hosting.flyingcroc.net [207.66.130.77])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7FFF743D48
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 17 Apr 2006 23:09:59 +0000 (GMT)
	(envelope-from root@dpk2.hosting.flyingcroc.net)
Received: from dpk2.hosting.flyingcroc.net (localhost [127.0.0.1])
	by dpk2.hosting.flyingcroc.net (8.13.4/8.13.4) with ESMTP id k3HLTuew000727
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 17 Apr 2006 14:29:57 -0700 (PDT)
	(envelope-from root@dpk2.hosting.flyingcroc.net)
Received: (from root@localhost)
	by dpk2.hosting.flyingcroc.net (8.13.4/8.13.4/Submit) id k3HLTuf6000726;
	Mon, 17 Apr 2006 14:29:56 -0700 (PDT)
	(envelope-from root)
Message-Id: <200604172129.k3HLTuf6000726@dpk2.hosting.flyingcroc.net>
Date: Mon, 17 Apr 2006 14:29:56 -0700 (PDT)
From: <dpk@dpk.net>
Reply-To: <dpk@dpk.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Documentation in /usr/src/Makefile out of date
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         95975
>Category:       docs
>Synopsis:       Documentation in /usr/src/Makefile out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 17 23:10:15 GMT 2006
>Closed-Date:    Fri Nov 03 10:46:56 GMT 2006
>Last-Modified:  Fri Nov 03 10:46:56 GMT 2006
>Originator:     David Kirchner
>Release:        FreeBSD 6.0-RELEASE i386
>Organization:
None
>Environment:
System: FreeBSD dpk2.hosting.flyingcroc.net 6.0-RELEASE FreeBSD 6.0-RELEASE #0: Thu Nov 3 09:36:13 UTC 2005 root@x64.samsco.home:/usr/obj/usr/src/sys/GENERIC i386

>Description:
	The README file in /usr/src suggests that the most commonly used
target for 'make' is 'world', and instructs the user to read the Makefile
to learn how to rebuild their world.

The Makefile then suggests that the user simply run:

cd /usr/src
make world

However, this bails with an error suggesting that they're going about this
the wrong way:

bash-2.05b# make world
WARNING: make world will overwrite your existing FreeBSD
installation without also building and installing a new
kernel.  This can be dangerous.  Please read the handbook,
'Rebuilding world', for how to upgrade your system.
Define DESTDIR to where you want to install FreeBSD,
including /, to override this warning and proceed as usual.
You may get the historical 'make world' behavior by defining
HISTORICAL_MAKE_WORLD.  You should understand the implications
before doing this.

Bailing out now...
*** Error code 1

>How-To-Repeat:
	NA
>Fix:
	The documentation in README and Makefile should probably include
the URL to the handbook section that describes "Rebuilding world":

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html

or simply not mention the "world" target at all.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Jun 6 19:44:20 UTC 2006 
Responsible-Changed-Why:  
Mine! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=95975 
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Wed Jun 7 04:01:01 UTC 2006 
State-Changed-Why:  
Made some changes to the README and Makefile, should be good. 
Thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=95975 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Fri Nov 3 10:46:24 UTC 2006 
State-Changed-Why:  
This was handled by myself and one of our senior developers, 
Warner.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=95975 
>Unformatted:
