[commit: ghc] ghc-8.0: user-guide: Note Cabal version limitation (d38daab)

[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/d38daab8e7bacfcd7c5f7fde07484e660ad965b2/ghc

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

commit d38daab8e7bacfcd7c5f7fde07484e660ad965b2
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Thu Jan 14 15:46:31 2016 +0100

    user-guide: Note Cabal version limitation
    
    (cherry picked from commit b90cac69b2abec7df998d1d447b3fe075eb8f15c)


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

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

diff --git a/docs/users_guide/8.0.1-notes.rst b/docs/users_guide/8.0.1-notes.rst
index 6175b39..e90a534 100644
--- a/docs/users_guide/8.0.1-notes.rst
+++ b/docs/users_guide/8.0.1-notes.rst
@@ -7,6 +7,18 @@ The significant changes to the various parts of the compiler are listed
 in the following sections. There have also been numerous bug fixes and
 performance improvements over the 7.10 branch.
 
+.. warning::
+
+    Only Cabal versions 0.24 and newer will function properly with this release.
+    Consequently it will likely be necessary to recompile ``cabal-install``
+    before installing new packages.
+
+    The reason for this is a change in how packages are identified in GHC
+    8.0. While previous versions of Cabal identified packages to GHC with a
+    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.
+
+
 Highlights
 ----------