Date: Tue, 9 Dec 2014 19:32:02 +0000 (UTC) From: Allan Jude <allanjude@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46079 - head/en_US.ISO8859-1/books/handbook/cutting-edge Message-ID: <201412091932.sB9JW2xw050578@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: allanjude Date: Tue Dec 9 19:32:01 2014 New Revision: 46079 URL: https://svnweb.freebsd.org/changeset/doc/46079 Log: Update freebsd-update major upgrade instructions to offer 'pkg upgrade' in addition to portmaster. Differential Revision: https://reviews.freebsd.org/D1288 Reviewed by: bapt Approved by: bcr (mentor) Sponsored by: ScaleEngine Inc. 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 Tue Dec 9 18:58:52 2014 (r46078) +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Tue Dec 9 19:32:01 2014 (r46079) @@ -590,17 +590,31 @@ before running "/usr/sbin/freebsd-update </sect3> <sect3 xml:id="freebsdupdate-portsrebuild"> - <title>Rebuilding Ports After a Major Version Upgrade</title> + <title>Upgrading Packages After a Major Version + Upgrade</title> <para>Generally, installed applications will continue to work without problems after minor version upgrades. Major versions use different Application Binary Interfaces (<acronym>ABI</acronym>s), which will break most third-party applications. After a major version upgrade, - all installed packages and ports need to be upgraded using a - utility such as <package>ports-mgmt/portmaster</package>. A - rebuild of all installed applications can be accomplished - with this command:</para> + all installed packages and ports need to be upgraded. + Packages can be upgraded using <command>pkg + upgrade</command>. To upgrade installed ports, use a + utility such as + <package>ports-mgmt/portmaster</package>.</para> + + <para>A forced upgrade of all installed packages with replace + the packages with fresh versions from the repository even if + the version number has not increased. This is required + because of the ABI version change when upgrading between + major versions of &os;. The forced upgrade can be + accomplished by performing:</para> + + <screen>&prompt.root; <userinput>pkg-static upgrade -f</userinput></screen> + + <para>A rebuild of all installed applications can be + accomplished with this command:</para> <screen>&prompt.root; <userinput>portmaster -af</userinput></screen>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201412091932.sB9JW2xw050578>