X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=System%2FExit.hs;h=1dab14f732ae8fbc5e8116ad375ee13a982fb6d1;hb=7c0b04fd273621130062418bb764809c79488dd2;hp=3c2aea234f334bcff31a7d8b775c1dfce02f009c;hpb=8b09945bb2232654a357e7bbf9acef37ee21d9ef;p=haskell-directory.git

diff --git a/System/Exit.hs b/System/Exit.hs
index 3c2aea2..1dab14f 100644
--- a/System/Exit.hs
+++ b/System/Exit.hs
@@ -27,6 +27,7 @@ import GHC.IOBase
 
 #ifdef __HUGS__
 import Hugs.Prelude
+import Hugs.Exception
 #endif
 
 #ifdef __NHC__
@@ -39,9 +40,22 @@ import System
 -- ---------------------------------------------------------------------------
 -- exitWith
 
--- `exitWith code' terminates the program, returning `code' to the
--- program's caller.  Before it terminates, any open or semi-closed
--- handles are first closed.
+-- | Computation 'exitWith' @code@ throws 'ExitException' @code@.
+-- Normally this terminates the program, returning @code@ to the
+-- program's caller.  Before the program terminates, any open or
+-- semi-closed handles are first closed.
+--
+-- A program that fails in any other way is treated as if it had
+-- called 'exitFailure'.
+-- A program that terminates successfully without calling 'exitWith'
+-- explicitly is treated as it it had called 'exitWith' 'ExitSuccess'.
+--
+-- As an 'ExitException' is not an 'IOError', 'exitWith' bypasses
+-- the error handling in the 'IO' monad and cannot be intercepted by
+-- 'catch' from the "Prelude".  However it is an 'Exception', and can
+-- be caught using the functions of "Control.Exception".  This means
+-- that cleanup computations added with 'Control.Exception.bracket'
+-- (from "Control.Exception") are also executed properly on 'exitWith'.
 
 #ifndef __NHC__
 exitWith :: ExitCode -> IO a
@@ -53,5 +67,8 @@ exitWith code@(ExitFailure n)
 #endif
 #endif  /* ! __NHC__ */
 
+-- | The computation 'exitFailure' is equivalent to
+-- 'exitWith' @(@'ExitFailure' /exitfail/@)@,
+-- where /exitfail/ is implementation-dependent.
 exitFailure :: IO a
 exitFailure = exitWith (ExitFailure 1)