-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Expat parser for HXT
--   
--   The Expat interface for the HXT.
@package hxt-expat
@version 9.1.1


-- | Interface for Expat XML Parser
module Text.XML.HXT.Expat

-- | The system config option to enable the expat parser
--   
--   Here is an example, how to use it:
--   
--   <pre>
--   ...
--   import Text.HXT.XML.Core
--   import Text.HXT.XML.Expat
--   ...
--   
--   readDocument [ withExpat True ] "some-file.xml"
--   ...
--   </pre>
--   
--   reads the given document and parses it with the expat parser. There is
--   no validation enabled. The parameter to <tt>withExpat</tt> determines,
--   whether parsing is done strict. Here strict parsing is enabled. When
--   strict parsing is used, the parse is immediately checked for parser
--   errors, and possible errors are issued. When set to non-strict
--   parsing, error checking is delayed and may be done later with the
--   <tt>issueExpatErr</tt> arrow.
--   
--   When HTML parsing is enabled, the expat parser will be configured with
--   the HTML enitity reference resolver, else only the predefined XML
--   enitities will be substituted.
withExpat :: Bool -> SysConfig

-- | Turns off expat parsing. The build in HXT parsers will be used.
withoutExpat :: SysConfig

-- | In case of lazy parsing check for possible errors
issueExpatErr :: IOStateArrow s b b
