| <?xml version="1.0"?> |
| <!-- |
| 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. |
| --> |
| <document> |
| <properties> |
| <title>Building</title> |
| <author email="dev@commons.apache.org">Commons Documentation Team</author> |
| </properties> |
| <body> |
| <!-- ================================================== --> |
| <section name="Overview"> |
| <p> |
| Commons Logging uses <a href="http://maven.apache.org">Maven 2.0.x</a> as its |
| primary build system. <a href="http://ant.apache.org">Ant</a> can also be used. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| <section name="Maven"> |
| <p> |
| To build the full website, run |
| </p> |
| <source>mvn site</source> |
| <p> |
| The result will be in the <code>target/site</code> folder. |
| You must be online and using JDK 1.4 or higher to successfully complete this target. |
| </p> |
| <p> |
| To build the jar files, run |
| </p> |
| <source>mvn package</source> |
| <p> |
| The resulting 4 jar files will be in the <code>target</code> folder. |
| You must use JDK 1.4 or higher to successfully complete this target. |
| </p> |
| <p> |
| To create a full distribution, run |
| </p> |
| <source>mvn clean site assembly:assembly</source> |
| <p> |
| The resulting .zip and .tar.gz files will be in the <code>target</code> folder. |
| You must use JDK 1.4 or higher to successfully complete this target. |
| </p> |
| <p> |
| Further details can be found in the |
| <a href="http://commons.apache.org/building.html">commons build instructions</a>. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| <section name="Ant"> |
| <p> |
| We still use Ant to test the artifacts built my Maven. |
| Please follow the instructions in the file <code>build-testing.xml</code>. |
| </p> |
| <p> |
| <b>Note:</b> A 1.2 JDK is needed to run the tests. |
| </p> |
| </section> |
| <!-- ================================================== --> |
| </body> |
| </document> |
