[pkgsrc/trunk]: pkgsrc/bootstrap Explain switch to default ABI=64

[gdt <gdt%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/1aab886e24d2
branches:  trunk
changeset: 349671:1aab886e24d2
user:      gdt <gdt%pkgsrc.org@localhost>
date:      Thu Jul 14 23:35:05 2016 +0000

description:
Explain switch to default ABI=64

Explain how to recover on a machine that used to be ABI=32. by
pointing to jperkin's email about this and giving an example.

diffstat:

 bootstrap/README.MacOSX |  22 ++++++++++++++++++++--
 1 files changed, 20 insertions(+), 2 deletions(-)

diffs (36 lines):

diff -r 16d0be1e2f7c -r 1aab886e24d2 bootstrap/README.MacOSX
--- a/bootstrap/README.MacOSX   Thu Jul 14 20:02:24 2016 +0000
+++ b/bootstrap/README.MacOSX   Thu Jul 14 23:35:05 2016 +0000
@@ -1,4 +1,4 @@
-$NetBSD: README.MacOSX,v 1.29 2016/01/06 07:15:23 yyamano Exp $
+$NetBSD: README.MacOSX,v 1.30 2016/07/14 23:35:05 gdt Exp $
 
 This file describes the use of current versions of pkgsrc with
 multiple versions of Darwin and OS X, omitting information about previous pkgsrc
@@ -62,7 +62,25 @@
 that is i386 only.  For a longer discussion, see:
   http://mail-index.NetBSD.org/pkgsrc-users/2009/09/24/msg010817.html
 
-As of 2015-11, changing the default to x86_64 is imminent.
+As of 2015-11-09, the default ABI is x86_64 on machines where "uname
+-m" reports x86_64.  (It remains i386 on others, which are not capable
+of running x86_64 binaries.)
+
+*** resolving issues from a change in default ABI
+
+When the ABI changes from 32 to 64, you can recover without a
+rebootstrap by replacing bmake and pkg_install.  See
+  https://mail-index.netbsd.org/pkgsrc-users/2016/01/25/msg022870.html
+
+In /usr/pkgsrc/devel/bmake, do:
+# bmake MACHINE_ARCH=x86_64 replace
+and then rerun the failed pkg_add -U with an additional -f.
+Then, in /usr/pkgsrc/pkgtools/pkg_install, do:
+# bmake replace
+
+Then, rebuild all packages; ABI=32 and ABI=64 packages both work
+individually, but mixing them in a single program via dynamic linking
+will not work.
 
 ** sed in 10.9