From owner-svn-doc-all@FreeBSD.ORG Wed May 29 17:50:03 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 9C33B18D; Wed, 29 May 2013 17:50:03 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 8DC39C40; Wed, 29 May 2013 17:50:03 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r4THo3gP081386; Wed, 29 May 2013 17:50:03 GMT (envelope-from crees@svn.freebsd.org) Received: (from crees@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r4THo3ve081385; Wed, 29 May 2013 17:50:03 GMT (envelope-from crees@svn.freebsd.org) Message-Id: <201305291750.r4THo3ve081385@svn.freebsd.org> From: Chris Rees Date: Wed, 29 May 2013 17:50:03 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41773 - head/en_US.ISO8859-1/books/handbook/cutting-edge X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 May 2013 17:50:03 -0000 Author: crees Date: Wed May 29 17:50:03 2013 New Revision: 41773 URL: http://svnweb.freebsd.org/changeset/doc/41773 Log: Removing old files is not an optional step on updating and upgrading FreeBSD. Reflect this by merging make delete-old section into the updating section. This change rewords the section such that it fits in with the content around it, and is the followup commit to r41772. PR: docs/162699 Approved by: gjb (mentor) Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Wed May 29 17:46:29 2013 (r41772) +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Wed May 29 17:50:03 2013 (r41773) @@ -1875,11 +1875,30 @@ Fetching 133 new ports or files... done. + 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: