From 57e8fda3236d05b26d0d76cb4593c4282a4d48f8 Mon Sep 17 00:00:00 2001
From: rrt <unknown>
Date: Wed, 6 Jun 2001 10:33:35 +0000
Subject: [PATCH 1/1] [project @ 2001-06-06 10:33:35 by rrt] Say that building
 packages as DLLs is now no longer supported, but may
 still work.

---
 ghc/docs/users_guide/packages.sgml   |   12 ++++++++----
 ghc/docs/users_guide/win32-dlls.sgml |    5 +++++
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/ghc/docs/users_guide/packages.sgml b/ghc/docs/users_guide/packages.sgml
index 1ef87cb..5e2ce43 100644
--- a/ghc/docs/users_guide/packages.sgml
+++ b/ghc/docs/users_guide/packages.sgml
@@ -79,7 +79,10 @@
 	  single DLL on Windows is that the package system is used to
 	  tell the compiler when it should make an inter-DLL call
 	  rather than an intra-DLL call (inter-DLL calls require an
-	  extra indirection).</para>
+	  extra indirection). <Strong>Building packages as DLLs
+	  doesn't work at the moment; see <XRef
+	  LinkEnd="win32-dlls-create"> for the gory details.</Strong>
+	  </para>
 
 	  <para>Versions of the Haskell libraries for use with GHCi
 	  may also be included: GHCi cannot load <literal>.a</literal>
@@ -127,8 +130,8 @@ ld -r --whole-archive -o HSfoo.o libHSfoo.a
       bear in mind that we might add support for Unix shared libraries
       at some point in the future.</para>
 
-      <para>It is worth noting that on Windows, because each package
-      is built as a DLL, and a reference to a DLL costs an extra
+      <para>It is worth noting that on Windows, when each package
+      is built as a DLL, since a reference to a DLL costs an extra
       indirection, intra-package references are cheaper than
       inter-package references. Of course, this applies to the
       <filename>Main</filename> package as well.</para>
@@ -277,7 +280,8 @@ ld -r --whole-archive -o HSfoo.o libHSfoo.a
 	  <listitem>
 	    <para>A list of libraries containing Haskell code for this
 	    package, with the <literal>.a</literal> or
-	    <literal>.dll</literal> suffix omitted.  On Unix, the
+	    <literal>.dll</literal> suffix omitted.  When packages are
+	    built as libraries, the
 	    <literal>lib</literal> prefix is also omitted.</para>
 
 	    <para>For use with GHCi, each library should have an
diff --git a/ghc/docs/users_guide/win32-dlls.sgml b/ghc/docs/users_guide/win32-dlls.sgml
index 2679979..a7b107b 100644
--- a/ghc/docs/users_guide/win32-dlls.sgml
+++ b/ghc/docs/users_guide/win32-dlls.sgml
@@ -80,6 +80,11 @@ option on all the Haskell modules that make up your application.
 </Title>
 
 <Para>
+<Strong>Making libraries into DLLs doesn't work on Windows at the
+moment (and is no longer supported); however, all the machinery is
+still there. If you're interested, contact the GHC team. Note that
+building an entire Haskell application as a DLL is still supported
+(it's just inter-DLL Haskell calls that don't work).</Strong>
 <IndexTerm><Primary>Creating a Win32 DLL</Primary></IndexTerm>
 <IndexTerm><Primary>--mk-dll</Primary></IndexTerm>
 Sealing up your Haskell library inside a DLL is straightforward;
-- 
1.7.10.4