From: Simon Marlow <marlowsd@gmail.com>
Date: Wed, 14 Jul 2010 10:41:07 +0000 (+0000)
Subject: document exception-overriding behaviour in withFile
X-Git-Url: http://git.megacz.com/?p=ghc-base.git;a=commitdiff_plain;h=d9dadf282bfdc7f848a8e7384a60f460aa51f93c

document exception-overriding behaviour in withFile
---

diff --git a/System/IO.hs b/System/IO.hs
index 0a65c73..5304d83 100644
--- a/System/IO.hs
+++ b/System/IO.hs
@@ -449,7 +449,9 @@ hPrint hdl      =  hPutStrLn hdl . show
 -- | @'withFile' name mode act@ opens a file using 'openFile' and passes
 -- the resulting handle to the computation @act@.  The handle will be
 -- closed on exit from 'withFile', whether by normal termination or by
--- raising an exception.
+-- raising an exception.  If closing the handle raises an exception, then
+-- this exception will be raised by 'withFile' rather than any exception
+-- raised by 'act'.
 withFile :: FilePath -> IOMode -> (Handle -> IO r) -> IO r
 withFile name mode = bracket (openFile name mode) hClose