diff options
| author | Austin Seipp <austin@well-typed.com> | 2014-01-28 08:17:50 -0600 |
|---|---|---|
| committer | Austin Seipp <austin@well-typed.com> | 2014-01-28 08:17:50 -0600 |
| commit | 943f22a4c959a2d0c0e47fc40c2163ef7760b6d9 (patch) | |
| tree | eda5fe315493046479af5d0fdf64a729797ef4eb /docs | |
| parent | 28b031c506122e28e0230a562a4f6fd3d0256d0c (diff) | |
| download | haskell-943f22a4c959a2d0c0e47fc40c2163ef7760b6d9.tar.gz | |
Document a Haddock/Mavericks bug.
Signed-off-by: Austin Seipp <austin@well-typed.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/users_guide/7.8.1-notes.xml | 35 |
1 files changed, 31 insertions, 4 deletions
diff --git a/docs/users_guide/7.8.1-notes.xml b/docs/users_guide/7.8.1-notes.xml index a4fe52059c..9686301744 100644 --- a/docs/users_guide/7.8.1-notes.xml +++ b/docs/users_guide/7.8.1-notes.xml @@ -1178,12 +1178,39 @@ <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> +<no location info>: + 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> + <para> On OS X 10.7 and beyond, with default build settings, the runtime system currently suffers from a fairly - large (30%) performance regression in the parallel - garbage collector when using - <literal>-threaded</literal> impacting its thoroughput - and overall scalability. + large (approx. 30%) performance regression in the + parallel garbage collector when using + <literal>-threaded</literal>. </para> <para> This is due to the fact that the OS X 10.7+ toolchain |