*** /doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml	Sun Aug 29 14:42:49 2010
--- ./chapter.sgml	Fri Nov  5 13:05:37 2010
***************
*** 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>