[commit: ghc] master: relnotes: Add note about #11744 and workaround (10d808c)

[git at git.haskell.org]

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

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/10d808c59307c5c0b1cb40a9ce0eb6e3efc068c9/ghc

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

commit 10d808c59307c5c0b1cb40a9ce0eb6e3efc068c9
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


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

10d808c59307c5c0b1cb40a9ce0eb6e3efc068c9
 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 93c9ec3..51a9602 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
 ----------