From: Simon Marlow <marlowsd@gmail.com>
Date: Thu, 14 Oct 2010 08:42:20 +0000 (+0000)
Subject: throwTo: mention interruptible foreign calls
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=4cd3a6475de0ef9a9d1bd0b6e8cf3fb336b80a43;hp=b059ae4041ffab77a0f7282484d6e8b7f563c6e4;p=ghc-base.git

throwTo: mention interruptible foreign calls
---

diff --git a/GHC/Conc/Sync.lhs b/GHC/Conc/Sync.lhs
index cc16853..9b7415d 100644
--- a/GHC/Conc/Sync.lhs
+++ b/GHC/Conc/Sync.lhs
@@ -274,7 +274,10 @@ another thread.
 If the target thread is currently making a foreign call, then the
 exception will not be raised (and hence 'throwTo' will not return)
 until the call has completed.  This is the case regardless of whether
-the call is inside a 'mask' or not.
+the call is inside a 'mask' or not.  However, in GHC a foreign call
+can be annotated as @interruptible@, in which case a 'throwTo' will
+cause the RTS to attempt to cause the call to return; see the GHC
+documentation for more details.
 
 Important note: the behaviour of 'throwTo' differs from that described in
 the paper \"Asynchronous exceptions in Haskell\"