Date: Wed, 29 May 2013 17:50:03 +0000 (UTC) From: Chris Rees <crees@FreeBSD.org> 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 Message-ID: <201305291750.r4THo3ve081385@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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. </listitem> <listitem> + <para><command>make + <maketarget>delete-old</maketarget></command></para> + + <para>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 <filename>utmp.h</filename> + causes problems in some ports when the new + <filename>utmpx.h</filename> is installed.</para> + </listitem> + + <listitem> <para>Reboot.</para> <para>A full machine reboot is needed now to load the new kernel and new world with new configuration files.</para> </listitem> + + <listitem> + <para><command>make <maketarget>delete-old-libs</maketarget></command></para> + + <para>Remove any obsolete libraries to avoid conflicts with newer + ones. Make sure that all ports have been rebuilt + before old libraries are removed.</para> + </listitem> </orderedlist> <para>Upgrades from one release of the same &os; branch to a @@ -1935,7 +1954,9 @@ Fetching 133 new ports or files... done. &prompt.root; <userinput>cd /usr/src</userinput> &prompt.root; <userinput>make installworld</userinput> &prompt.root; <userinput>mergemaster</userinput> -&prompt.root; <userinput>reboot</userinput></screen> +&prompt.root; <userinput>make delete-old</userinput> +&prompt.root; <userinput>reboot</userinput> +&prompt.root; <userinput>make delete-old-libs</userinput></screen> <warning> <title>Read Further Explanations</title> @@ -2640,11 +2661,10 @@ Script done, …</screen> </author> </authorgroup> </sect2info> - <title>Deleting Obsolete Files, Directories and Libraries</title> + <title>Deleting Obsolete Files and Directories</title> <indexterm> - <primary>Deleting obsolete files, directories and - libraries</primary> + <primary>Deleting obsolete files and directories</primary> </indexterm> <para>As a part of the &os; development lifecycle, files and their @@ -2663,15 +2683,14 @@ Script done, …</screen> The following instructions should be used to remove obsolete files during the system upgrade process.</para> - <para>Follow the steps outlined in <xref - linkend="canonical-build"/>. After the - <command>make <maketarget>installworld</maketarget></command> + <para>After the <command>make + <maketarget>installworld</maketarget></command> and the subsequent <command>mergemaster</command> have finished successfully, check for obsolete files and libraries as follows:</para> <screen>&prompt.root; <userinput>cd /usr/src</userinput> - &prompt.root; <userinput>make check-old</userinput></screen> +&prompt.root; <userinput>make check-old</userinput></screen> <para>If any obsolete files are found, they can be deleted using the following command:</para> @@ -2705,7 +2724,7 @@ Script done, …</screen> <screen>&prompt.root; <userinput>shutdown -r now</userinput></screen> </sect2> - <sect2> + <sect2 id="make-delete-old-libs"> <title>Deleting obsolete libraries</title> <warning> @@ -2729,7 +2748,7 @@ Script done, …</screen> 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> +/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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201305291750.r4THo3ve081385>