[commit: ghc] ghc-8.0: relnotes: Add note about #11744 and workaround (bcff328)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : ghc-8.0
Link       : http://ghc.haskell.org/trac/ghc/changeset/bcff328889200dd935997ff1438736a81a78c528/ghc

>---------------------------------------------------------------

commit bcff328889200dd935997ff1438736a81a78c528
Author: Ben Gamari <bgamari.foss at gmail.com>
Date:   Mon Apr 18 15:13:41 2016 +0200

    relnotes: Add note about #11744 and workaround
    
    Test Plan: Read it
    
    Reviewers: hvr, austin
    
    Subscribers: carter, thomie
    
    Differential Revision: https://phabricator.haskell.org/D2120
    
    GHC Trac Issues: #11744
    
    (cherry picked from commit 03d1fd63914bd0c769fa0444d3ef1a5ddfee220d)


>---------------------------------------------------------------

bcff328889200dd935997ff1438736a81a78c528
 docs/users_guide/8.0.1-notes.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/users_guide/8.0.1-notes.rst b/docs/users_guide/8.0.1-notes.rst
index fe76b3a..f627a6f 100644
--- a/docs/users_guide/8.0.1-notes.rst
+++ b/docs/users_guide/8.0.1-notes.rst
@@ -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
 ----------