[MacPorts] Migration modified

[MacPorts]

Page "Migration" was changed by larryv at macports.org
Diff URL: <https://trac.macports.org/wiki/Migration?action=diff&version=77>
Revision 77
Comment: Sorry, I think those changes make this page worse. The new text is overly terse, and "click here" style links are bad form.
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: Migration
=========================================================================
--- Migration (version: 76)
+++ Migration (version: 77)
@@ -1,16 +1,23 @@
-== Migrating a MacPorts install to a new major OS version or different CPU architecture ==
+== Migrating a MacPorts installation ==
 
-A MacPorts installation is designed to work with a particular operating system and a particular hardware architecture.
-
-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.
+A MacPorts installation is designed to work with a particular operating
+system and a particular hardware architecture. Problems may occur
+after major system changes, such as:
+- major operating system upgrades (e.g., from 10.9 Mavericks to 10.10
+  Yosemite).
+- architecture migrations (e.g., from PowerPC to Intel).
+Please follow this procedure to ensure a smooth transition. (This isn't
+necessary if you only upgrade Xcode.)
 
 === Migration procedure ===
 
-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].
+1. **Reinstall Xcode.** After a major system change, update the
+   development tools by
+   [https://guide.macports.org/#installing.xcode installing the latest version of Xcode].
+1. **Reinstall MacPorts base.** After updating the development tools,
+   [https://www.macports.org/install.php install the base MacPorts system]
+   for your new platform, either from the appropriate installer or 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:
    a. Save the list of installed ports:
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/Migration>
MacPorts <https://www.macports.org/>
Ports system for OS X

This is an automated message. Someone added your email address to be
notified of changes on 'Migration' page.
If it was not you, please report to .