From owner-svn-doc-all@FreeBSD.ORG Tue Dec 9 19:32:02 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id ACAD9ABC; Tue, 9 Dec 2014 19:32:02 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7E45397B; Tue, 9 Dec 2014 19:32:02 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id sB9JW2Dl050579; Tue, 9 Dec 2014 19:32:02 GMT (envelope-from allanjude@FreeBSD.org) Received: (from allanjude@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id sB9JW2xw050578; Tue, 9 Dec 2014 19:32:02 GMT (envelope-from allanjude@FreeBSD.org) Message-Id: <201412091932.sB9JW2xw050578@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: allanjude set sender to allanjude@FreeBSD.org using -f From: Allan Jude Date: Tue, 9 Dec 2014 19:32:02 +0000 (UTC) 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 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.18-1 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: Tue, 09 Dec 2014 19:32:02 -0000 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 - Rebuilding Ports After a Major Version Upgrade + Upgrading Packages After a Major Version + Upgrade Generally, installed applications will continue to work without problems after minor version upgrades. Major versions use different Application Binary Interfaces (ABIs), 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 ports-mgmt/portmaster. A - rebuild of all installed applications can be accomplished - with this command: + all installed packages and ports need to be upgraded. + Packages can be upgraded using pkg + upgrade. To upgrade installed ports, use a + utility such as + ports-mgmt/portmaster. + + 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: + + &prompt.root; pkg-static upgrade -f + + A rebuild of all installed applications can be + accomplished with this command: &prompt.root; portmaster -af