Changes between Version 75 and Version 76 of Migration

Timestamp:

Dec 14, 2014, 4:11:33 AM (9 years ago)

Author:

dave@…

Comment:

cleaned up the intro and first 2 points of the migration procedure.

Migration

@@ -1 @@
-== Migrating a MacPorts install to a new major OS version or CPU architecture ==
+== Migrating a MacPorts install to a new major OS version or different CPU architecture ==
 
-A MacPorts installation is designed to work with a particular operating
-system and a particular hardware architecture. Upgrading the operating
-system (e.g., from Mavericks to Yosemite) or migrating to a new machine
-with a different architecture (e.g., from PowerPC to Intel) will
-generally cause problems. The following procedure is designed to prevent
-such problems.
+A MacPorts installation is designed to work with a particular operating system and a particular hardware architecture.
 
-(The procedure is not necessary after Xcode upgrades unless one of the
-scenarios listed above also applies.)
-
+The migration procedure below is necessary after one of these events:
+* upgrading the operating system, like from 10.9 (Mavericks) to 10.10 (Yostemite)
+* migrating to a new machine with a different architecture, like from PowerPC to Intel
+The migration procedure below is not necessary if you upgrade only Xcode.
 
 === Migration procedure ===
 
-1. **Reinstall Xcode.** After performing either of these types of system upgrades, you will need to update the development tools. If you are upgrading from a prior version of OS X, [https://guide.macports.org/#installing.xcode install the latest version of Xcode] for your new OS.
-1. **Reinstall MacPorts.** After updating the development tools, [https://www.macports.org/install.php install the base MacPorts system] for your new platform, either from the appropriate pkg or dmg file if already available or [https://www.macports.org/guide/#installing.macports.source from source].
+1. **Reinstall Xcode** as explained [https://guide.macports.org/#installing.xcode here].
+1. **Reinstall MacPorts** as explained [https://www.macports.org/install.php here], either from the appropriate pkg or dmg file if already available or [https://www.macports.org/guide/#installing.macports.source from source].
    a. **Update macports.conf.** If your macports.conf contains uncommented settings for universal_archs or build_arch, you will likely want to update them, since unlike earlier OS versions, the compiler on Snow Leopard and later will build for x86_64 by default on systems that support it. The default values will be fine for almost all users, so unless you know you need something different, just comment out these two lines. Several other settings in macports.conf have changed their defaults over the years. Take a moment to compare each line of your macports.conf with the corresponding line in macports.conf.default in the same directory. Unless you know a reason why a line your settings file should be different from the defaults, adopt the line from the defaults file.
 1. [=#ports] **Reinstall ports.** To reinstall your ports: