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

[Anton Shterenlikht]

The following reply was made to PR docs/137762; it has been noted by GNATS.

From: Anton Shterenlikht <mexas at bristol.ac.uk>
To: Warren Block <wblock at wonkity.com>, bug-followup at freebsd.org
Cc:  
Subject: Re: docs/137762: [handbook] proposed: mention "make delete-old" in
 sec 24.7 Rebuilding World
Date: Tue, 14 Sep 2010 13:32:07 +0100

 > Looks good!  The only thing I see is the indentation on the final
 > </sect1> needs to match the opening <sect1>.  Thanks for your patience!
 >
 
 fixed:
 
 
 *** /doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	2010-08-29 14:42:49.000000000 +0100
 --- ./chapter.sgml	2010-09-14 13:26:06.000000000 +0100
 ***************
 *** 3029,3034 ****
 --- 3029,3081 ----
       </sect2>
     </sect1>
   
 +   <sect1 id="make-delete-old">
 +     <sect1info>
 +       <authorgroup>
 + 	<author>
 + 	  <firstname>Anton</firstname>
 + 	  <surname>Shterenlikht</surname>
 + 	  <contrib>Based on notes provided by </contrib>
 + 	</author>
 +       </authorgroup>
 +     </sect1info>
 +     <title>Deleting obsolete files, directories and libraries</title>
 +     <indexterm><primary>Deleting obsolete files, directories and libraries</primary></indexterm>
 +     <para>Remove obsolete files to prevent problems.</para>
 +     <para>Check for obsolete files:</para>
 +     <screen>&prompt.root; <userinput>cd /usr/src</userinput>
 + &prompt.root; <userinput>make check-old</userinput>
 + &prompt.root; <userinput>make check-old-libs</userinput></screen>
 +     <para>If any obsolete files are found, they can be deleted with</para>
 +     <screen>&prompt.root; <userinput>make delete-old</userinput>
 + &prompt.root; <userinput>make delete-old-libs</userinput></screen>
 +     <tip>
 +       <para>See <filename>/usr/src/Makefile</filename>
 +         for more targets of interest.</para>
 +     </tip>
 +     <para>A prompt is displayed before deleting each obsolete file.</para>
 +     <warning>
 +       <title>Warning</title>
 +         <para>Deleting obsolete files will break applications that still
 +           depend on those obsolete files.</para>
 +     </warning>
 +     <para>Utilities for checking shared library dependencies are available
 +       in <filename role="package">sysutils/libchk</filename>
 +       or <filename role="package">sysutils/bsdadminscripts</filename>.</para>
 +     <para>Obsolete shared libraries can conflict with newer libraries,
 +       causing messages like these:</para>
 +     <screen>/usr/bin/ld: warning: libz.so.4, needed by /usr/local/lib/libtiff.so, may conflict with libz.so.5
 + /usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5</screen>
 +     <para>To solve these problems, determine which port installed the library:</para>
 +     <screen>&prompt.root; <userinput>pkg_info -W  /usr/local/lib/libtiff.so</userinput>
 + /usr/local/lib/libtiff.so was installed by package tiff-3.9.4
 + &prompt.root; <userinput>pkg_info -W /usr/local/lib/libXext.so</userinput>
 + /usr/local/lib/libXext.so was installed by package libXext-1.1.1,1</screen>
 +     <para>Then deinstall, rebuild and reinstall the port. The
 +       <filename role="package">ports-mgmt/portmaster</filename>
 +       utility can be used to automate this process.</para>
 +   </sect1>
 + 
     <sect1 id="small-lan">
       <sect1info>
         <authorgroup>
 
 
 -- 
 Anton Shterenlikht
 Room 2.6, Queen's Building
 Mech Eng Dept
 Bristol University
 University Walk, Bristol BS8 1TR, UK
 Tel: +44 (0)117 331 5944
 Fax: +44 (0)117 929 4423