JWare/AntXtras Log4Ant
                     Version 3.0.0, Release Aug 2011
                   -----------------------------------

                            
This document contains the major Log4Ant version change notes. For the most
recent information, visit the website at http://antxtras.sourceforge.net.

------------------------------------------------------------------------------
This version of Log4Ant represents the migration from a codebase based
on Ant 1.7 and AntXtras v2 to one based on Ant 1.8 and AntXtras v3. 
Older versions of Log4Ant are NOT compatible with Ant 1.8 so you must 
use this version if you intend to use Ant 1.8.x. 

------------------------------------------------------------------------------
CHANGES IN 3.0.0:

=> Rebuild against final AntXtras v3.0.0 distribution with Ant 1.8.2.


=> Upgraded Log4Ant versions of third-party dependencies:
    + SLF4J to 1.6.1, 
    + Janino to 2.6.1, and 
    + Logback to 0.9.29.


=> Fixed <emit:manage action="install-jul2slf4j"/> to install
   the JUL -> SLF4J bridge handler only if not already installed.
   Also added a matching "uninstall" action to undo installation
   operation; will do nothing if not installed [FS#171]

   EXAMPLE:
     [1] To install the JUL to SLF4J bridge (do as early as possible):
           <emit:manage action="install-jul2slf4j"/>
     
     [2] To uninstall the JUL bridge:
           <emit:manage action="uninstall-jul2slf4j"/>


=> Added 'check' action to <emit:manage> to test whether a default
   logging configuration is already installed. [FS#270]

   EXAMPLE:
     [1] To echo a "true" or "false" to Ant console output if
         any configuration is installed (overlay, default, etc.):
           <emit:manage action="check"/>

     [2] To echo a "true" or "false" to Ant console if a particular
         kind of configuration is installed:
           <emit:manage action="check">
              <parameter name="is.default.installed"/>
           </emit:manage>

     [3] To copy a "true" or "false" value to a variable:
           <emit:manage action="check">
              <parameter name="is.any.installed" 
                 value="__emit.installed.flag"/>
           </emit:manage>


------------------------------------------------------------------------------
CHANGES IN 3.0.0b1:

=> [INCOMPAT] The default antlibs are now the namespace dependent ones.
   For the older-style antlib (where the 'emit' is included as part of the
   component's name instead of in a namespace you define), use the renamed
   'antlib-nons.xml' antlib files.

   EXAMPLE: Load Log4Ant antlib into the 'jwaresoftware.log4ant'
   namespace:

        <taskdef uri="jwaresoftware.log4ant"
            resource="org/jwaresoftware/log4ant/antlib.xml"
            classpathref="jware.classpath"/>


-SSMC