diff --git a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
index 28686305e4..0218f9d96c 100644
--- a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
@@ -1874,12 +1874,31 @@ Fetching 133 new ports or files... done.
now that the new world is on disk.
+
+ make
+ delete-old
+
+ This target deletes old (obsolete) files. This is important
+ because sometimes they cause problems if left on the disk, for
+ example the presence of the old utmp.h
+ causes problems in some ports when the new
+ utmpx.h is installed.
+
+
Reboot.
A full machine reboot is needed now to load the new
kernel and new world with new configuration files.
+
+
+ make delete-old-libs
+
+ Remove any obsolete libraries to avoid conflicts with newer
+ ones. Make sure that all ports have been rebuilt
+ before old libraries are removed.
+
Upgrades from one release of the same &os; branch to a
@@ -1935,7 +1954,9 @@ Fetching 133 new ports or files... done.
&prompt.root; cd /usr/src
&prompt.root; make installworld
&prompt.root; mergemaster
-&prompt.root; reboot
+&prompt.root; make delete-old
+&prompt.root; reboot
+&prompt.root; make delete-old-libs
Read Further Explanations
@@ -2640,11 +2661,10 @@ Script done, …
- Deleting Obsolete Files, Directories and Libraries
+ Deleting Obsolete Files and Directories
- Deleting obsolete files, directories and
- libraries
+ Deleting obsolete files and directories
As a part of the &os; development lifecycle, files and their
@@ -2663,15 +2683,14 @@ Script done, …
The following instructions should be used to remove obsolete
files during the system upgrade process.
- Follow the steps outlined in . After the
- make installworld
+ After the make
+ installworld
and the subsequent mergemaster have finished
successfully, check for obsolete files and libraries as
follows:
&prompt.root; cd /usr/src
- &prompt.root; make check-old
+&prompt.root; make check-old
If any obsolete files are found, they can be deleted using
the following command:
@@ -2705,7 +2724,7 @@ Script done, …
&prompt.root; shutdown -r now
-
+
Deleting obsolete libraries
@@ -2729,7 +2748,7 @@ Script done, …
causing messages like these:
/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
+/usr/bin/ld: warning: librpcsvc.so.4, needed by /usr/local/lib/libXext.so, may conflict with librpcsvc.so.5
To solve these problems, determine which port installed the
library: