From: simonpj <unknown>
Date: Fri, 6 Jun 2003 12:35:19 +0000 (+0000)
Subject: [project @ 2003-06-06 12:35:19 by simonpj]
X-Git-Tag: Approx_11550_changesets_converted~800
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=4f79ea245b27e3c56d0dd6657649bd0d7d0e3f67;p=ghc-hetmet.git

[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
--- 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>