From owner-freebsd-doc@FreeBSD.ORG Mon Apr 17 23:10:17 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D34E016A409 for ; Mon, 17 Apr 2006 23:10:17 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 691C543D45 for ; Mon, 17 Apr 2006 23:10:16 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k3HNAGod089591 for ; Mon, 17 Apr 2006 23:10:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k3HNAGN2089590; Mon, 17 Apr 2006 23:10:16 GMT (envelope-from gnats) Resent-Date: Mon, 17 Apr 2006 23:10:16 GMT Resent-Message-Id: <200604172310.k3HNAGN2089590@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7793216A400 for ; 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 ; 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 ; 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: To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/95975: Documentation in /usr/src/Makefile out of date X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: dpk@dpk.net List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 17 Apr 2006 23:10:18 -0000 >Number: 95975 >Category: docs >Synopsis: Documentation in /usr/src/Makefile out of date >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Apr 17 23:10:15 GMT 2006 >Closed-Date: >Last-Modified: >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: >Unformatted: