docs/137762: [handbook] proposed: mention "make delete-old" in sec 24.7 Rebuilding World

[Anton Shterenlikht]

>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 at 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: