relnotes: Add note about #11744 and workaround
authorBen Gamari <bgamari.foss@gmail.com>
Mon, 18 Apr 2016 13:13:41 +0000 (15:13 +0200)
committerBen Gamari <ben@smart-cactus.org>
Mon, 18 Apr 2016 20:10:11 +0000 (22:10 +0200)
Test Plan: Read it

Reviewers: hvr, austin

Subscribers: carter, thomie

Differential Revision: https://phabricator.haskell.org/D2120

GHC Trac Issues: #11744

docs/users_guide/8.0.1-notes.rst

index 93c9ec3..51a9602 100644 (file)
@@ -18,6 +18,14 @@ performance improvements over the 7.10 branch.
     package key (with GHC's :ghc-flag:`-this-package-key` argument), GHC 8.0 and
     later uses installed package IDs in place of package keys.
 
+.. note::
+
+    Users compiling GHC on Mac OS X with XCode 7.3 will need to tell the build
+    system to use the ``nm-classic`` command instead of Apple's new ``nm``
+    implementation as the latter breaks POSIX compliance (see
+    :ghc-ticket:`11744`). This can be done by passing something like
+    ``--with-nm=/Library/Developer/CommandLineTools/usr/bin/nm-classic`` to
+    ``configure``.
 
 Highlights
 ----------