From owner-freebsd-doc@FreeBSD.ORG Fri Aug 14 11:40:08 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B7DA91065692 for ; Fri, 14 Aug 2009 11:40:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8AAFB8FC6C for ; Fri, 14 Aug 2009 11:40:08 +0000 (UTC) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n7EBe69S051578 for ; Fri, 14 Aug 2009 11:40:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n7EBe6UR051577; Fri, 14 Aug 2009 11:40:06 GMT (envelope-from gnats) Resent-Date: Fri, 14 Aug 2009 11:40:06 GMT Resent-Message-Id: <200908141140.n7EBe6UR051577@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, Anton Shterenlikht Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7A2D1106568B for ; Fri, 14 Aug 2009 11:33:37 +0000 (UTC) (envelope-from mexas@bristol.ac.uk) Received: from dirj.bris.ac.uk (dirj.bris.ac.uk [137.222.10.78]) by mx1.freebsd.org (Postfix) with ESMTP id 3AFCE8FC41 for ; Fri, 14 Aug 2009 11:33:37 +0000 (UTC) Received: from seis.bris.ac.uk ([137.222.10.93]) by dirj.bris.ac.uk with esmtp (Exim 4.69) (envelope-from ) id 1Mbv2M-0001tL-4s for FreeBSD-gnats-submit@freebsd.org; Fri, 14 Aug 2009 12:33:36 +0100 Received: from mech-cluster241.men.bris.ac.uk ([137.222.187.241]) by seis.bris.ac.uk with esmtp (Exim 4.67) (envelope-from ) id 1Mbv2L-0000o4-JU for FreeBSD-gnats-submit@freebsd.org; Fri, 14 Aug 2009 12:33:33 +0100 Received: from mech-cluster241.men.bris.ac.uk (localhost [127.0.0.1]) by mech-cluster241.men.bris.ac.uk (8.14.3/8.14.3) with ESMTP id n7EBXXTw066186 for ; Fri, 14 Aug 2009 12:33:33 +0100 (BST) (envelope-from mexas@mech-cluster241.men.bris.ac.uk) Received: (from mexas@localhost) by mech-cluster241.men.bris.ac.uk (8.14.3/8.14.3/Submit) id n7EBXXHq066185; Fri, 14 Aug 2009 12:33:33 +0100 (BST) (envelope-from mexas) Message-Id: <200908141133.n7EBXXHq066185@mech-cluster241.men.bris.ac.uk> Date: Fri, 14 Aug 2009 12:33:33 +0100 (BST) From: Anton Shterenlikht To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/137762: [handbook] proposed: mention "make delete-old" in sec 24.7 Rebuilding World X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Anton Shterenlikht List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Aug 2009 11:40:08 -0000 >Number: 137762 >Category: docs >Synopsis: [handbook] proposed: mention "make delete-old" in sec 24.7 Rebuilding World >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Aug 14 11:40:06 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Anton Shterenlikht >Release: FreeBSD 8.0-BETA2 ia64 >Organization: University of Bristol, UK >Environment: System: FreeBSD mech-cluster241.men.bris.ac.uk 8.0-BETA2 FreeBSD 8.0-BETA2 #1: Wed Aug 12 12:42:09 BST 2009 mexas@mech-cluster241.men.bris.ac.uk:/usr/obj/usr/src/sys/TZAV ia64 >Description: In section 24.7 "rebuilding world" of the handbook no mention is made of these useful, or even essential, /usr/src/Makefile targets: # delete-old - Delete obsolete directories/files/libraries. # delete-old-dirs - Delete obsolete directories. # delete-old-files - Delete obsolete files. # delete-old-libs - Delete obsolete libraries. This seems to be an important omission, as not running "make delete-old" or "make delete-old-libs" can result in warnings like these: /usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may confli ct with libz.so.5 /usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may c onflict with librpcsvc.so.5 or build failures in ports, or various other inconsistencies. I volunteer to write a paragraph or two about this somewhere in section 24.7. Any comments? >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: