From 4f79ea245b27e3c56d0dd6657649bd0d7d0e3f67 Mon Sep 17 00:00:00 2001
From: simonpj <unknown>
Date: Fri, 6 Jun 2003 12:35:19 +0000
Subject: [PATCH] [project @ 2003-06-06 12:35:19 by simonpj] Add a note about
 ^Z on Win32

---
 ghc/docs/users_guide/win32-dlls.sgml |   20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

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