X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=System%2FExit.hs;h=7eb17cfbfe27f02b10c6a6dd1e2c00ff7d7816a0;hb=HEAD;hp=a344f7a0e6de27f00cc997f61b6e56e8668c9992;hpb=d2063b5b0be014545b21819172c87756efcb0b0c;p=ghc-base.git diff --git a/System/Exit.hs b/System/Exit.hs index a344f7a..7eb17cf 100644 --- a/System/Exit.hs +++ b/System/Exit.hs @@ -1,3 +1,5 @@ +{-# LANGUAGE CPP #-} + ----------------------------------------------------------------------------- -- | -- Module : System.Exit @@ -42,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'. @@ -82,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