jakarta-log4j for Debian
------------------------

This is the jakarta logging library. I hope you find it useful, because I
do that myself.

Some information from the INSTALL documentation:

4) You can now test your installation. To do this issue the command
   (you have to set the classpath correctly first)

   java org.apache.log4j.test.Hello
  
   You should see log statements appearing on the console.

5) Refer to the javadoc documentation and the user manual on how to
   include log statements in your own code.

=========
JAR files
=========

The log4j distribution comes with two jar files: log4j-core.jar and
log4j.jar.

The first jar file contains the classes you need to use the package to
print to a file or the console.  The second jar file, in addition to
the code contained in the first file, contains classes to interact
with a Syslog daemon and code to output/receive log statements using
TCP sockets plus all sort of other goodies.

Note: If you install log4j.jar you DO NOT NEED to install
log4j-core.jar on your classpath.

==================
log4j dependencies
==================

   
The log4j distribution comes with pre-compiled classes. Log4j is based
on JDK 1.1 with the following additional requirements:

    ---------------------
    Package org.log4j.xml 
    ---------------------

    The DOMConfigurator is based on the DOM Level 1 API. The
    DOMConfigurator.configure(Element) method will work with any
    XML parser that will pass it a DOM tree.
    
    The DOMConfigurator.configure(String filename) method and its variants
    require a JAXP compatible XMLparser, for example the Apache Xerces
    parser. Compiling the DOMConfigurator requires the presence of a
    JAXP parser in the classpath.  

    Normaly Log4j is shipped with jaxp.jar and parser.jar files under the
    build/lib/ directory. In debian the xerces package is what you will need.

    -------------------
    RollingFileAppender	
    -------------------
 
    For rather involved reasons RollingFileAppender requires JDK 1.2
    or above. This will be fixed in future releases of log4j. If you
    need RollingFileAppender to run under JDK 1.1 then you can 
    simply remove RollingFileAppenderBeanInfo.class from log4j.jar.

    ------------
    SMTPAppender
    ------------

    The SMTPAppender relies on the JavaMail API. It has been tested with
    JavaMail API version 1.2. The JavaMail API requires the
    JavaBeans Activation Framework package. You can download the JavaMail API at:

	http://java.sun.com/products/javamail/

    and the JavaBeans Activation Framework at:

	http://java.sun.com/beans/glasgow/jaf.html

    -----------
    JMSAppender
    -----------
  
    The JMSAppender requires the JMS API as well as JNDI. The JMS API
    is usually bundled with the products of the vendors listed under

       http://java.sun.com/products/jms/vendors.html

    -----------------------
    JUnit testing framework
    -----------------------

    Log4j uses the JUnit framework for internal unit testing.  If you
    want to compile all log4j source code, then you will need
    JUnit. JUnit is available from:

          http://www.junit.org



 -- Ola Lundqvist <opal@debian.org>, Thu, 17 May 2001 10:29:02 +0200
