Commit 943f22a4 authored by Austin Seipp's avatar Austin Seipp

Document a Haddock/Mavericks bug.

Signed-off-by: default avatarAustin Seipp <austin@well-typed.com>
parent 28b031c5
...@@ -1176,14 +1176,41 @@ ...@@ -1176,14 +1176,41 @@
<sect2> <sect2>
<title>Known bugs</title> <title>Known bugs</title>
<itemizedlist> <itemizedlist>
<listitem>
<para>
On OS X Mavericks, when using Clang as the C
preprocessor, Haddock has a bug that causes it to fail
to generate documentation, with an error similar to
the following:
<programlisting>
&lt;no location info&gt;:
module 'xhtml-3000.2.1:Main' is defined in multiple files: dist-bindist/build/tmp-72252/Text/XHtml.hs
dist-bindist/build/tmp-72252/Text/XHtml/Frameset.hs
dist-bindist/build/tmp-72252/Text/XHtml/Strict.hs
dist-bindist/build/tmp-72252/Text/XHtml/Transitional.hs
...
</programlisting>
</para>
<para>
This only affects certain packages. This is due to a
bad interaction with Clang, which we hope to resolve
soon.
</para>
<para>
Note that when using <literal>cabal-install</literal>,
this only effects the package documentation, not
installation or building.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
On OS X 10.7 and beyond, with default build settings, On OS X 10.7 and beyond, with default build settings,
the runtime system currently suffers from a fairly the runtime system currently suffers from a fairly
large (30%) performance regression in the parallel large (approx. 30%) performance regression in the
garbage collector when using parallel garbage collector when using
<literal>-threaded</literal> impacting its thoroughput <literal>-threaded</literal>.
and overall scalability.
</para> </para>
<para> <para>
This is due to the fact that the OS X 10.7+ toolchain This is due to the fact that the OS X 10.7+ toolchain
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment