From: Simon Marlow <marlowsd@gmail.com>
Date: Tue, 20 Jul 2010 08:28:04 +0000 (+0000)
Subject: docs: mention that Foreign.unsafePerformIO is deprecated
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=018990d5f5d8adc73cd1dfab0fad2f8a6aa9bd2d;p=ghc-base.git

docs: mention that Foreign.unsafePerformIO is deprecated
We can't actually deprecate it without introducing a name clash
between Foreign.unsafePerformIO and System.IO.Unsafe.unsafePerformIO
---

diff --git a/Foreign.hs b/Foreign.hs
index 622ec93..5976c20 100644
--- a/Foreign.hs
+++ b/Foreign.hs
@@ -24,8 +24,10 @@ module Foreign
         , module Foreign.Storable
         , module Foreign.Marshal
 
-        -- | For compatibility with the FFI addendum only.  The recommended
-        -- place to get this from is "System.IO.Unsafe".
+        -- | 'unsafePerformIO' is exported here for backwards
+        -- compatibility reasons only.  For doing local marshalling in
+        -- the FFI, use 'unsafeLocalState'.  For other uses, see
+        -- 'System.IO.Unsafe.unsafePerformIO'.
         , unsafePerformIO
         ) where