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: Mon, 13 Sep 2010 16:50:32 +0100

 Warren, sorry for the delay, and many thanks for your comments.
 
 Here's a new separate section, very short:
 
 http://seis.bris.ac.uk/~mexas/make-delete-old.html
 
 Here's the patch:
 
 
 *** /usr/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	2010-08-29 14:42:49.000000000 +0100
 --- ./chapter.sgml	2010-09-13 16:39:41.000000000 +0100
 ***************
 *** 3029,3034 ****
 --- 3029,3084 ----
       </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.
 +           Be particularly cautious about deleting shared libraries,
 +           which some applications may still depend on.</para>
 +        <warning>
 +          <title>Warning</title>
 +            <para>Deleting obsolete files will break applications that still
 +              depend on those obsolete files.</para>
 +        </warning>
 +         <para>Utilities 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