release notes: Note some known bugs

1 files changed, 26 insertions, 0 deletions

diff --git a/docs/users_guide/7.10.3-notes.xml b/docs/users_guide/7.10.3-notes.xml
index e17d96a453..358d9fcc55 100644
--- a/docs/users_guide/7.10.3-notes.xml
+++ b/docs/users_guide/7.10.3-notes.xml
@@ -85,6 +85,8 @@
           ARM support should be substantially more reliable as the compiler now
           takes precautions to avoid linking against Thumb code (<ulink
           href="https://ghc.haskell.org/trac/ghc/ticket/10375">Trac #10375</ulink>).
+          Unfortunately the fix involved breaking some configurations. See the
+          entry in the "Known Bugs" section below.
         </para>
       </listitem>
 
@@ -152,6 +154,30 @@
   <sect2>
     <title>Known bugs</title>
     <itemizedlist>
+      <listitem>
+        <para>
+            The <literal>Cabal</literal> release shipped with this GHC release lacks
+            support for response files, a mechanism used on Windows to workaround the
+            low command-line length limit on that platform. For this reason you
+            may experience line length issues when building Haddock documentation with Cabal
+            on Windows.
+        </para>
+        <para>
+          At the time of release there is a <ulink
+          href="https://github.com/haskell/cabal/commit/1c1228a808b55331ac1db6d71fd2f8533f5fc57e">fix</ulink>
+          in the <literal>Cabal</literal> upstream respository, although it is not yet
+          present in a release.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Unfortunately the fix for
+          <ulink href="https://ghc.haskell.org/trac/ghc/ticket/10375">Trac #10375</ulink>
+          required that support for the ARM Thumb instruction set be disabled.
+          See <ulink href="https://ghc.haskell.org/trac/ghc/ticket/11058">Trac
+          #11058</ulink> for details.
+        </para>
+      </listitem>
    </itemizedlist>
   </sect2>
 </sect1>