add GHC.HetMet.{hetmet_kappa,hetmet_kappa_app}
[ghc-base.git] / System / Exit.hs
index 1e74c1a..7eb17cf 100644 (file)
@@ -1,3 +1,5 @@
+{-# LANGUAGE CPP #-}
+
 -----------------------------------------------------------------------------
 -- |
 -- Module      :  System.Exit
@@ -23,7 +25,8 @@ module System.Exit
 import Prelude
 
 #ifdef __GLASGOW_HASKELL__
-import GHC.IOBase
+import GHC.IO
+import GHC.IO.Exception
 #endif
 
 #ifdef __HUGS__
@@ -41,19 +44,23 @@ import System
 -- ---------------------------------------------------------------------------
 -- exitWith
 
--- | Computation 'exitWith' @code@ throws 'ExitException' @code@.
+-- | Computation 'exitWith' @code@ throws 'ExitCode' @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.
+-- program's caller.
+--
+-- On program termination, the standard 'Handle's 'stdout' and
+-- 'stderr' are flushed automatically; any other buffered 'Handle's
+-- need to be flushed manually, otherwise the buffered data will be
+-- discarded.
 --
 -- 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
+-- As an 'ExitCode' 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
+-- 'catch' from the "Prelude".  However it is a 'SomeException', 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'.
@@ -81,6 +88,6 @@ exitFailure = exitWith (ExitFailure 1)
 
 -- | The computation 'exitSuccess' is equivalent to
 -- 'exitWith' 'ExitSuccess', It terminates the program
--- sucessfully.
+-- successfully.
 exitSuccess :: IO a
 exitSuccess = exitWith ExitSuccess