import Text.XML.HXT.Arrow.XmlState
-- |'Abortion' is an 'Exception' that aborts the execution of
--- 'Network.HTTP.Lucu.Resource.Resource' monad with a 'StatusCode',
--- additional response headers, and an optional message text.
+-- 'Network.HTTP.Lucu.Rsrc' monad with a 'StatusCode', additional
+-- response headers, and an optional message text.
--
--- 1. If the 'Network.HTTP.Lucu.Resource.Resource' is in the /Deciding
--- Header/ or any precedent states, throwing an 'Abortion' affects
--- the HTTP response to be sent to the client.
+-- 1. If the 'Network.HTTP.Lucu.Rsrc' is in the /Deciding Header/ or
+-- any precedent states, throwing an 'Abortion' affects the HTTP
+-- response to be sent to the client.
--
-- 2. Otherwise it's too late to overwrite the HTTP response so the
-- only possible thing the system can do is to dump the exception
-- 'isError' so you can abuse this exception for redirections as well
-- as error reporting e.g.
--
--- > abort $ mkAbortion MovedPermanently
--- > [("Location", "http://example.net/")]
--- > "It has been moved to example.net"
+-- @
+-- 'Network.HTTP.Lucu.abort' '$' 'Network.HTTP.Lucu.mkAbortion' 'MovedPermanently'
+-- [(\"Location\", \"http://example.net/\")]
+-- ('Just' \"It's been moved to example.net.\")
+-- @
data Abortion = Abortion {
aboStatus ∷ !SomeStatusCode
, aboHeaders ∷ !Headers