[commit: ghc] master: Add release notes about ghc-pkg change, and Cabal dep removal (6d8c70c)

[git at git.haskell.org]

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

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/6d8c70c1262a0f8b02ee685905f469f94d742af2/ghc

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

commit 6d8c70c1262a0f8b02ee685905f469f94d742af2
Author: Duncan Coutts <duncan at well-typed.com>
Date:   Thu Aug 28 05:52:48 2014 +0100

    Add release notes about ghc-pkg change, and Cabal dep removal
    
    That ghc-pkg doesn't support single-file style databases, and that
    the ghc library does not depend on Cabal any more.
    
    We don't need to document the ghc-pkg change in the ghc-pkg section
    itself, since ghc-pkg init is already described there, and that is the
    right thing. The old deprecated approach was not documented.


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

6d8c70c1262a0f8b02ee685905f469f94d742af2
 docs/users_guide/7.10.1-notes.xml | 43 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/docs/users_guide/7.10.1-notes.xml b/docs/users_guide/7.10.1-notes.xml
index 0af4c31..404d239 100644
--- a/docs/users_guide/7.10.1-notes.xml
+++ b/docs/users_guide/7.10.1-notes.xml
@@ -118,6 +118,39 @@
            </listitem>
        </itemizedlist>
     </sect3>
+
+    <sect3>
+        <title>Package system</title>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    TODO: cover module renaming, thinning, re-export etc
+               </para>
+            </listitem>
+            <listitem>
+                <para>
+                    ghc-pkg (and ghc) have dropped support for single-file style
+                    package databases. Since version 6.12, ghc-pkg has defaulted
+                    to a new database format (using a directory of files, one per
+                    package plus a binary cache).
+               </para>
+               <para>
+                    This change will not affect programs and scripts that use
+                    <literal>ghc-pkg init</literal> to create package databases.
+               </para>
+               <para>
+                    This will affect scripts that create package databases
+                    using tricks like
+<programlisting>
+echo "[]" > package.conf
+</programlisting>
+                    Such scripts will need to be modified to use
+                    <literal>ghc-pkg init</literal>, and to delete databases
+                    by directory removal, rather than simple file delete.
+               </para>
+           </listitem>
+       </itemizedlist>
+    </sect3>
   </sect2>
 
   <sect2>
@@ -251,6 +284,16 @@
                     package ID.
                </para>
            </listitem>
+            <listitem>
+                <para>
+                    The ghc library no longer depends on the Cabal library. This means
+                    that users of the ghc library are no longer forced to use the same
+                    version of Cabal as ghc did. It also means that Cabal is freed up
+                    to be able to depend on packages that ghc does not want to depend
+                    on (which for example may enable improvements to Cabal's parsing
+                    infrastructure).
+               </para>
+           </listitem>
        </itemizedlist>
     </sect3>