== Logging
   by Tim Pease
   http://logging.rubyforge.org
   (the "Quixotic Starfish" release)

== Description

Logging is a flexible logging library for use in Ruby programs based  
on the
design of Java's log4j library. It features a hierarchical logging  
system,
custom level names, multiple output destinations per log event, custom
formatting, and more.

This release addresses compatibility issues with Rails, seed  
improvements,
and one or two minor tweaks and bug fixes.  See the changes section  
for all
the gory details. However, this release is not quite backwards  
compatible
with the 0.6.* and earlier versions. The reason is the  
Logging::Logger#add
method. It was reworked to semantically conform to the Ruby Standard
Library's Logger#add method -- this provides the Rails compatibility.

For users of earlier versions of logging, you will need to change any  
usage
of the Logging::Logger#add method to use the new
Logging::Logger#add_appenders method (it's the old "add" method
renamed to "add_appenders").

== Installation

sudo gem install logging

== What's Important

Logging provides a few niceties
1) a rolling file appender than can handle multiple processes logging
    to the same file
2) a nice e-mail appender
3) sending log messages to Growl (for those on the Mac platform)
4) fine grained control over logging levels for specific classes

== Changes

1 major enhancement
   - Rails compatibility
     * renamed Logger#add method to Logger#add_appenders
     * renamed Logger#remove method to Logger#remove_appenders
     * renamed Logger#clear method to Logger#clear_appenders
     * added a new Logger#add method that conforms to the calling
       semantics of the Ruby stdlib Logger

2 minor enhancements
   - Speed improvements and test coverage
   - Created a top-level Logging.init method that is used to
     define the default logging levels

1 bug fix
   - Tweaked windows detection code

== Fun Fact

A pregnant goldfish is called a "twit".

== Post Script

Blessings,
TwP