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


-- | error functions that show file location information
--   
--   Error functions that give file location information
--   
--   <pre>
--   $(err "OH NO!")
--   
--   main:Main main.hs:16:1 OH NO!
--   </pre>
--   
--   Notice how it displays package:module file:line:character It exposes
--   the functions err (error), undef (undefined), and trc
--   (Debug.Trace.trace). All of these behave the same as their normal
--   counterpart but also spit out a location.
--   
--   I also included my favorite helper, debug, which is like trace but
--   just show the value. No TH version with location yet.
--   
--   <pre>
--   debug [1,2,3]
--   
--   DEBUG: [1,2,3]
--   [1,2,3]
--   </pre>
@package error-location
@version 0.1.3

module ErrorLocation

-- | like Prelude.error, but gives the file location
--   
--   <pre>
--   $(err "OH NO!)
--   main:Main main.hs:4:10 OH NO!
--   </pre>
err :: String -> Q Exp

-- | like Prelude.undefined, but gives the file location use trace to
--   output the location. this way we still use undefined instead of
--   calling error
--   
--   <pre>
--   $(undef)
--   main:Main main.hs:4:10 undefined
--   err: Prelude.undefined
--   </pre>
undef :: Q Exp

-- | A version of Debug.Trace.trace that just prints a value. This should
--   be included in Debug.Trace
debug :: Show a => a -> a

-- | A TH version of Debug.Trace.trace that prints location information
--   TODO: make a debug version of this
trc :: String -> Q Exp