Index: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml @@ -590,17 +590,31 @@ - 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