[project @ 2003-06-06 12:35:19 by simonpj]

Add a note about ^Z on Win32

diff --git a/ghc/docs/users_guide/win32-dlls.sgml b/ghc/docs/users_guide/win32-dlls.sgml
index d737fb3..48eb7ab 100644 (file)
--- a/ghc/docs/users_guide/win32-dlls.sgml
+++ b/ghc/docs/users_guide/win32-dlls.sgml
@@ -47,6 +47,26 @@ If you want to build a GUI-only application, with no console window, use the fla
 
 <sect1>
 <title>
+Differences in library behaviour </title>
+
+<para>
+Some of the standard Haskell libraries behave slightly differently on Windows.
+
+<itemizedlist>
+<listitem> <para>
+On Windows, the '<literal>^Z</literal>' character is interpreted as end-of-file, so
+if you read a file containing this character the file will appear to end just before it.
+To subvert this behaviour, you can put the file into Binary
+mode using <literal>GHC.Handle.hSetBinaryMode</literal>. (unfortunately this
+function isn't available form anywhere more stable, yet).
+</para>
+</listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+<sect1>
+<title>
 Using GHC (and other GHC-compiled executables) with cygwin</title>
 
 <sect2>