From: simonpj <unknown>
Date: Thu, 6 Jan 2005 15:05:45 +0000 (+0000)
Subject: [project @ 2005-01-06 15:05:45 by simonpj]
X-Git-Tag: Initial_conversion_from_CVS_complete~1287
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=c61816ee7a22c49d249c6fc150cb3c15834679ea;p=ghc-hetmet.git

[project @ 2005-01-06 15:05:45 by simonpj]
Mention problem with ld on Windows
---

diff --git a/docs/building/building.xml b/docs/building/building.xml
index 2a61ab8..d8683c6 100644
--- a/docs/building/building.xml
+++ b/docs/building/building.xml
@@ -4317,6 +4317,24 @@ Cygwin programs have a more complicated mount table, and map the lettered drives
 </para>
 </sect3>
 
+<sect3><title>Crippled <command>ld</command></title>
+
+<para>
+It turns out that on both Cygwin and MSYS, the <command>ld</command> has a
+limit of 32kbytes on its command line.  Especially when using split object
+files, the make system can emit calls to <command>ld</command> with thousands
+of files on it.  Then you may see something like this:
+<programlisting>
+(cd Graphics/Rendering/OpenGL/GL/QueryUtils_split &amp;&amp; /mingw/bin/ld -r -x -o ../QueryUtils.o *.o)
+/bin/sh: /mingw/bin/ld: Invalid argument
+</programlisting>
+The solution is either to switch off object file splitting (set
+<option>SplitObjs</option> to <literal>NO</literal> in your
+<filename>build.mk</filename>),
+or to make the module smaller.
+</para>
+</sect3>
+
 <sect3><title>Host System vs Target System</title>
 
 <para>