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


-- | A logging back-end to syslog(3) for the logging-facade library
--   
--   A simple <a>System.Logging.Facade</a> back-end for <tt>syslog(3)</tt>
--   as specified in <a>POSIX.1-2008</a>.
@package logging-facade-syslog
@version 1


-- | A simple <a>System.Logging.Facade</a> back-end for <tt>syslog(3)</tt>
--   as specified in <a>POSIX.1-2008</a>.
module System.Logging.Facade.Syslog

-- | Pass this value to <a>setLogSink</a> to switch logging to
--   <a>syslog</a>. Messages of all priorities will be logged in the
--   processes' default syslog facility --- typically <a>User</a>. If these
--   default settings don't fit your needs, consider using
--   <a>syslogSink</a> or call <a>withSyslog</a> or a similar funtion to
--   configure the system's <tt>syslog</tt> implementation appropriately.
--   
--   <pre>
--   syslogSink = syslogSink' showWithLocation Nothing
--   </pre>
syslogSink :: LogSink

-- | A variant of <a>syslogSink</a> that allows you to control how the
--   location information provided by <tt>logger-facade</tt> is baked into
--   the log message and which <tt>syslog</tt> <a>Facility</a> will be
--   used. If no explicit facility is set, messages go out with whatever
--   the process default is --- typically <a>User</a>.
syslogSink' :: (Maybe Location -> String -> String) -> Maybe Facility -> LogSink

-- | The default message formatter used by <a>syslogSink</a>. It will
--   append the location of the message to the string such that running
--   
--   <pre>
--   info "Hello, world."
--   </pre>
--   
--   yields:
--   
--   <pre>
--   May 15 10:59:41 myhost ghc[28074]: Hello, world. (from package "interactive", module "Ghci2", file "&lt;interactive&gt;", line 32, and column 1
--   </pre>
showWithLocation :: Maybe Location -> String -> String