You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4j-dev@logging.apache.org by ca...@apache.org on 2007/06/05 23:53:52 UTC
svn commit: r544649 - /logging/log4j/branches/v1_2-branch/INSTALL
Author: carnold
Date: Tue Jun 5 14:53:51 2007
New Revision: 544649
URL: http://svn.apache.org/viewvc?view=rev&rev=544649
Log:
Bug 37930: Update INSTALL to reflect Maven build
Modified:
logging/log4j/branches/v1_2-branch/INSTALL
Modified: logging/log4j/branches/v1_2-branch/INSTALL
URL: http://svn.apache.org/viewvc/logging/log4j/branches/v1_2-branch/INSTALL?view=diff&rev=544649&r1=544648&r2=544649
==============================================================================
--- logging/log4j/branches/v1_2-branch/INSTALL (original)
+++ logging/log4j/branches/v1_2-branch/INSTALL Tue Jun 5 14:53:51 2007
@@ -1,3 +1,18 @@
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
===========
Using log4j
@@ -9,10 +24,9 @@
PATH_OF_YOUR_CHOICE, untarring the distribution file should create
a logging-log4j-VERSION directory, where VERSION is the log4j
version number, under PATH_OF_YOUR_CHOICE. We will refer to the
- directory PATH_OF_YOUR_CHOICE/logging-log4j-VERSION/ as $LOG4J_HOME/.
+ directory PATH_OF_YOUR_CHOICE/apache-log4j-VERSION/ as $LOG4J_HOME/.
-3) Assuming you are using log4j version 1.2, add
- $LOG4J_HOME/dist/lib/log4j-1.2.jar to your CLASSPATH,
+3) Add $LOG4J_HOME/log4j-VERSION.jar to your CLASSPATH,
4) You can now test your installation by first compiling the following
simple program.
@@ -22,7 +36,7 @@
public class Hello {
- static Logger logger = Logger.getLogger(Hello.class);
+ private static final Logger logger = Logger.getLogger(Hello.class);
public
static
@@ -48,76 +62,20 @@
=========
The log4j distribution comes with one jar file: log4j-VERSION.jar
-under the LOG4J_HOME/dist/lib/ directory.
+under the LOG4J_HOME directory.
This jar file contains all the class files of the log4j project,
except test cases and classes from the "examples" and
"org.apache.log4j.performance" packages.
-==================
-log4j dependencies
-==================
-
-Log4j targets JDK 1.2 or later with the following additional requirements:
-
- ----------------------------
- Package org.apache.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.
-
-
- ------------
- 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 version 3.8.1 for internal unit
- testing. If you want to compile the source code in the tests/
- directory, then you will need JUnit. JUnit is available from:
-
- http://www.junit.org
==============
Building log4j
==============
-
-Like most Java applications today, log4j relies on ANT as its build
-tool. ANT is available from "http://ant.apache.org/". ANT
-requires a build file called build.xml which is part of this
-distribution. Required components from other projects are specified in
-the build.properties and example of which is supplied in the
-build.properties.sample file.
+
+log4j (as of 1.2.15) is built with Maven 2. To rebuild log4j-VERSION.jar,
+place Maven 2 on the PATH and execute "mvn package".
+
In case of problems send an e-mail note to
log4j-user@logging.apache.org. Please do not directly e-mail any
---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
For additional commands, e-mail: log4j-dev-help@logging.apache.org