Apache Commons Cache
=====================

Welcome to the Cache component of the Apache Commons
project.

To compile this component, you'll need the
excellent Ant utility, which can be obtained from :

   http://jakarta.apache.org/ant/

For testing the project, you will also need JUnit :

  http://www.junit.org/

To let the test process find JUnit, you may make a
copy of the build.properties.sample file, rename to
build.properties,  and modify to reflect
the location of the junit.jar on your computer.

---

Once you have Ant propertly installed, and the
build.properties file correctly reflects the location
of your junit.jar, you are ready to build and test.

To compile and test the component :

$ ant test

To build a jar :

$ ant dist-jar

To build the API documentation :

$ ant doc

To build the jar and API doc at once :

$ ant dist

---

To build the Cache tag extension, you'll also need:

 * the J2EE Servlet/JSP classes (http://java.sun.com/j2ee)
 * the JOCL XML configuration utility
   (currently part of commons-dbcp: http://commons.apache.org/)

To build the tag extension, remove or comment out the
 <exclude name="org/apache/commons/cache/tagext/**" />
line in build.xml