diff --git a/docs.xml b/docs.xml index b3b56d6f7..f27e1758e 100644 --- a/docs.xml +++ b/docs.xml @@ -37,21 +37,12 @@ - - - diff --git a/docs/LICENSE b/docs/LICENSE new file mode 100644 index 000000000..9cdfdea79 --- /dev/null +++ b/docs/LICENSE @@ -0,0 +1,49 @@ +/* + * ============================================================================ + * The Apache Software License, Version 1.1 + * ============================================================================ + * + * Copyright (C) 2000-2003 The Apache Software Foundation. All + * rights reserved. + * + * Redistribution and use in source and binary forms, with or without modifica- + * tion, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. The end-user documentation included with the redistribution, if any, must + * include the following acknowledgment: "This product includes software + * developed by the Apache Software Foundation (http://www.apache.org/)." + * Alternately, this acknowledgment may appear in the software itself, if + * and wherever such third-party acknowledgments normally appear. + * + * 4. The names "Ant" and "Apache Software Foundation" must not be used to + * endorse or promote products derived from this software without prior + * written permission. For written permission, please contact + * apache@apache.org. + * + * 5. Products derived from this software may not be called "Apache", nor may + * "Apache" appear in their name, without prior written permission of the + * Apache Software Foundation. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- + * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * This software consists of voluntary contributions made by many individuals + * on behalf of the Apache Software Foundation. For more information on the + * Apache Software Foundation, please see . + * + */ diff --git a/docs/ant15_todo.html b/docs/ant15_todo.html index 9bc5d426b..cf130e6b8 100644 --- a/docs/ant15_todo.html +++ b/docs/ant15_todo.html @@ -1,698 +1,657 @@ - - - - - + + - - - + + Apache Ant - Ant 1.5 Release To-Do List + + - - - Apache Ant - Ant 1.5 Release To-Do List - - - - - + + + +
+ + + - - - + +
- The Apache Jakarta Project - - Apache Ant -
- - - + +
-
-
+ + + - - -
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
-

Apache Ant

- -

Download

- -

Jakarta

- -

Get Involved

- -
- - - + +
- - Ant 1.5 Release To-Do List - -
-
- - - + + + + + +
- - Open - -
-
- + + + + + +
+
+ + + + + +
+ + + + +
Home
+
+
+
+ + + -
+ + + + - + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + -
+   + +   +
+
+ + + + +
+

Ant 1.5 Release To-Do List

+
+
+ + +
Ant 1.5 Release To-Do List
+
+ + + +
+ + Open + +
+ + + - - - + - - - + - - - + - - - + - - - + - - - +
- Item - - - + - Details - - - + - Assigned - - +
- Bugzilla bugs under 30 - - + - or at least address most of them in some way - - + - All Committers - -
- Document Path datatype - - + - It's documented, but more hidden than the other types - - + - Erik - -
- Novell NetWare support - - + -   - - + - Jeff Tulley - -
- XMLCatalog more integrated - - + - Several tasks could still use XMLCatalog integration - - + -   - -
- Make default excludes customizable - - + - With the setting of an ant.default.excludes property? - - + - Erik - -
- Fully functional on Java 1.4 - - + - Fix outstanding java1.4 defects, maybe add an assertions datatype for java and other tasks (junit?) which lets people turn on asserts. - - + - Steve + any other help he can get - -
- -
- - - -
- - Done - -
-
- +
+ +
+ +
+ + Done + +
+ - - - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - +
- Item - - + - Details - - - + - Assigned - - +
- Selectors - - + -   - - + - Bruce - -
- Extension utilities - - + - Port across task that prints out details of extensions for a certain library/jar, or all jars in a path. Port across task that generates a manifest (including dependencies and extension specification) based on a set of jars in path. Port across task that checks that the list of pre-req extensions are present in path. - - + - Peter - -
- XmlLogger implements BuildLogger - - + - Its currently a BuildListener, lets remove the confusion - - + - Erik - -
- Dotnet library tweaks - - + - update to release, add uptodateness, add a web service import (for Axis interop testing) - - + - Steve, in a really long meeting - -
- compiler attribute for rmic - - + -   - - + - Stefan - -
- PGP signing task if possible - - + - Not done, but deemed impossible - at least in the 1.5 time frame. - - + - Stefan - -
- JUnit's System.err/.out handling - - + - showoutput attribute has been added - doesn't work in some cases yet (same reason as bug PR 7980) - - + - Stefan - -
- Base compiler command line switches on the selected compiler, not the current JDK - - + -   - - + - Stefan - -
- <input> - - + -   - - + - Stefan - -
- Make javadoc a real directory based task - - + -   - - + - Stefan - -
-
-
- - - -
- - Bug Reports Short-Cuts - -
-
+
+ + + +
+ + Bug Reports Short-Cuts + +

Note: You can sort the report results by clicking on the column-headings.

- +
- + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - +
- New|Assigned|Reopened Bug Reports: - -
- All - -
- - minus Enhancements - -
- New|Assigned|Reopened Bug Reports by Component: - -
- Build Process - -
- - minus Enhancements - -
- Core - -
- - minus Enhancements - -
- Core Tasks - -
- - minus Enhancements - -
- Documentation - -
- - minus Enhancements - -
- Optional Tasks - -
- - minus Enhancements - -
- Other - -
- - minus Enhancements - -
- Wrapper Scripts - -
- - minus Enhancements - -
-
-
- -
-
+
+ + + + + + - - - -
-
-
-
- Copyright © 2000-2003, Apache Software Foundation -
-
- + + + + + diff --git a/docs/ant_in_anger.html b/docs/ant_in_anger.html index 74770ddd4..4960b8a62 100644 --- a/docs/ant_in_anger.html +++ b/docs/ant_in_anger.html @@ -21,7 +21,7 @@ Last updated 2002-11-09

Introduction

-Apache Ant +Apache Ant can be an invaluable tool in a team development process -or it can be yet another source of problems in that ongoing crises we call development . This @@ -212,7 +212,7 @@ you for shipping software that works.

Learn to Use and love the add-ons to Ant

The Ant distribution is not the limit of the Ant universe, it is only the beginning. Look at the - + External Tools and Tasks page for an up to date list. Here are some of them that . @@ -891,7 +891,7 @@ that suddenly becomes feasible. Use the mailing lists
There are two -mailing lists +mailing lists related to Ant, ant-user and ant-developer. Ant user is where all questions related to using Ant should go. Installation, syntax, code samples, etc -post your questions there or search the archives for @@ -1155,6 +1155,6 @@ so useful or as much fun). For questions related to this document, use the Ant mailing list.
-

Copyright © 2000-2002 Apache Software Foundation. All rights +

Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

diff --git a/docs/antnews.html b/docs/antnews.html index bf655a2df..d1a4bd188 100644 --- a/docs/antnews.html +++ b/docs/antnews.html @@ -1,143 +1,230 @@ - - - - - + + - - - + + Apache Ant - News + + - + - + - - - Apache Ant - Ant News - - - - - + + + +
+ + + + + + +
+ + + + + + + + - - - + +
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
+
+ + + + + +
+ + + + +
Home
+
+
+
- The Apache Jakarta Project - - Apache Ant -
- - - +
-
-
+ + + +
+ + + + + + + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + + + + + + +
+   + +   +
+
+ - - - +
+
-

Apache Ant

- -

Download

- -

Jakarta

- -

Get Involved

- -
- - - + +
- - Ant 1.5.1 - -
-
+
+

News

+
+
+ + +
Ant 1.5.1

October 3, 2002 - Ant 1.5.1 Available !

The final version of Ant 1.5.1 is now available for - + download. If you have any feedback on this release, feel free to join the discussion on the ant-dev and ant-user mailing lists.

- -
+
Ant 1.5.1Beta1
- - - +
+
- - Ant 1.5.1Beta1 - -
-

August 19, 2002 - Ant 1.5.1 Beta1 Available !

The first beta version of Ant 1.5.1 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

-
-
+
Ant 1.5
- - - +
+
- - Ant 1.5 - -
-

July 15, 2002 - Fix for Cygwin problem in wrapper script available

The wrapper script of Ant 1.5 needs to be replaced with a new version for Cygwin users. See the FAQ for details.

@@ -147,68 +234,37 @@ download. If you have any feedback on this release, feel free to join the discussion on the ant-dev and ant-user mailing lists.

-
-
+
Ant 1.5Beta3
- - - +
+
- - Ant 1.5Beta3 - -
-

June 24, 2002 - Ant 1.5 Beta3 Available!

The third beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

-
-
+
Ant 1.5Beta2
- - - +
+
- - Ant 1.5Beta2 - -
-

June 1, 2002 - Ant 1.5 Beta2 Available!

The second beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

-
-
+
Ant 1.5Beta1
- - - +
+
- - Ant 1.5Beta1 - -
-

Ant 1.5 Beta1 Available !

The first beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

-
-
+
Ant wins again!
- - - +
+
- - Ant wins again! - -
-

Apr 29, 2002: Ant wins Software Development magazine's 2002 Productivity Award.

@@ -219,17 +275,10 @@ press release for more information and the full list of winners.

-
-
+
Ant has won!
- - - +
+
- - Ant has won! - -
-

Mar 26, 2002: Ant wins the JavaWorld Editors' Choice Award

@@ -239,17 +288,10 @@ Read the full article -- or jump directly to the bit about our award :)

-
-
+
Java 1.4 Support
- - - +
+
- - Java 1.4 Support - -
-

Feb 15, 2002: Java 1.4 Support

Java 1.4 has now been released by Sun. The latest Ant source supports @@ -258,45 +300,24 @@ on Java 1.4 over Windows XP. If you have problems running Ant 1.4.1 on WinXP/Java 1.4, please use a recent build or compile your own version from the source tree.

-
-
+
See our new logo!
- - - +
+
- - See our new logo! - -
-

Have a look at our new cool logo!

-
-
+
Ant 1.4.1
- - - +
+
- - Ant 1.4.1 - -
-

11 October 2001 Ant 1.4.1 released !

Please visit the download area.

-
-
+
Ant 2.0 Requirements Collected - Next is Design
- - - +
+
- - Ant 2.0 Requirements Collected - Next is Design - -
-

A commented version of the collected user requirements is now available here - it is not complete as some details still have to be defined, but it should @@ -305,30 +326,16 @@ and prototypes. Several people are working on prototypes (that can be found in Ant's CVS module in the proposals directory) and discussion is going on on the Ant-Dev mailing list.

-
-
+
Best-Practices Profile of Ant at Sun's Dot-Com Builder
- - - +
+
- - Best-Practices Profile of Ant at Sun's Dot-Com Builder - -
-

Sun has released an introductory article on Ant on their Dot-Com Builder site on May 30 2001. See http://dcb.sun.com/practices/profiles/ant.jsp

-
-
+
Ant 2.0 Requirements
- - - -
- - Ant 2.0 Requirements - -
-

Ant has been in use for quite some time and has been used in ways never conceived when it was originally written. While Ant 1.x has continued to sucessfully evolve and grow, there are a number of limitations and inconsistencies that are now apparent and which need to @@ -364,28 +371,35 @@

If you want to shape the future of Ant, join the - Ant-Dev mailing list and contribute + Ant-Dev mailing list and contribute your ideas.

-
-
-
+
+ + + + + + - - - -
-
-
-
- Copyright © 2000-2003, Apache Software Foundation -
-
- + + + + + diff --git a/docs/bindownload.html b/docs/bindownload.html index de26349d6..b57454d0f 100644 --- a/docs/bindownload.html +++ b/docs/bindownload.html @@ -1,108 +1,209 @@ - - - - - + + - - - - - - Apache Ant - Downloading Ant - Binary Distribution - - - - - + + Apache Ant - Downloading Ant - Binary Distribution + + + + +
+ + + + + + +
+ + + + + + + + - - - + +
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
+
+ + + + + +
+ + + + +
Home
+
+
+
- The Apache Jakarta Project - - Apache Ant -
- - - +
-
-
+ + + +
+ + + + + + + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + + + + + + +
+   + +   +
+
+ - - - +
+
-

Apache Ant

- -

Download

- -

Jakarta

- -

Get Involved

- -
- - - + +
- - Downloading Ant - -
-
+
+

Downloading Ant - Binary Distribution

+
+
+ + +
Downloading Ant

Use the links below to download a binary distribution of Ant from one of our mirrors. You must -verify the integrity of -the downloaded files using signatures downloaded from our main +verify the integrity of the +downloaded files using signatures downloaded from our main distribution directory.

Ant is distributed as zip, tar.gz and tar.bz2 archives - the contents are the same. Please @@ -114,17 +215,10 @@ Thus they must be untarred with a GNU compatible version of

If you do not see the file you need in the links below, please see the master distribution directory or, preferably, its mirror.

- -
+
Mirror
- - - +
+
- - Mirror - -
-

You are currently using [preferred]. If you encounter a problem with this mirror, please select another mirror. If all mirrors are failing, there are backup mirrors (at the end of @@ -143,17 +237,10 @@ Other mirrors: -

-
+
Current Release of Ant
- - - +
+
- - Current Release of Ant - -
-

Currently, Apache Ant 1.5.1 is the best available version, see the release notes.

    @@ -172,46 +259,25 @@ Other mirrors:
+
Nightly Builds
- - - +
+
- - Nightly Builds - -
-

If you wish to use the latest Ant features, you can try downloading a nightly build.

-
-
+
Old Ant Releases
- - - +
+
- - Old Ant Releases - -
-

Older releases of Ant can be found here. Those releases are only provided as zip archives that can be extracted by jar xf archive.zip - we highly recommend to not use those releases but upgrade to Ant's latest release.

-
-
+
Verify Releases
- - - -
- - Verify Releases - -
-

It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures.

The PGP signatures can be verified using PGP or GPG. First @@ -241,25 +307,32 @@ included in many unix distributions. It is also available as part of Textutils. Windows users can get binary md5 programs from here, here, or here.

We highly recommend to verify the PGP signature, though.

-
-
-
+
+ + + + + + - - - -
-
-
-
- Copyright © 2000-2003, Apache Software Foundation -
-
- + + + + + diff --git a/docs/breadcrumbs.js b/docs/breadcrumbs.js new file mode 100644 index 000000000..e0c10c402 --- /dev/null +++ b/docs/breadcrumbs.js @@ -0,0 +1,257 @@ +/* + + ============================================================================ + The Apache Software License, Version 1.1 + ============================================================================ + + Copyright (C) 2002-2003 The Apache Software Foundation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modifica- + tion, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + + 3. The end-user documentation included with the redistribution, if any, must + include the following acknowledgment: "This product includes software + developed by the Apache Software Foundation (http://www.apache.org/)." + Alternately, this acknowledgment may appear in the software itself, if + and wherever such third-party acknowledgments normally appear. + + 4. The names "Apache" and "Apache Software Foundation" + must not be used to endorse or promote products derived from this software + without prior written permission. For written permission, please contact + apache@apache.org. + + 5. Products derived from this software may not be called "Apache", nor may + "Apache" appear in their name, without prior written permission of the + Apache Software Foundation. + + THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, + INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- + DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + This software consists of voluntary contributions made by many individuals + on behalf of the Apache Software Foundation. For more information on the + Apache Software Foundation, please see . + +*/ + +/** + * This script, when included in a html file, builds a neat breadcrumb trail + * based on its url. That is, if it doesn't contains bugs (I'm relatively + * sure it does). + * + * Typical usage: + * + * + *@author Leo Simons (main author) + *@author Nicola Ken Barozzi (integration in skin) + *@created July 12, 2002 + *@version 1.0 + */ + +/* ======================================================================== + CONSTANTS + ======================================================================== */ + +/** + * Two-dimensional array containing extra crumbs to place at the front of + * the trail. Specify first the name of the crumb, then the URI that belongs + * to it. You'll need to modify this for every domain or subdomain where + * you use this script (you can leave it as an empty array if you wish) + */ +var PREPREND_CRUMBS = new Array(); + if(!("apache"=="")){ + PREPREND_CRUMBS.push( new Array( "apache", "http://www.apache.org/" ) ); + } + if(!("xml.apache"=="")){ + PREPREND_CRUMBS.push( new Array( "ant.apache", "http://ant.apache.org/" ) ); + } + if(!(""=="")){ + PREPREND_CRUMBS.push( new Array( "", "" ) ); + } + +/** + * String to include between crumbs: + */ +var DISPLAY_SEPARATOR = " > "; +/** + * String to include at the beginning of the trail + */ +var DISPLAY_PREPREND = ""; +/** + * String to include at the end of the trail + */ +var DISPLAY_POSTPREND = ""; + +/** + * CSS Class to use for a single crumb: + */ +var CSS_CLASS_CRUMB = "breadcrumb"; + +/** + * CSS Class to use for the complete trail: + */ +var CSS_CLASS_TRAIL = "breadcrumbTrail"; + +/** + * CSS Class to use for crumb separator: + */ +var CSS_CLASS_SEPARATOR = "crumbSeparator"; + +/** + * Array of strings containing common file extensions. We use this to + * determine what part of the url to ignore (if it contains one of the + * string specified here, we ignore it). + */ +var FILE_EXTENSIONS = new Array( ".html", ".htm", ".jsp", ".php", ".php3", ".php4" ); + +/** + * String that separates parts of the breadcrumb trail from each other. + * When this is no longer a slash, I'm sure I'll be old and grey. + */ +var PATH_SEPARATOR = "/"; + +/* ======================================================================== + UTILITY FUNCTIONS + ======================================================================== */ +/** + * Capitalize first letter of the provided string and return the modified + * string. + */ +function sentenceCase( string ) +{ + var lower = string.toLowerCase(); + return lower.substr(0,1).toUpperCase() + lower.substr(1); +} + +/** + * Returns an array containing the names of all the directories in the + * current document URL + */ +function getDirectoriesInURL() +{ + var trail = document.location.pathname.split( PATH_SEPARATOR ); + + // check whether last section is a file or a directory + var lastcrumb = trail[trail.length-1]; + for( var i = 0; i < FILE_EXTENSIONS.length; i++ ) + { + if( lastcrumb.indexOf( FILE_EXTENSIONS[i] ) ) + { + // it is, remove it and send results + return trail.slice( 1, trail.length-1 ); + } + } + + // it's not; send the trail unmodified + return trail.slice( 1, trail.length ); +} + +/* ======================================================================== + BREADCRUMB FUNCTIONALITY + ======================================================================== */ +/** + * Return a two-dimensional array describing the breadcrumbs based on the + * array of directories passed in. + */ +function getBreadcrumbs( dirs ) +{ + var prefix = "/"; + var postfix = "/"; + + // the array we will return + var crumbs = new Array(); + + if( dirs != null ) + { + for( var i = 0; i < dirs.length; i++ ) + { + prefix += dirs[i] + postfix; + crumbs.push( new Array( dirs[i], prefix ) ); + } + } + + // preprend the PREPREND_CRUMBS + if(PREPREND_CRUMBS.length > 0 ) + { + return PREPREND_CRUMBS.concat( crumbs ); + } + + return crumbs; +} + +/** + * Return a string containing a simple text breadcrumb trail based on the + * two-dimensional array passed in. + */ +function getCrumbTrail( crumbs ) +{ + var xhtml = DISPLAY_PREPREND; + + for( var i = 0; i < crumbs.length; i++ ) + { + xhtml += ''; + xhtml += sentenceCase( crumbs[i][0] ) + ''; + if( i != (crumbs.length-1) ) + { + xhtml += DISPLAY_SEPARATOR; + } + } + + xhtml += DISPLAY_POSTPREND; + + return xhtml; +} + +/** + * Return a string containing an XHTML breadcrumb trail based on the + * two-dimensional array passed in. + */ +function getCrumbTrailXHTML( crumbs ) +{ + var xhtml = ''; + xhtml += DISPLAY_PREPREND; + + for( var i = 0; i < crumbs.length; i++ ) + { + xhtml += ''; + xhtml += sentenceCase( crumbs[i][0] ) + ''; + if( i != (crumbs.length-1) ) + { + xhtml += '' + DISPLAY_SEPARATOR + ''; + } + } + + xhtml += DISPLAY_POSTPREND; + xhtml += ''; + + return xhtml; +} + +/* ======================================================================== + PRINT BREADCRUMB TRAIL + ======================================================================== */ + +// check if we're local; if so, only print the PREPREND_CRUMBS +if( document.location.href.toLowerCase().indexOf( "http://" ) == -1 ) +{ + document.write( getCrumbTrail( getBreadcrumbs() ) ); +} +else +{ + document.write( getCrumbTrail( getBreadcrumbs( getDirectoriesInURL() ) ) ); +} + diff --git a/docs/contributors.html b/docs/contributors.html new file mode 100644 index 000000000..7196811f2 --- /dev/null +++ b/docs/contributors.html @@ -0,0 +1,491 @@ + + + + + + + + Apache Ant - Contributors + + + + + + + + + + + +
+ + + + + + + + + + + +
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
+
+ + + + + +
+ + + + +
Home
+
+
+
+ + + + +
+ + + + + + + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + + +
+   + +   +
+
+ + + + +
+

Contributors

+
+
+ + +
Project Management Committee
+
+ + + +
+ + Active Members + +
+

+ Bruce Atherton (bruce at callenish.com - http://www.callenish.com/~bruce) +
+Currently a Systems Architect with Avue Technologies, Bruce has been +working with Java since version 1.0a2. He also claims to be one of the first +people to mark up a FAQ with HTML, for a web browser of the distant past +called Cello. +

+

+ Stephane Bailliez
+

+

+ Stefan Bodewig (stefan.bodewig at epost.de) +
+Stefan is a senior developer at BoST interactive, where he is mainly +responsible for a rule based configurator system. He spends some +time working on Open Source projects with Ant currently taking the +biggest share of it. +

+

+ Erik Hatcher (ehatcher at apache.org - http://erik.hatcher.net) +
+Erik is the co-author of +Java Development with Ant and speaks on Ant and other topics at +No Fluff, Just Stuff +symposiums as well as other venues. Erik is the President of +eHatcher Solutions, Inc. +

+

+ Diane Holt
+

+

+ Donald Leslie
+

+

+ Steve Loughran
+

+

+ Conor MacNeill (conor at cortexebusiness.com.au) +
+Conor is a senior developer at Cortex eBusiness, where he develops +J2EE based systems. In his spare time he helps with the development of +the Ant build tool. He is also serving as the Chairman of this PMC. +

+

+ Costin Monolache
+

+

+ + Sam Ruby + + (rubys at us.ibm.com) +
+Sam takes a perverse pleasure in integrating disparate things. He is +a member of the PHP group, Apache +XML PMC, Apache +sponsor for the xml-soap subproject +and convener of ECMA TC39 TG3. He is +also serving as the Chairman of the Jakarta PMC. +

+

+ Jon Skeet
+

+

+ Magesh Umasankar (umagesh at apache.org) +
+Magesh is a lead software developer at +Manugistics, where +he is responsible for some of the Revenue Optimization +solutions. +

+

+ Christoph Wilhelms (christoph.wilhelms at t-online.de) +
+Christoph is teamleader and a lead software engineer at +IMPRESS SOFTWARE. He is resposible for +the development of administration tools and development environment for +the IMPRESS Engine, a Java-based intergration software. At the Ant-Project +he takes care of Antidote - the Ant GUI. +

+
+ + + +
+ + Emeritus Members + +
+

+ James Duncan Davidson (duncan at x180.net - http://x180.net/) +
+ +By day, Duncan works in the Open Source Program Office at Sun +Microsystems where he helps various Open Source efforts within Sun +"do the right thing". Previously at Sun he was responsible +for the Servlet API Specifications 2.1 and 2.2 as well as the Java API +for XML Parsing 1.0 and was the original author of Tomcat and Ant. He +was one of the rabble-rousers within Sun that helped make the Jakarta +Project a reality and served as the first Chairman of the Jakarta PMC. +

+
+ + +
Committers
+
+ + + +
+ + Active Committers + +
+

+ Preston Bannister
+

+

+ Nick Davis
+

+

+ Darrell DeBoer
+

+

+ Peter Donald (peter at apache.org) +
+ +Peter is an avid java developer who is active in the +Avalon and +Ant projects. +In his spare time he develops a distributed virtual environment +(ie military simulator or 3D game) using java technologies. +

+

+ Danno Ferrin (shemnon at yahoo.com) +
+Danno has been programming in Java since Summer 96. Danno wrote a JSP +engine on his own and released it the very same day Jakarta was +announced at JavaOne. Since then, he decided to join the Jakarta +project in a spirit of co-operation over competition. +

+

+ + Jason Hunter (jh at servlets.com) +
+Jason is author of "Java Servlet Programming" (O'Reilly) and publisher +of http://www.servlets.com/. +He works at CollabNet. +

+

+ Arun Jamwal +
+

+

+ Arnout J. Kuiper (ajkuiper at planet.nl) +
+ +Arnout J. Kuiper is a Java Architect with the Sun Java Center at Sun +Microsystems. His main focus is web-related technologies on the Java +platform (J2EE, XML, ...). +

+

+ Adam Murdoch +
+

+

+ Harish Prabhandham (harishp at onebox.com) +
+Harish is an engineer with the J2EE team at Sun, primarily responsible +for implementing security in the J2EE Reference Implementation +(RI). He integrated various technologies including servlet/JSP +implementations from Tomcat into the J2EE RI. These days, he hacks PHP +code during the day. +

+

+ Nico Seessle
+

+

+ Gal Shachor (shachor at il.ibm.com) +
+Gal Shachor is a research staff member at IBM. He wrote his first +Servlet container (ServletExpress) at the beginning of 1997. Later on +ServletExpress (and Gal) merged into WebSphere, and Gal participated +in the development of WebSphere 1, 2 and 3. +

+

+ Jon S. Stevens (jon at collab.net) +
+ +Jon is a Co-Founder of Clear Ink +Corp and recently left to work on Scarab a next generation Open +Source Java Servlet based Issue/Bug tracking system for CollabNet. He is an active developer +of the Apache JServ Servlet +Engine for the Apache Web Server and Co-Author of the Element Construction Set as +well as the web application framework, Turbine. +

+

+ James Todd (jwtodd at pacbell.net) +
+James has developed real time customer oriented apps for roughly 10 +years the last 5 of which have predominately been fully integrated, +front and back, extraNet implementations which have been based on +Apache, Java and Tcl. +

+

+ Anil Vijendran (akv at eng.sun.com) +
+Anil Vijendran is the principal developer of the JSP engine in +Tomcat. He's done some pretty scary things in his past life -- +implementing the CORBA IDL to C++ 2.0 mapping, skydiving, IDL to Java +compilers, Object Databases (SIGSEV, you da man!) for C++, Java ORB +and EJB runtime environments -- in that order. +

+
+ + + +
+ + Emeritus Committers + +
+

+ Simeon H.K. Fitch (simeon.fitch at mseedsoft.com) +
+Simeon is owner of Mustard Seed Software, which specializes in developing +distributed applications and user interfaces for the science, engineering, +and research oriented clients. He is the lead architect and developer for +Antidote, the GUI for Ant. +

+

+ Thomas Haas +
+

+

+ Stefano Mazzocchi (stefano at apache.org) +
+Stefano is addicted to software design, Java programming and +open development. In the last 4 years, he has contributed way too much +time to Apache, expecially on JServ, JMeter, Avalon, JAMES, Ant, Cocoon +and helping to bring more projects into Apache-land, such as FOP, Batik, +POI and Xindice. The problem is that he's too picky to be satisfied :-) +

+

+ Glenn McAllister (glenn at somanetworks.com) +
+Glenn McAllister is a software developer at SOMA Networks, was formerly +the same at IBM (plus tech writer plus build guy), and does some writing +on the side for the VADD Technical Journal. +

+ + +
+
+
+ + + + + + + +
+ + + + + + + + + + + diff --git a/docs/cvs.html b/docs/cvs.html new file mode 100644 index 000000000..946832298 --- /dev/null +++ b/docs/cvs.html @@ -0,0 +1,251 @@ + + + + + + + + Apache Ant - CVS Repositories + + + + + + + + + + + +
+ + + + + + + + + + + +
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
+
+ + + + + +
+ + + + +
Home
+
+
+
+ + + + +
+ + + + + + + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + + +
+   + +   +
+
+ + + + +
+

CVS Repositories

+
+
+ + +
Access the Source Tree (AnonCVS)
+

Anyone can checkout source code from our anonymous CVS + server. To do so, simply use the following commands (if you are + using a GUI CVS client, configure it appropriatly):

+
+cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
+password: anoncvs
+
+cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout [module-name]
+

Modules available for access are (click the links to view the + CVS tree via ViewCVS):

+ +

If you are not familiar with CVS, Jakarta's + CVS page may hold many helpful hints.

+ + +
+
+
+ + + + + + + +
+ + + + + + + + + + + diff --git a/docs/external.html b/docs/external.html index 5d7697fc2..5234b368b 100644 --- a/docs/external.html +++ b/docs/external.html @@ -1,105 +1,207 @@ - - - - - + + - - - + + Apache Ant - External Tools and Tasks + + - - - Apache Ant - External Tools and Tasks - - - - - + + + +
- - - + + + + +
- The Apache Jakarta Project - - Apache Ant -
- - - + +
-
-
- - - + +
-

Apache Ant

- -

Download

- -

Jakarta

- -

Get Involved

- -
- - - + + + + + + + +
- - External Tools and Tasks - -
-
+
Apache Ant siteApache Ant logo +
+ + + + + + + + + + +
+
+ + the Apache Ant site + + +
+
+
+
+ + + + + +
+ + + + +
Home
+
+
+
+ + + + + + + + +
+ + + + + + + + + + +
+ + + + + + + + + + +
 
+
+ +
+
+ + + + + + + + + + + + +
+
+   + +   +
+
+ + + + +
+

External Tools and Tasks

+
+
+ + +
External Tools and Tasks

This page lists external resources for Apache Ant: tasks, IDE integration tools, loggers, you name it. If you've written something that should be included, please post all relevant @@ -108,168 +210,126 @@

Nothing listed here is directly supported by the Ant developers, if you encounter any problems with them, please use the contact information.

- -
+
Tasks
- - - +
+
- - Tasks - -
-
- - - -
- - AJC - -
-
+
+ + + +
+ + AJC + +

AspectJ is an aspect-oriented extension to Java. This task compiles a source tree using the AspectJ compiler -- AJC.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 - -
- URL: - - + - http://aspectj.org/dl - -
- Contact: - - + - support@aspectj.org - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Anakia - -
-
+
+ + + +
+ + Anakia + +

Actually, Anakia is more than just an Ant task, it is a an XML transformation tool based on JDOM, Velocity and Ant.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.2 and later - -
- URL: - - + - http://jakarta.apache.org/velocity/anakia.html - -
- Contact: - - + - Velocity mailing lists - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Anteater - -
-
+
+ + + +
+ + Anteater + +

Anteater is a set of Ant tasks for the functional testing of websites and web services (functional testing being; hit a URL and ensure the response meets certain criteria). Can test HTTP params, response @@ -277,298 +337,226 @@ (based on junitreport) and a hierarchical grouping system for quickly configuring large test scripts.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5 and later - -
- URL: - - + - http://aft.sourceforge.net - -
- Contact: - - + - developer mailing list - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Checkstyle - -
-
+
+ + + +
+ + Checkstyle + +

Checkstyle is a development tool to help programmers write Java code that adheres to a coding standard. Its purpose is to automate the process of checking Java code, and to spare humans of this boring (but important) task.

Checkstyle can be run via an Ant task or a command line utility.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.2 to 1.4.1 - -
- URL: - - + - http://checkstyle.sourceforge.net/ - -
- Contact: - - + - Oliver Burn - -
- License: - - + - Starting with release 2.0 the license is the GNU Lesser General Public License. Prior releases were under the GNU General Public License. - -
-
-
- - - -
- - CleanImports - -
-
+
+ + + +
+ + CleanImports + +

Removes unneeded imports. Formats your import sections. Flags ambiguous imports.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 - -
- URL: - - + - http://www.euronet.nl/users/tomb/cleanImports/index.html - -
- Contact: - - + - Tom Brus - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Clover - -
-
+
+ + + +
+ + Clover + +

Clover is an Ant-based Code Coverage tool. It can be used seamlessly with Ant-based projects. It provides method, statement, and branch coverage analysis, and has rich reporting in XML, HTML or via a Swing GUI.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4.1 or greater - -
- URL: - - + - http://www.thecortex.net/clover - -
- Contact: - - + - clover-support@cortexebusiness.com.au - -
- License: - - + - Commercial, free licenses available for open source projects. - -
-
-
- - - -
- - Configure - -
-
+
+ + + +
+ + Configure + +

Recursive build support (call ant on every package level, and only build files in that package or in that package and everything below) with seperation of source and output.

@@ -576,351 +564,263 @@ for CVS-directories) for you. Only place one build.xml file in the top and call target 'setup' or 'rescan'.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.2 and 1.3 - -
- URL: - - + - http://www.dsdelft.nl/~lemval/ant/ - -
- Contact: - - + - M.J.P. van Leeuwen - -
- License: - - + - License derived from Apache Software License - -
-
-
- - - -
- - CVSGrab - -
-
+
+ + + +
+ + CVSGrab + +

A little CVS client that can be useful when people are behind corporate firewall that blocks any cvs communications. It uses the ViewCVS web interface to access the CVS repository via standard http, and downloads all the files present in it.

It works from the command line or as an Ant task.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 or higher - -
- URL: - - + - http://cvsgrab.sourceforge.net/ - -
- Contact: - - + - CVSGrab user mailing list - -
- License: - - + - LGPL - -
-
-
- - - -
- - Doxygen task - -
-
+
+ + + +
+ + Doxygen task + +

There are two Ant tasks for running the Doxygen documentation system.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.1 and later - -
- URL: - - + - http://www.bgw.org/projects/java/ant/ - -
- Contact: - - + - Kyle R. Burton - -
- License: - - + - Apache Software Foundation License - -

and

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5 and later - -
- URL: - - + - http://ant-doxygen.sourceforge.net - -
- Contact: - - + - Karthik A Kumar - -
- License: - - + - Apache Software Foundation License - -
-
-
- - - -
- - GenJar - -
-
+
+ + + +
+ + GenJar + +

Builds a JAR file based on class dependencies rather than simply the contents of a directory

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 alpha (built after 2001/08/04) and later - -
- URL: - - + - http://genjar.sourceforge.net/ - -
- Contact: - - + - Jesse Stockall - -
- License: - - + - Apache Software Foundation License - -
-
-
- - - -
- - Greebo - -
-
+
+ + + +
+ + Greebo + +

Greebo is an Ant-task for downloading dependency files (currently only jars) from a network to a specified directory, much like Maven. It supports multiple local and remote @@ -928,336 +828,250 @@ read the dependency list from a Maven project file, a maven-like dependency file, or directly from the build.xml file.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5 - -
- URL: - - + - http://www.discore.com/oz/new/index.htm - -
- Contact: - - + - Ozben Evren - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Importscrubber - -
-
+
+ + + +
+ + Importscrubber + +

Removes unnecessary import statements from a Java source code file.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 - -
- URL: - - + - http://importscrubber.sourceforge.net/ - -
- Contact: - - + - Tom Copeland - -
- License: - - + - LGPL - -
-
-
- - - -
- - IsDirValidator - -
-
+
+ + + +
+ + IsDirValidator + +

Checks whether a given directory structure conforms to certain rules that are defined via nested elements of the task.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 - -
- URL: - - + - http://isvalidator.sourceforge.net/en/isDirValidator.htm - -
- Contact: - - + - Iñigo Serrano - -
- License: - - + - GNU General Public License - -
-
-
- - - -
- - J2ME Ant Tasks - -
-
+
+ + + +
+ + J2ME Ant Tasks + +

There are three different sets of tasks to help build Java 2 Platform, Micro Edition (J2ME) applications.

This set supports CLDC and the K Virtual Machine (KVM):

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 - -
- URL: - - + - http://www.dribin.org/dave/j2me_ant/ - -
- Contact: - - + - Dave Dribin - -
- License: - - + - Apache Software License - -

And this set works with the J2ME Wireless Toolkit and MIDP for PalmOS:

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.3 - -
- URL: - - + - http://www.stampysoft.com/ant/ - -
- Contact: - - + - Josh Eckels - -
- License: - - + - MIT License - -

With Antenna, you can compile, preverify, package, and @@ -1266,148 +1080,112 @@ mostly built around the Wireless Toolkit and the free RetroGuard obfuscator, with some additional gimmicks like automatic version numbering.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4.1 or later - -
- URL: - - + - http://antenna.sourceforge.net/ - -
- Contact: - - + - Jörg Pleumann - -
- License: - - + - GNU Lesser General Public License - -
-
-
- - - -
- - Jalopy - -
-
+
+ + + +
+ + Jalopy + +

An Ant Plug-in for the Java Source Code Formatter Jalopy.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 (or higher) - -
- URL: - - + - http://jalopy.sourceforge.net - -
- Contact: - - + - http://jalopy.sf.net/contact.html - -
- License: - - + - Starting with release 1.0 Beta 6 the license is the BSD License. Prior releases were under the GNU General Public License. - -
-
-
- - - -
- - Java+ Precompile Task - -
-
+
+ + + +
+ + Java+ Precompile Task + +

Java+ is an open source Java preprocessorthat adds these features to any Java compiler:

    @@ -1433,352 +1211,266 @@
  • Simple, general, recursive, digraph-driven string syntax. Digraph characters are user-selectable.
- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5.1 - -
- URL: - - + - http://virtualschool.edu/java+/ - -
- Contact: - - + - Brad Cox - -
- License: - - + - BSD-like License - -
-
-
- - - -
- - Javamake - -
-
+
+ + + +
+ + Javamake + +

A task to compile Java sources and manage class file dependencies. Functionality is equivalent to that of standard Javac and Depend tasks combined, with improved dependency checking.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4.1 - -
- URL: - - + - http://www.experimentalstuff.com/Technologies/JavaMake/index.html - -
- Contact: - - + - Mikhail Dmitriev - -
- License: - - + - BSD-like License - -
-
-
- - - -
- - javarec - -
-
+
+ + + +
+ + javarec + +

Ant tasks that generate record classes for VisualAge for Java from Cobol copy books.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 - -
- URL: - - + - http://glezen.org/javarec/ - -
- Contact: - - + - Paul Glezen - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - JCSC - -
-
+
+ + + +
+ + JCSC + +

JCSC is a Java Coding Standard Checker which also features the generation of some code metrics. It is a command line tool with an Ant task to scan whole package trees. The result can viewed in an JavaDoc style web page.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant >= 1.5 - -
- URL: - - + - http://jcsc.sourceforge.net/ - -
- Contact: - - + - Ralph Jocham - -
- License: - - + - GNU General Public License - -
-
-
- - - -
- - Jing Task - -
-
+
+ + + +
+ + Jing Task + +

Validates XML files against the RELAX NG alternative to XML Schema. The Jing task for Ant allows you to efficiently validate multiple files against multiple RELAX NG patterns and integrate RELAX NG validation with other XML processing.

- +
- - + - - + - - +
- Compatibility: - - + - Ant 1.4 and later - -
- URL: - - + - http://www.thaiopensource.com/relaxng/jing-ant.html - -
- License: - - + - BSD-like - -
-
-
- - - -
- - jMetra - -
-
+
+ + + +
+ + jMetra + +

jMetra is a tool for collecting code metrics across a project lifecycle and compiling the results into JavaDoc-styled documentation to analyze project metrics over @@ -1786,81 +1478,63 @@ project's scheduled build process.

It works from the command line or using several provided Ant tasks.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 and higher - -
- URL: - - + - http://www.jmetra.com/ - -
- Contact: - - + - R Todd Newton - -
- License: - - + - Commercial, free licenses for open source projects and evaluations. - -
-
-
- - - -
- - JNI - -
-
+
+ + + +
+ + JNI + +

JNI is a free toolkit that makes easy work of @@ -1878,150 +1552,114 @@ invoked either from Ant or from the GUI. Includes a comprehensive printable PDF User Guide and plenty of examples.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 - -
- URL: - - + - http://jnipp.sf.net/ - -
- Contact: - - + - Phillip E. Trewhella - -
- License: - - + - GNU LGPL - -
-
-
- - - -
- - JRun Ant Tasks - -
-
+
+ + + +
+ + JRun Ant Tasks + +

JRun 4 SP1 ships with lib/jrun-ant-tasks.jar, which defines three Ant tasks: jrun, jrunapp, and jrunjmx. Documentation for the tasks can be found in JRun under docs/ant/jrun.html.

Note that the service pack must be installed on top of an existing JRun 4 installation.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 or higher - -
- URL: - - + - http://dynamic.macromedia.com/bin/MM/software/trial/hwswrec.jsp?product=jrun_sp - -
- Contact: - - + - Brian Deitte - -
- License: - - + - Commercial - -
-
-
- - - -
- - Macker - -
-
+
+ + + +
+ + Macker + +

A build-time architectural testing tool, designed to maintain clean layering / tiering / modularity. Macker works against compiled class files, checking @@ -2030,363 +1668,273 @@ project in an XML rules file. Macker doesn't presume anything about your architecture -- you write the rules, and Macker keeps you honest about them.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5 and higher (1.4 untested but may work) - -
- URL: - - + - http://innig.net/macker/ - -
- Contact: - - + - Paul Cantrell - -
- License: - - + - GNU GPL 2.0 - -
-
-
- - - -
- - pack - -
-
+
+ + + +
+ + pack + +

pack is a task to build the smallest possible JAR to link and run one or more classes.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5 - -
- URL: - - + - http://sadun-util.sourceforge.net/pack.html - -
- Contact: - - + - Cristiano Sadun - -
- License: - - + - GNU Lesser General Public License - -
-
-
- - - -
- - PMD - -
-
+
+ + + +
+ + PMD + +

PMD checks Java source code for unused variables, unnecessary object creation, etc

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 and higher - -
- URL: - - + - http://pmd.sf.net/ - -
- Contact: - - + - Tom Copeland - -
- License: - - + - Apache Software Foundation License - -
-
-
- - - -
- - Purge - -
-
+
+ + + +
+ + Purge + +

Purge deletes all but the most recent few files from a fileset. For example: if you have generated files (logs, .ear, .war, .jar etc) accumulating in a directory, the purge task will allow you to delete the older files, keeping just the most recent ones.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.4 or above - -
- URL: - - + - http://www.dallaway.com/ant/ - -
- Contact: - - + - Richard Dallaway - -
- License: - - + - LGPL - -
-
-
- - - -
- - SerialVer - -
-
+
+ + + +
+ + SerialVer + +

SerialVer adds the Java serialver functionality to Apache Ant. This project adds Tasks and FilterReaders to get, to insert and to modify the serialVersionUID in the source code of a serializable class.

- +
- - + - - + - - + - - +
- Compatibility: - - + - Ant 1.5.1 and later - -
- URL: - - + - http://serialver.sourceforge.net/ - -
- Contact: - - + - developer mailing list - -
- License: - - + - Apache Software License - -
-
-
- - - -
- - Styler - -
-
+
+ + + +
+ + Styler + +

The styler task makes useful combinations of XSLT transformations easy to specify in an Ant build file. Like the built-in Ant task style, styler can apply a single transformation to a set of XML files. @@ -2400,439 +1948,331 @@

  • use any custom XMLReader or XMLFilter class to handle new file formats and transformation techniques.
  • - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.4 - -
    - URL: - - + - http://www.langdale.com.au/styler/ - -
    - Contact: - - + - Arnold deVos - -
    - License: - - + - LGPL - -
    -
    -
    - - - -
    - - Tidy Imports (Tim) - -
    -
    +
    + + + +
    + + Tidy Imports (Tim) + +

    Tim is a handy utility that can be executed on the command line or via Ant that automatically formats your import declarations. Tim is capable of removing unused imports, expanding or collapsing imports and even organising them into pre-determined groups.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.3 and later - -
    - URL: - - + - http://www.chive.com/tim.htm - -
    - Contact: - - + - support@chive.com - -
    - License: - - + - Commercial - -
    -
    -
    - - - -
    - - TiniAnt - -
    -
    +
    + + + +
    + + TiniAnt + +

    TiniAnt is an Ant task to support building applications for the TINI.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.2 to 1.4.1 - -
    - URL: - - + - http://tiniant.sourceforge.net/ - -
    - Contact: - - + - Sean Kelly - -
    - License: - - + - BSD-like license - -
    -
    -
    - - - -
    - - Venus Application Publisher's (Vamp) Ant Task Suite - -
    -
    +
    + + + +
    + + Venus Application Publisher's (Vamp) Ant Task Suite + +

    Venus Application Publisher's (Vamp) Ant Task Suite allows you to sign and package your applications into relocatable Web Archives that you can drop into your web server for single-click launching using Java Web Start or into single Java Archive installers that serve up their content through a built-in, multi-threaded, ultra light-weight web server.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.2 and 1.3 - -
    - URL: - - + - http://www.geocities.com/vamp201/ant.html - -
    - Contact: - - + - Gerald Bauer - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - Version_Tool - -
    -
    +
    + + + +
    + + Version_Tool + +

    A versioning tool for Ant.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.5.1 - -
    - URL: - - + - http://ant.ryangrier.com/ - -
    - Contact: - - + - version_tool@ryangrier.com - -
    - License: - - + - BSD license - -
    -
    -
    - - - -
    - - VPP - -
    -
    +
    + + + +
    + + VPP + +

    VPP provides general file preprocessing support based on the Velocity Template Engine. The core funtionality is provided as a filter for use with tasks that supports filter chains. Also included are replacement tasks for <copy> and <javac> that integrate support for preprocessing.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - 1.5.1 and above - -
    - URL: - - + - http://vpp.sourceforge.net/ - -
    - Contact: - - + - vpp-user@lists.sourceforge.net - -
    - License: - - + - BSD license - -
    -
    -
    - - - -
    - - WOProject - -
    -
    +
    + + + +
    + + WOProject + +

    WOProject provides a set of tools to work with WebObjects 5.1 independent from platform and IDE. It significantly @@ -2840,211 +2280,161 @@ and makes complex project structures more flexible compared to traditional Makefile-based approach.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.4 - -
    - URL: - - + - http://objectstyle.org/woproject/ - -
    - Contact: - - + - Andrus Adamchik - -
    - License: - - + - Apache license - -
    -
    -
    - - - -
    - - XDoclet - -
    -
    +
    + + + +
    + + XDoclet + +

    XDoclet is an extended Javadoc Doclet engine for use in Ant. It lets you create custom Javadoc @tags and based on those tags generates source code or other files (such as xml-ish deployment descriptors). Templates and matching tasks are provided to generate EJB and web application deployment descriptors.

    - +
    - - + - - + - - +
    - Compatibility: - - + - Ant 1.4 - -
    - URL: - - + - http://sourceforge.net/projects/xdoclet/ - -
    - License: - - + - BSD license - -
    -
    -
    - - - -
    - - XmlTask - -
    -
    +
    + + + +
    + + XmlTask + +

    XmlTask provides a simple means to modify XML documents without having to learn XSLT. A simple path reference to an XML node specifies the node you want to change, and how you want to allow XML insertion and removal, or attribute changes. The emphasis is on providing the simplest means to perform common XML replacements

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.4 and later - -
    - URL: - - + - http://www.oopsconsultancy.com/software/xmltask.html - -
    - Contact: - - + - xmltask@oopsconsultancy.com - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - yGuard - -
    -
    +
    + + + +
    + + yGuard + +

    yGuard is a free Java(TM) Bytecode Obfuscator Task that needs no external script or project files. It can completely be configured and run through the Ant build script. The task @@ -3053,520 +2443,380 @@ should be left unobfuscated. Additionally it can be used to produce patches for obfuscated applications that have already been deployed.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.5 and later - -
    - URL: - - + - http://www.yworks.com/products/yguard - -
    - Contact: - - + - yGuard@yWorks.com - -
    - License: - - + - Library: LGPL, Task: Commercial - -
    -
    -
    -
    -
    +
    Compiler Implementations
    - - - +
    +
    - - Compiler Implementations - -
    -
    - - - -
    - - miniRMI <rmic> implementation - -
    -
    +
    + + + +
    + + miniRMI <rmic> implementation + +

    miniRMI is a freeware opensource library that serves as a lightweight replacement for the original java.rmi packages and is suitable especially for applets. Ant 1.4+ <rmic> adapter included.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.4 and later - -
    - URL: - - + - http://dione.zcu.cz/~toman40/miniRMI/ - -
    - Contact: - - + - Petr Toman - -
    - License: - - + - Gnu Lesser Public License - -
    -
    -
    -
    -
    +
    IDE and Editor Integration
    - - - -
    - - IDE and Editor Integration - -
    -
    - - - -
    - - AntFarm - -
    -
    +
    + + + +
    + + AntFarm + +

    A plugin that integrates Ant into the jEdit editor.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - bundles Ant 1.3 - -
    - URL: - - + - http://plugins.jedit.org/plugins/AntFarm - -
    - Contact: - - + - jEdit developers mailinglist - -
    - License: - - + - Apache Software License - -
    -
    -
    - - - -
    - - AntMan - -
    -
    +
    + + + +
    + + AntMan + +

    An AddIn that integrates Ant with the JDeveloper IDE

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.4.1 - -
    - URL: - - + - http://www.erudra.com/antman/index.html - -
    - Contact: - - + - Ashok Sridhar - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - AntRunner - -
    -
    +
    + + + +
    + + AntRunner + +

    An OpenTool that integrates Ant into the JBuilder IDE.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.2 and 1.3 - -
    - URL: - - + - http://www.dieter-bogdoll.de/java/AntRunner/ - -
    - Contact: - - + - Dieter Bogdoll - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - AntWork - -
    -
    +
    + + + +
    + + AntWork + +

    A plugin that integrates Ant into the Jext editor.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.2 and 1.3 - -
    - URL: - - + - ftp://jext.sourceforge.net/pub/jext/plugins/AntWork.zip - -
    - Contact: - - + - Klaus Hartlage - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - Eclipse - -
    -
    +
    + + + +
    + + Eclipse + +

    Eclipse is a universal tool platform with Ant integration.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.3 - 1.4.1 - -
    - URL: - - + - http://www.eclipse.org - -
    - Contact: - - + - news://news.eclipse.org/eclipse.tools - -
    - License: - - + - Common Public License Version 1.0 - -
    -
    -
    - - - -
    - - HP RadPak - -
    -
    +
    + + + +
    + + HP RadPak + +

    RadPak comes with the (free) HP Bluestone HPAS J2EE server, and is primarily a GUI tool for packaging and deploying java web and EJB applications @@ -3575,411 +2825,317 @@ of task attributes, and an animated display of task execution.

    - +
    - - + - - + - - +
    - Compatibility: - - + - bundles Ant 1.3 and docs; adds a jar of extra tasks to any existing ant installation under ANT_HOME - -
    - URL: - - + - http://www.bluestone.com/products/hp-as/ - -
    - License: - - + - Proprietary but free to download - -
    -
    -
    - - - -
    - - IntelliJ IDEA 2.0 - -
    -
    +
    + + + +
    + + IntelliJ IDEA 2.0 + +

    Java IDE with refactoring support and Ant integration.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - bundles Ant 1.3 - -
    - URL: - - + - http://www.intellij.com/idea/ - -
    - Contact: - - + - support@intellij.com - -
    - License: - - + - Commercial - -
    -
    -
    - - - -
    - - JDE(E) 2.2.8 - -
    -
    +
    + + + +
    + + JDE(E) 2.2.8 + +

    The Java Development Environment for Emacs (JDEE) supports Apache Ant as one of three built-in ways to build your applications.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.2 and later - -
    - URL: - - + - http://jde.sunsite.dk/ - -
    - Contact: - - + - JDEE Mailing list. - -
    - License: - - + - GNU General Public License - -
    -
    -
    - - - -
    - - NetBeans / Sun ONE Studio - -
    -
    +
    + + + +
    + + NetBeans / Sun ONE Studio + +

    A module that integrates Ant into the NetBeans or Sun ONE Studio (formerly Forte for Java) IDEs.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - bundles Ant 1.5.1 - -
    - URL: - - + - http://ant.netbeans.org/ - -
    - Contact: - - + - nbdev@netbeans.org - -
    - License: - - + - Sun Public License - -
    -
    -
    - - - -
    - - Oracle9i JDeveloper - -
    -
    +
    + + + +
    + + Oracle9i JDeveloper + +

    Java IDE with support for Ant.

    - +
    - - + - - + - - + - - +
    - Compatibility: - - + - Ant 1.5.1 - -
    - URL: - - + - http://otn.oracle.com/products/jdev/ - -
    - Contact: - - + - jdeveloperbeta_us@oracle.com - -
    - License: - - + - Commercial - -
    -
    -
    - - - -
    - - WebSphere Studio Application Developer - -
    -
    +
    + + + +
    + + WebSphere Studio Application Developer + +

    WSAD features Ant integrate by virtue of being built on the Eclipse tools platform.

    - +
    - - + - - + - - +
    - Compatibility: - - + - bundles Ant 1.4.1 - -
    - Article: - - + - Ant Integration Part1 - -
    - License: - - + - Commercial - -
    -
    -
    -
    -
    -
    +
    + + + + + + - - - -
    -
    -
    -
    - Copyright © 2000-2003, Apache Software Foundation -
    -
    - + + + + + diff --git a/docs/faq.html b/docs/faq.html index cf986b772..b659285cf 100644 --- a/docs/faq.html +++ b/docs/faq.html @@ -1,651 +1,676 @@ - - - - - + + - - - + + Apache Ant - Frequently Asked Questions + + - - - Apache Ant - Frequently Asked Questions - - - - - + + + +
    - - - + + + + +
    - The Apache Jakarta Project - - Apache Ant -
    - - - + +
    -
    -
    - - - + +
    -

    Apache Ant

    - -

    Download

    - -

    Jakarta

    - -

    Get Involved

    - -
    - - - + + + + +
    - - Questions - -
    -
    - - - + + + + + + + +
    - - About this FAQ - -
    -
    +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    + + + -
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + -
    +   + +   +
    +
    + + + + +
    +

    Frequently Asked Questions

    +
    + + + +
    + + Questions + +
    +
    + + +
    + + About this FAQ + +
    - -
    - - - -
    - - General - -
    -
    + + +
    + + +
    + + General + +
    -
    -
    - - - -
    - - Installation - -
    -
    + + +
    + + +
    + + Installation + +
    -
    -
    - - - -
    - - How do I ... - -
    -
    + + +
    + + +
    + + How do I ... + +
    -
    -
    - - - -
    - - It doesn't work (as expected) - -
    -
    + + +
    + + +
    + + It doesn't work (as expected) + +
    -
    -
    - - - -
    - - Ant and IDEs/Editors - -
    -
    + + +
    + + +
    + + Ant and IDEs/Editors + +
    -
    -
    - - - -
    - - Advanced Issues - -
    -
    + + +
    + + +
    + + Advanced Issues + +
    -
    -
    - - - -
    - - Known Problems - -
    -
    + + +
    + + +
    + + Known Problems + +
    -
    -
    - -
    - - - - -
    - - Answers - -
    -
    -   - - -
    - - - Where do I find the latest version of this + + + + + +
    + + Answers + +
    +
    + + + - -
    + + + Where do I find the latest version of this document? - - -
    -
    -

    The latest version can always be found at Ant's homepage - http://jakarta.apache.org/ant/faq.html.

    -
    -
    -   - - - +
    - - - How can I contribute to this FAQ? - - -
    -
    -

    The page you are looking it is generated from + + +

    +

    The latest version can always be found at Ant's homepage + http://ant.apache.org/faq.html.

    +
    + + + +
    + + + How can I contribute to this FAQ? + + +
    +

    The page you are looking it is generated from this document. If you want to add a new question, please submit a patch against this document to one of Ant's mailing lists; hopefully, the structure is self-explanatory.

    -

    If you don't know how to create a patch, see the patches +

    If you don't know how to create a patch, see the patches section of this page.

    - -
    -   - - -
    - - - How do you create the HTML version of this +
    + + + - +
    + + + How do you create the HTML version of this FAQ? - - -
    -
    -

    We use + + +

    +

    We use Anakia to render the HTML version from the original XML file.

    -

    The Velocity stylesheets used to process the XML files can +

    The Velocity stylesheets used to process the XML files can be found in the xdocs/stylesheets subdirectory of Ant's CVS repository - the build file docs.xml at the top level of the jakarta-ant CVS module is used to drive Anakia.

    -

    This file assumes that you have the +

    This file assumes that you have the jakarta-site2 CVS module checked out as well, but if you follow the instruction from Anakia's homepage, you should get it to work without that. Just make sure all required jars are in the task's classpath.

    - -
    -   - - - -
    - - - What is Apache Ant? - - -
    -
    -

    Ant is a Java-based build tool. In theory, it is kind of +
    + + + +
    + + + What is Apache Ant? + + +
    +

    Ant is a Java-based build tool. In theory, it is kind of like Make, without Make's wrinkles and with the full portability of pure Java code.

    -
    -
    -   - - - -
    - - - Why do you call it Ant? - - -
    -
    -

    According to Ant's original author, James Duncan +
    + + + +
    + + + Why do you call it Ant? + + +
    +

    According to Ant's original author, James Duncan Davidson, the name is an acronym for "Another Neat Tool".

    -

    Later explanations go along the lines of "ants +

    Later explanations go along the lines of "ants do an extremely good job at building things", or "ants are very small and can carry a weight dozens of times their own" - describing what Ant is intended to be.

    -
    -
    -   - - - -
    - - - Tell us a little bit about Ant's history. - - -
    -
    -

    Initially, Ant was part of the Tomcat code base, when it was +
    + + + +
    + + + Tell us a little bit about Ant's history. + + +
    +

    Initially, Ant was part of the Tomcat code base, when it was donated to the Apache Software Foundation. It was created by James Duncan Davidson, who is also the original author of Tomcat. Ant was there to build Tomcat, nothing else.

    -

    Soon thereafter, several open source Java projects realized +

    Soon thereafter, several open source Java projects realized that Ant could solve the problems they had with Makefiles. Starting with the projects hosted at Jakarta and the old Java Apache project, Ant spread like a virus and is now the build tool of choice for a lot of projects.

    -

    In January 2000, Ant was moved to a separate CVS module and +

    In January 2000, Ant was moved to a separate CVS module and was promoted to a project of its own, independent of Tomcat, and became Apache Ant.

    -

    The first version of Ant that was exposed to a larger audience +

    The first version of Ant that was exposed to a larger audience was the one that shipped with Tomcat's 3.1 release on 19 April 2000. This version has later been referred to as Ant 0.3.1.

    -

    The first official release of Ant as a stand-alone product was +

    The first official release of Ant as a stand-alone product was Ant 1.1, released on 19 July 2000. The complete release history:

    - +
    - - - - + - - + - - + - - + - - + - - + - - +
    - Ant Version - - + - Release Date - - +
    - 1.1 - - + - 19 July 2000 - -
    - 1.2 - - + - 24 October 2000 - -
    - 1.3 - - + - 3 March 2001 - -
    - 1.4 - - + - 3 September 2001 - -
    - 1.4.1 - - + - 11 October 2001 - -
    - 1.5 - - + - 10 July 2002 - -
    - 1.5.1 - - + - 3 October 2002 - -
    -
    -
    -   - - -
    - - - I get checksum errors when I try to extract the +
    + + + - +
    + + + I get checksum errors when I try to extract the tar.gz distribution file. Why? - - -
    -
    -

    Ant's distribution contains file names that are longer + + +

    +

    Ant's distribution contains file names that are longer than 100 characters, which is not supported by the standard tar file format. Several different implementations of tar use different and incompatible ways to work around this restriction.

    -

    Ant's <tar> task can create tar archives that use +

    Ant's <tar> task can create tar archives that use the GNU tar extension, and this has been used when putting together the distribution. If you are using a different version of tar (for example, the one shipping with Solaris), you cannot use it to extract the archive.

    -

    The solution is to either install GNU tar, which can be +

    The solution is to either install GNU tar, which can be found here, or use the zip archive instead (you can extract it using jar xf).

    - -
    -   - - -
    - - - How do I add an external task that I've written to the +
    + + + - +
    + + + How do I add an external task that I've written to the page "External Tools and Task"? - - -
    -
    -

    Join and post a message to the ant-dev or ant-user mailing + + +

    +

    Join and post a message to the ant-dev or ant-user mailing list (one list is enough), including the following information:

    -
      +
      • the name of the task/tool
      • a short description of the task/tool
      • a Compatibility: entry stating with which version(s) of @@ -660,306 +685,189 @@
      • a License: entry containing the type of license for the tool/task
      -

      The preferred format for this information is a patch to this +

      The preferred format for this information is a patch to this document.

      - -
    -   - - -
    - - - How do I pass parameters from the command line to my +
    + + + - +
    + + + How do I pass parameters from the command line to my build file? - - -
    -
    -

    Use properties. Using ant + + +

    +

    Use properties. Using ant -Dname=value lets you define values for properties on the Ant command line. These properties can then be used within your build file as any normal property: ${name} will put in value.

    - -
    -   - - -
    - - - How can I use Jikes-specific command-line +
    + + + - +
    + + + How can I use Jikes-specific command-line switches? - - -
    -
    -

    A couple of switches are supported via "magic" + + +

    +

    A couple of switches are supported via "magic" properties:

    - +
    - - - - - + - - - + - - - + - - - +
    - switch - - + - property - - - + - default - - +
    - +E - - + - build.compiler.emacs - - + - false == not set - -
    - +P - - + - build.compiler.pedantic - - + - false == not set - -
    - +F - - + - build.compiler.fulldepend - - + - false == not set - -
    - (Only for Ant < 1.4; replaced by the nowarn attribute of the <javac> task after that.)
    -nowarn -
    -
    + - build.compiler.warnings - - + - true == not set - -
    -

    With Ant >= 1.5, you can also use nested +

    With Ant >= 1.5, you can also use nested <compilerarg> elements with the <javac> task.

    - -
    -   - - - -
    - - - How do I include a < character in my command-line arguments? - - -
    -
    -

    The short answer is "Use: &lt;".

    -

    The long answer is that this probably won't do what you +
    + + + +
    + + + How do I include a < character in my command-line arguments? + + +
    +

    The short answer is "Use: &lt;".

    +

    The long answer is that this probably won't do what you want anyway (see the next section).

    -
    -
    -   - - -
    - - - How do I redirect standard input or standard output +
    + + + - +
    + + + How do I redirect standard input or standard output in the <exec> task? - - -
    -
    -

    Say you want to redirect the standard input stream of the + + +

    +

    Say you want to redirect the standard input stream of the cat command to read from a file, something like:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     shell-prompt> cat < foo
    -
    -
    -

    and try to translate it into

    -
    - - - - - - - - - - - - - - - - -
    +
    +

    and try to translate it into

    +
     <exec executable="cat">
       <arg value="&lt;" />
       <arg value="foo" />
     </exec>
    -
    -
    -

    This will not do what you expect. The input redirection is + +

    This will not do what you expect. The input redirection is performed by your shell, not the command itself, so this should read:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <exec executable="/bin/sh">
       <arg value="-c" />
       <arg value="cat &lt; foo" />
     </exec>
    -
    -
    -

    Note that you must use the value attribute of + +

    Note that you must use the value attribute of <arg> in the last element, in order to have the command passed as a single, quoted argument. Alternatively, you can use:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <exec executable="/bin/sh">
       <arg line='-c "cat &lt; foo"'/>
     </exec>
    -
    -
    -

    Note the double-quotes nested inside the single-quotes.

    - -
    -   - - - -
    - - - How do I execute a batch file or shell script from Ant? - - -
    -
    -

    On native Unix systems, you should be able to run shell scripts + +

    Note the double-quotes nested inside the single-quotes.

    +
    + + + +
    + + + How do I execute a batch file or shell script from Ant? + + +
    +

    On native Unix systems, you should be able to run shell scripts directly. On systems running a Unix-type shell (for example, Cygwin on Windows) execute the (command) shell instead - cmd for batch files, sh for shell scripts - then pass the @@ -969,68 +877,38 @@ shell-prompt> cat < foo the above section for example <exec> tasks executing sh. For batch files, use something like:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <exec dir="." executable="cmd" os="Windows NT">
       <arg line="/c test.bat"/>
     </exec>
    -
    -
    -
    -
    -   - - -
    - - - I want to execute a particular target only if + +
    + + + - +
    + + + I want to execute a particular target only if multiple conditions are true. - - -
    -
    -

    There are actually several answers to this question.

    -

    If you have only one set and one unset property to test, + + +

    +

    There are actually several answers to this question.

    +

    If you have only one set and one unset property to test, you can specify both an if and an unless attribute for the target, and they will act as if they are "anded" together.

    -

    If you are using a version of Ant 1.3 or earlier, the +

    If you are using a version of Ant 1.3 or earlier, the way to work with all other cases is to chain targets together to determine the specific state you want to test for.

    -

    To see how this works, assume you have three properties: +

    To see how this works, assume you have three properties: prop1, prop2, and prop3. You want to test that prop1 and prop2 are set, and that prop3 is not. If the condition holds true you want to echo "yes".

    -

    Here is the implementation in Ant 1.3 and earlier:

    -
    - - - - - - - - - - - - - - - - -
    +                        

    Here is the implementation in Ant 1.3 and earlier:

    +
     <target name="cond" depends="cond-if"/>
     
     <target name="cond-if" if="prop1">
    @@ -1044,35 +922,17 @@ shell-prompt> cat < foo
     <target name="cond-if-3" unless="prop3">
       <echo message="yes"/>
     </target>
    -
    -
    -

    Note: <antcall> tasks do not pass + +

    Note: <antcall> tasks do not pass property changes back up to the environment they were called from, so you would'nt be able to, for example, set a result property in the cond-if-3 target, then do <echo message="result is ${result}"/> in the cond target.

    -

    Starting with Ant 1.4, you can use the +

    Starting with Ant 1.4, you can use the <condition> task.

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <target name="cond" depends="cond-if,cond-else"/>
     
     <target name="check-cond">
    @@ -1096,18 +956,9 @@ shell-prompt> cat < foo
     <target name="cond-else" depends="check-cond" unless="cond-is-true">
       <echo message="no"/>
     </target>
    -
    -
    -

    This version takes advantage of two things:

    -
      + +

      This version takes advantage of two things:

      +
      • If a property a has not been set, ${a} will evaluate to ${a}.
      • @@ -1115,22 +966,13 @@ shell-prompt> cat < foo escape it with another $ - this will also break the special treatment of the ${ sequence.
      -

      Because testing for a literal ${property} string +

      Because testing for a literal ${property} string isn't all that readable or easy to understand, post-1.4.1 Ant introduces the <isset> element to the <condition> task.

      -

      Here is the previous example done using +

      Here is the previous example done using <isset>:

      -
      - - - - - - - - - - - - - - - - -
      +                        
       <target name="check-cond">
         <condition property="cond-is-true">
           <and>
      @@ -1142,17 +984,8 @@ shell-prompt> cat < foo
           </and>
         </condition>
       </target>
      -
      -
      -

      The last option is to use a scripting language to set the + +

      The last option is to use a scripting language to set the properties. This can be particularly handy when you need much finer control than the simple conditions shown here but, of course, comes with the overhead of adding JAR files to support @@ -1161,65 +994,41 @@ shell-prompt> cat < foo <script> task documentation for more details.

      - -
    -   - - -
    - - - How can I include national characters like German +
    + + + - +
    + + + How can I include national characters like German umlauts in my build file? - - -
    -
    -

    You need to tell the XML parser which character encoding + + +

    +

    You need to tell the XML parser which character encoding your build file uses, this is done inside the XML declaration.

    -

    By default the parser assumes you are using the UTF-8 +

    By default the parser assumes you are using the UTF-8 encoding instead of your platform's default. For most Western European countries you should set the encoding to ISO-8859-1. To do so, make the very first line of you build file read like

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <?xml version="1.0" encoding="ISO-8859-1" ?>
    -
    -
    - -
    -   - - - -
    - - - Why does Ant always recompile all my Java files? - - -
    -
    -

    In order to find out which files should be compiled, Ant + +
    + + + +
    + + + Why does Ant always recompile all my Java files? + + +
    +

    In order to find out which files should be compiled, Ant compares the timestamps of the source files to those of the resulting .class files. Opening all source files to find out which package they belong to would be very @@ -1227,148 +1036,103 @@ shell-prompt> cat < foo source files in a directory hierarchy that mirrors your package hierarchy and to point Ant to the root of this directory tree with the srcdir attribute.

    -

    Say you have <javac srcdir="src" +

    Say you have <javac srcdir="src" destdir="dest"/>. If Ant finds a file src/a/b/C.java, it expects it to be in package a.b so that the resulting .class file is going to be dest/a/b/C.class.

    -

    If your source-tree directory structure does not match your +

    If your source-tree directory structure does not match your package structure, Ant's heuristic won't work, and it will recompile classes that are up-to-date. Ant is not the only tool that expects a source-tree layout like this.

    -

    If you have Java source files that aren't declared to +

    If you have Java source files that aren't declared to be part of any package, you can still use the <javac> task to compile these files correctly - just set the srcdir and destdir attributes to the actual directory the source files live in and the directory the class files should go into, respectively.

    -
    -
    -   - - -
    - - - I've used a <delete> task to +
    + + + - +
    + + + I've used a <delete> task to delete unwanted SourceSafe control files (CVS files, editor backup files, etc.), but it doesn't seem to work; the files never get deleted. What's wrong? - - -
    -
    -

    This is probably happening because, by default, Ant excludes + + +

    +

    This is probably happening because, by default, Ant excludes SourceSafe control files (vssver.scc) and certain other files from FileSets.

    -

    Here's what you probably did:

    -
    - - - - - - - - - - - - - - - - -
    +                        

    Here's what you probably did:

    +
     <delete>
       <fileset dir="${build.src}" includes="**/vssver.scc"/>
     </delete>
    -
    -
    -

    You need to switch off the default exclusions, + +

    You need to switch off the default exclusions, and it will work:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <delete>
       <fileset dir="${build.src}" includes="**/vssver.scc"
                defaultexcludes="no"/>
     </delete>
    -
    -
    -

    For a complete listing of the patterns that are excluded + +

    For a complete listing of the patterns that are excluded by default, see the user manual.

    - -
    -   - - -
    - - - I have a target I want to skip if a property is set, +
    + + + - +
    + + + I have a target I want to skip if a property is set, so I have unless="property" as an attribute of the target, but all the targets this target depends on are still executed. Why? - - -
    -
    -

    The list of dependencies is generated by Ant before any of the + + +

    +

    The list of dependencies is generated by Ant before any of the targets are run. This allows dependent targets, such as an init target, to set properties that can control the execution of the targets higher in the dependency graph. This is a good thing.

    -

    However, when your dependencies break down the +

    However, when your dependencies break down the higher-level task into several smaller steps, this behaviour becomes counter-intuitive. There are a couple of solutions available:

    -
      +
      1. Put the same condition on each of the dependent targets.
      2. Execute the steps using <antcall>, instead of specifying them inside the depends attribute.
      - -
    -   - - -
    - - - In my <fileset>, I've put in an +
    + + + - +
    + + + In my <fileset>, I've put in an <exclude> of all files followed by an <include> of just the files I want, but it isn't giving me any files at all. What's wrong? - - -
    -
    -

    The order of the <include> and + + +

    +

    The order of the <include> and <exclude> tags within a <fileset> is ignored when the FileSet is created. Instead, all of the <include> elements are processed together, @@ -1376,136 +1140,97 @@ shell-prompt> cat < foo elements. This means that the <exclude> elements only apply to the file list produced by the <include> elements.

    -

    To get the files you want, focus on just the +

    To get the files you want, focus on just the <include> patterns that would be necessary to get them. If you find you need to trim the list that the <include> elements produce, then use <exclude> elements.

    - -
    -   - - -
    - - - ant failed to build my program via javac +
    + + + - +
    + + + ant failed to build my program via javac even when I put the needed jars in an external build.properties file and reference them by pathelement or classpath refid. - - -
    -
    -

    When ant loads properties from an external + + +

    +

    When ant loads properties from an external file it dosn't touch the value of properties, trailing blanks will not be trimmed for example.

    -

    If the value represents a file path, like a jar needed to +

    If the value represents a file path, like a jar needed to compile, the task which requires the value, javac for example would fail to compile since it can't find the file due to trailing spaces.

    - -
    -   - - -
    - - - Ant creates WAR files with a lower-case +
    + + + - +
    + + + Ant creates WAR files with a lower-case web-inf or JAR files with a lower-case meta-inf directory. - - -
    -
    -

    No it doesn't.

    -

    You may have seen these lower-case directory names in + + +

    +

    No it doesn't.

    +

    You may have seen these lower-case directory names in WinZIP, but WinZIP is trying to be helpful (and fails). If WinZIP encounters a filename that is all upper-case, it assumes it has come from an old DOS box andchanges the case to all lower-case for you.

    -

    If you extract (or just check) the archive with jar, you +

    If you extract (or just check) the archive with jar, you will see that the names have the correct case.

    - -
    -   - - - -
    - - - Is Ant supported by my IDE/Editor? - - -
    -
    -

    See the section +
    +
    + + +
    + + + Is Ant supported by my IDE/Editor? + + +
    +

    See the section on IDE integration on our External Tools and Tasks page.

    -
    -
    -   - - -
    - - - Why doesn't (X)Emacs/vi/MacOS X's project builder +
    + + + - +
    + + + Why doesn't (X)Emacs/vi/MacOS X's project builder correctly parse the error messages generated by Ant? - - -
    -
    -

    Ant adds a "banner" with the name of the current + + +

    +

    Ant adds a "banner" with the name of the current task in front of all logging messages - and there are no built-in regular expressions in your editor that would account for this.

    -

    You can disable this banner by invoking Ant with the +

    You can disable this banner by invoking Ant with the -emacs switch. To make Ant autodetect Emacs' compile mode, put this into your .antrc (contributed by Ville Skyttä).

    -
    - - - - - - - - - - - - - - - - -
    +                        
     # Detect (X)Emacs compile mode
     if [ "$EMACS" = "t" ] ; then 
       ANT_ARGS="$ANT_ARGS -emacs" 
       ANT_OPTS="$ANT_OPTS -Dbuild.compiler.emacs=true" 
     fi 
    -
    -
    -

    Alternatively, you can add the following snippet to your + +

    Alternatively, you can add the following snippet to your .emacs to make Emacs understand Ant's output.

    -
    - - - - - - - - - - - - - - - - -
    +                        
     (require 'compile)
     (setq compilation-error-regexp-alist
       (append (list 
    @@ -1514,29 +1239,11 @@ fi
          ;; works for javac 
          '("^\\s-*\\[[^]]*\\]\\s-*\\(.+\\):\\([0-9]+\\):" 1 2))
       compilation-error-regexp-alist))
    -
    -
    -

    Yet another alternative that preserves most of Ant's + +

    Yet another alternative that preserves most of Ant's formatting is to pipe Ant's output through the following Perl script by Dirk-Willem van Gulik:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     #!/usr/bin/perl
     #
     # May 2001 dirkx@apache.org - remove any
    @@ -1556,35 +1263,23 @@ while(<STDIN>) {
     	};
     	print;
     };
    -
    -
    - -
    -   - - -
    - - - Is there a DTD that I can use to validate my build + +
    + + + - +
    + + + Is there a DTD that I can use to validate my build files? - - -
    -
    -

    An incomplete DTD can be created by the + + +

    +

    An incomplete DTD can be created by the <antstructure> task - but this one has a few problems:

    -
      +
      • It doesn't know about required attributes. Only manual tweaking of this file can help here.
      • @@ -1605,32 +1300,20 @@ while(<STDIN>) { lists. This problem cannot be solved; DTDs don't give a syntax rich enough to support this.
      - -
    -   - - - -
    - - - How do I include an XML snippet in my build file? - - -
    -
    -

    You can use XML's way of including external files and let +
    + + + +
    + + + How do I include an XML snippet in my build file? + + +
    +

    You can use XML's way of including external files and let the parser do the job for Ant:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     <?xml version="1.0"?>
     
     <!DOCTYPE project [
    @@ -1648,99 +1331,42 @@ while(<STDIN>) {
       ...
     
     </project>
    -
    -
    -

    will literally include the contents of common.xml where + +

    will literally include the contents of common.xml where you've placed the &common; entity.

    -

    In combination with a DTD, this would look like this:

    -
    - - - - - - - - - - - - - - - - -
    +                        

    In combination with a DTD, this would look like this:

    +
     <!DOCTYPE project PUBLIC "-//ANT//DTD project//EN" "file:./ant.dtd" [
        <!ENTITY include SYSTEM "file:./header.xml">
     ]>
    -
    -
    -
    -
    -   - - -
    - - - How do I send an email with the result of my build + +
    + + + - +
    + + + How do I send an email with the result of my build process? - - -
    -
    -

    If you are using a nightly build of Ant 1.5 after + + +

    +

    If you are using a nightly build of Ant 1.5 after 2001-12-14, you can use the built-in MailLogger:

    -
    - - - - - - - - - - - - - - - - -
    +                        
              ant -logger org.apache.tools.ant.listener.MailLogger
    -
    -
    -

    See the Listeners + +

    See the Listeners & Loggers documentation for details on the properties required.

    -

    For older versions of Ant, you can use a custom +

    For older versions of Ant, you can use a custom BuildListener that sends out an email in the buildFinished() method. Will Glozer <will.glozer@jda.com> has written such a listener based on JavaMail. The source is:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     import java.io.*;
     import java.util.*;
     import javax.mail.*;
    @@ -1850,27 +1476,9 @@ public class BuildMonitor implements BuildListener {
         public void taskFinished(BuildEvent e) {
         }
     }
    -
    -
    -

    With a monitor.properties like this:

    -
    - - - - - - - - - - - - - - - - -
    +
    +

    With a monitor.properties like this:

    +
     # configuration for build monitor
     
     mail.transport.protocol=smtp
    @@ -1886,197 +1494,122 @@ build.failed.email.subject=Nightly build failed!
     build.succeeded.notify=true
     build.succeeded.email.to=will.glozer@jda.com
     build.succeeded.email.subject=Nightly build succeeded!
    -
    -
    -

    monitor.properties should be placed right next + +

    monitor.properties should be placed right next to your compiled BuildMonitor.class. To use it, invoke Ant like:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     ant -listener BuildMonitor -logfile build.log
    -
    -
    -

    Make sure that mail.jar from JavaMail and + +

    Make sure that mail.jar from JavaMail and activation.jar from the Java Beans Activation Framework are in your CLASSPATH.

    - -
    -   - - -
    - - - How do I get at the properties that Ant was running +
    + + + - +
    + + + How do I get at the properties that Ant was running with from inside BuildListener? - - -
    -
    -

    You can get at a hashtable with all the properties that Ant + + +

    +

    You can get at a hashtable with all the properties that Ant has been using through the BuildEvent parameter. For example:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     public void buildFinished(BuildEvent e) {
         Hashtable table = e.getProject().getProperties();
         String buildpath = (String)table.get("build.path");
         ...
     }
    -
    -
    -

    This is more accurate than just reading the same property + +

    This is more accurate than just reading the same property files that your project does, since it will give the correct results for properties that were specified on the Ant command line.

    - -
    -   - - -
    - - - <chmod> or <exec> doesn't work in Ant +
    + + + - +
    + + + <chmod> or <exec> doesn't work in Ant 1.3 on Unix - - -
    -
    -

    The antRun script in ANT_HOME/bin + + +

    +

    The antRun script in ANT_HOME/bin has DOS instead of Unix line endings; you must remove the carriage-return characters from this file. This can be done by using Ant's <fixcrlf> task or something like:

    -
    - - - - - - - - - - - - - - - - -
    +                        
     tr -d '\r' < $ANT_HOME/bin/antRun > /tmp/foo
     mv /tmp/foo $ANT_HOME/bin/antRun
    -
    -
    - -
    -   - - - -
    - - - JavaDoc failed: java.io.IOException: javadoc: cannot execute - - -
    -
    -

    There is a bug in the Solaris reference implementation of + +
    + + + +
    + + + JavaDoc failed: java.io.IOException: javadoc: cannot execute + + +
    +

    There is a bug in the Solaris reference implementation of the JDK (see http://developer.java.sun.com/developer/bugParade/bugs/4230399.html). This also appears to be true under Linux. Moving the JDK to the front of the PATH fixes the problem.

    -
    -
    -   - - -
    - - - <style> or <junit> ignores my +
    + + + - +
    + + + <style> or <junit> ignores my <classpath> - - -
    -
    -

    These tasks don't ignore your classpath setting, you + + +

    +

    These tasks don't ignore your classpath setting, you are facing a common problem with delegating classloaders.

    -

    First of all let's state that Ant adds all +

    First of all let's state that Ant adds all .jar files from ANT_HOME/lib to CLASSPATH, therefore "in CLASSPATH" shall mean "either in your CLASSPATH environment variable or ANT_HOME/lib" for the rest of this answer.

    -

    This question collects a common type of problem: A task +

    This question collects a common type of problem: A task needs an external library and it has a nested classpath element so that you can point it to this external library, but that doesn't work unless you put the external library into the CLASSPATH.

    -

    The root of the problem is that the class that needs the +

    The root of the problem is that the class that needs the external library is on the CLASSPATH.

    -

    When you specify a nested <classpath> in +

    When you specify a nested <classpath> in Ant, Ant creates a new class loader that uses the path you have specified. It then tries to load additional classes from this classloader.

    -

    In most cases - for example the two cases above - Ant +

    In most cases - for example the two cases above - Ant doesn't load the external library directly, it is the loaded class that does so.

    -

    In the case of <junit> it is the task +

    In the case of <junit> it is the task implementation itself and in the case of <style> it is the implementation of the org.apache.tools.ant.taskdefs.XSLTLiaison class.

    -

    Ant's class loader implementation uses Java's +

    Ant's class loader implementation uses Java's delegation model, see http://java.sun.com/products/jdk/1.2/docs/api/java/lang/ClassLoader.html the paragraph

    -
    The ClassLoader class uses a +
    The ClassLoader class uses a delegation model to search for classes and resources. Each instance of ClassLoader has an associated parent class loader. When called upon to find a class or resource, a @@ -2087,18 +1620,18 @@ mv /tmp/foo $ANT_HOME/bin/antRun class loader, does not itself have a parent but may serve as the parent of a ClassLoader instance.
    -

    This means, Ant's class loader will consult the +

    This means, Ant's class loader will consult the bootstrap class loader first, which tries to load classes from CLASSPATH. The bootstrap class loader doesn't know anything about Ant's class loader or even the path you have specified.

    -

    If the bootstrap class loader can load the class Ant has +

    If the bootstrap class loader can load the class Ant has asked it to load, this class will try to load the external library from CLASSPATH as well - it doesn't know anything else - and will not find it unless the library is in CLASSPATH as well.

    -

    To solve this, you have two major options:

    -
      +

      To solve this, you have two major options:

      +
      1. put all external libraries you need in CLASSPATH as well this is not what you want, otherwise you wouldn't have found this FAQ entry.
      2. @@ -2106,7 +1639,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun
      3. remove the class that loads the external library from the CLASSPATH.
      -

      The easiest way to do this is to remove +

      The easiest way to do this is to remove optional.jar from ANT_HOME/lib. If you do so, you will have to <taskdef> all optional tasks and use nested <classpath> @@ -2117,7 +1650,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun <classpath> of your <style> or <junit> task.

      -

      If you want to avoid to <taskdef> all +

      If you want to avoid to <taskdef> all optional tasks you need, the only other option is to remove the classes that should not be loaded via the bootstrap class loader from optional.jar and put them into a @@ -2126,85 +1659,80 @@ mv /tmp/foo $ANT_HOME/bin/antRun <style> or <junit> task - and make sure the separate archive is not in CLASSPATH.

      -

      In the case of <junit> you'd have +

      In the case of <junit> you'd have to remove all classes that are in the org/apache/tools/ant/taskdefs/optional/junit directory, in the <style> case it is one of the *Liaison classes in org/apache/tools/ant/taskdefs/optional.

      -

      If you use the option to break up optional.jar +

      If you use the option to break up optional.jar for <junit>, you still have to use a <taskdef> with a nested <classpath> to define the junit task.

      -
    -
    -   - - -
    - - - When running Ant 1.4 on Windows XP and JDK 1.4, I get +
    + + + - +
    + + + When running Ant 1.4 on Windows XP and JDK 1.4, I get various errors when trying to <exec>, fork <java> or access environment variables. - - -
    -
    -

    Ant < 1.5 doesn't recognize Windows XP as a flavor + + +

    +

    Ant < 1.5 doesn't recognize Windows XP as a flavor of Windows that runs CMD.EXE instead of COMMAND.COM. JDK 1.3 will tell Ant that Windows XP is Windows 2000 so the problem doesn't show up there.

    -

    Apart from upgrading to Ant 1.5 or better, setting the +

    Apart from upgrading to Ant 1.5 or better, setting the environment variable ANT_OPTS to -Dos.name=Windows_NT prior to invoking Ant has been confirmed as a workaround.

    - -
    -   - - -
    - - - The ant wrapper script of Ant 1.5 fails +
    + + + - +
    + + + The ant wrapper script of Ant 1.5 fails for Cygwin if ANT_HOME is set to a Windows style path. - - -
    -
    -

    This problem has been reported only hours after Ant 1.5 has + + +

    +

    This problem has been reported only hours after Ant 1.5 has been released, see Bug 10664 and all it's duplicates.

    -

    A fixed version of the wrapper script can be found here. +

    A fixed version of the wrapper script can be found here. Simply replace your script with this version.

    - -
    -
    -
    -
    +
    + + + + + + - - - -
    -
    -
    -
    - Copyright © 2000-2003, Apache Software Foundation -
    -
    - + + + diff --git a/docs/guidelines.html b/docs/guidelines.html new file mode 100644 index 000000000..76e57386a --- /dev/null +++ b/docs/guidelines.html @@ -0,0 +1,237 @@ + + + + + + + + Apache Ant - Project Guidelines + + + + + + + + + + + +
    + + + + + + + + + + + +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    + + + + +
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + + +
    +   + +   +
    +
    + + + + +
    +

    Project Guidelines

    +
    +
    + + +
    Project Guidelines
    +

    We are still in the process of defining the guidelines for this + project - to get an idea what they may look like, we want to point + you to the guidelines of the Jakarta + and httpd + projects as well as the work currently on the way at the Incubator project.

    + + +
    +
    +
    + + + + + + + +
    + + + + + + + + + + + diff --git a/docs/images/current.gif b/docs/images/current.gif new file mode 100644 index 000000000..af0f64fb2 Binary files /dev/null and b/docs/images/current.gif differ diff --git a/docs/images/group-logo.gif b/docs/images/group-logo.gif new file mode 100644 index 000000000..de57d342c Binary files /dev/null and b/docs/images/group-logo.gif differ diff --git a/docs/images/jakarta-logo.gif b/docs/images/jakarta-logo.gif deleted file mode 100644 index 049cf8229..000000000 Binary files a/docs/images/jakarta-logo.gif and /dev/null differ diff --git a/docs/images/label.gif b/docs/images/label.gif new file mode 100644 index 000000000..bc4cb5897 Binary files /dev/null and b/docs/images/label.gif differ diff --git a/docs/images/menu-left.gif b/docs/images/menu-left.gif new file mode 100644 index 000000000..0ca90471e Binary files /dev/null and b/docs/images/menu-left.gif differ diff --git a/docs/images/menu-right.gif b/docs/images/menu-right.gif new file mode 100644 index 000000000..879c02806 Binary files /dev/null and b/docs/images/menu-right.gif differ diff --git a/docs/images/page.gif b/docs/images/page.gif new file mode 100644 index 000000000..b0b394491 Binary files /dev/null and b/docs/images/page.gif differ diff --git a/docs/images/printer.gif b/docs/images/printer.gif new file mode 100644 index 000000000..5021187b0 Binary files /dev/null and b/docs/images/printer.gif differ diff --git a/docs/images/project-logo.gif b/docs/images/project-logo.gif new file mode 100644 index 000000000..5d9cd7f3a Binary files /dev/null and b/docs/images/project-logo.gif differ diff --git a/docs/images/search-left.gif b/docs/images/search-left.gif new file mode 100644 index 000000000..cb204461f Binary files /dev/null and b/docs/images/search-left.gif differ diff --git a/docs/images/search-right.gif b/docs/images/search-right.gif new file mode 100644 index 000000000..100557317 Binary files /dev/null and b/docs/images/search-right.gif differ diff --git a/docs/images/spacer.gif b/docs/images/spacer.gif new file mode 100644 index 000000000..35d42e808 Binary files /dev/null and b/docs/images/spacer.gif differ diff --git a/docs/images/tab-left.gif b/docs/images/tab-left.gif new file mode 100644 index 000000000..1bfd75440 Binary files /dev/null and b/docs/images/tab-left.gif differ diff --git a/docs/images/tab-right.gif b/docs/images/tab-right.gif new file mode 100644 index 000000000..6803a8561 Binary files /dev/null and b/docs/images/tab-right.gif differ diff --git a/docs/images/tabSel-left.gif b/docs/images/tabSel-left.gif new file mode 100644 index 000000000..46abc4dd4 Binary files /dev/null and b/docs/images/tabSel-left.gif differ diff --git a/docs/images/tabSel-right.gif b/docs/images/tabSel-right.gif new file mode 100644 index 000000000..881f74c1d Binary files /dev/null and b/docs/images/tabSel-right.gif differ diff --git a/docs/index.html b/docs/index.html index 25f1bf659..081bafc49 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,121 +1,216 @@ - - - - - + + - - - + + Apache Ant - Welcome + + - + - - - Apache Ant - Ant - - - - - + + + +
    + + + + + + +
    + + + + + + + + - - - + +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    - The Apache Jakarta Project - - Apache Ant -
    - - - +
    -
    -
    + + + +
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + + + + + + +
    +   + +   +
    +
    + - - - + download as binary or as source distribution.

    +
    +
    -

    Apache Ant

    - -

    Download

    - -

    Jakarta

    - -

    Get Involved

    - -
    - - - + +
    - - Ant 1.5.1 - -
    -
    +
    +

    Welcome

    +
    +
    + + +
    Ant 1.5.1

    Apache Ant 1.5.1 Released!

    Version 1.5.1 of Ant has been released. It is available for - download as binary or as source distribution.

    - -
    +
    Apache Ant
    - - - +
    +
    - - Apache Ant - -
    -

    Apache Ant is a Java-based build tool. In theory, it is kind of like Make, but without Make's wrinkles. @@ -155,17 +250,10 @@ And hey, if you really need to execute a shell command, Ant has an allows different commands to be executed based on the OS that it is executing on.

    -
    -
    +
    Documentation
    - - - +
    +
    - - Documentation - -
    -

    You can view the documentation for the current release (Apache Ant 1.5.1) online @@ -173,74 +261,60 @@ You can view the documentation for the current release (Apache Ant 1.5.1)

    Comprehensive documentation is included in the source and binary distributions.

    -
    -
    +
    Nightly Builds
    - - - +
    +
    - - Nightly Builds - -
    -

    If you wish to use the latest Ant features, you can try downloading a nightly build from here

    -
    -
    +
    Towards Ant2
    - - - +
    +
    - - Towards Ant2 - -
    -

    We are currently hashing out design details for Ant2. Please read the latest Ant news for more details.

    -
    -
    +
    Get Involved
    - - - -
    - - Get Involved - -
    -
    -
    -
    -
    +
    + + + + + + - - - -
    -
    -
    -
    - Copyright © 2000-2003, Apache Software Foundation -
    -
    - + + + + + diff --git a/docs/legal.html b/docs/legal.html new file mode 100644 index 000000000..3a33d4523 --- /dev/null +++ b/docs/legal.html @@ -0,0 +1,245 @@ + + + + + + + + Apache Ant - Legal + + + + + + + + + + + + + +
    + + + + + + + + + + + +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    + + + + +
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + + +
    +   + +   +
    +
    + + + + +
    +

    Legal

    +
    +
    + + +
    Legal Stuff They Make Us Say
    +

    All material on this website is Copyright © 1999-2002, + The Apache Software Foundation.

    +

    Sun, Sun Microsystems, Solaris, Java, JavaServer Web + Development Kit, and JavaServer Pages are trademarks or + registered trademarks of Sun Microsystems, Inc. UNIX is a + registered trademark in the United States and other countries, + exclusively licensed through X/Open Company, Ltd. Windows, + WindowsNT, and Win32 are registered trademarks of Microsoft + Corp. All other product names mentioned herein and throughout + the entire web site are trademarks of their respective + owners.

    + + +
    +
    +
    + + + + + + + +
    + + + + + + + + + + + diff --git a/docs/license.html b/docs/license.html new file mode 100644 index 000000000..ca032381f --- /dev/null +++ b/docs/license.html @@ -0,0 +1,283 @@ + + + + + + + + Apache Ant - License + + + + + + + + + + + +
    + + + + + + + + + + + +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    + + + + +
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + + +
    +   + +   +
    +
    + + + + +
    +

    License

    +
    +
    + + +
    The Apache Software License
    +
    /*
    + * ============================================================================
    + *                   The Apache Software License, Version 1.1
    + * ============================================================================
    + * 
    + *    Copyright (C) 2000-2003 The Apache Software Foundation. All
    + *    rights reserved.
    + * 
    + * Redistribution and use in source and binary forms, with or without modifica-
    + * tion, are permitted provided that the following conditions are met:
    + * 
    + * 1. Redistributions of  source code must  retain the above copyright  notice,
    + *    this list of conditions and the following disclaimer.
    + * 
    + * 2. Redistributions in binary form must reproduce the above copyright notice,
    + *    this list of conditions and the following disclaimer in the documentation
    + *    and/or other materials provided with the distribution.
    + * 
    + * 3. The end-user documentation included with the redistribution, if any, must
    + *    include  the following  acknowledgment:  "This product includes  software
    + *    developed  by the  Apache Software Foundation  (http://www.apache.org/)."
    + *    Alternately, this  acknowledgment may  appear in the software itself,  if
    + *    and wherever such third-party acknowledgments normally appear.
    + * 
    + * 4. The names "Ant" and  "Apache Software Foundation"  must not be used to
    + *    endorse  or promote  products derived  from this  software without  prior
    + *    written permission. For written permission, please contact
    + *    apache@apache.org.
    + * 
    + * 5. Products  derived from this software may not  be called "Apache", nor may
    + *    "Apache" appear  in their name,  without prior written permission  of the
    + *    Apache Software Foundation.
    + * 
    + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
    + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
    + * FITNESS  FOR A PARTICULAR  PURPOSE ARE  DISCLAIMED.  IN NO  EVENT SHALL  THE
    + * APACHE SOFTWARE  FOUNDATION  OR ITS CONTRIBUTORS  BE LIABLE FOR  ANY DIRECT,
    + * INDIRECT, INCIDENTAL, SPECIAL,  EXEMPLARY, OR CONSEQUENTIAL  DAMAGES (INCLU-
    + * DING, BUT NOT LIMITED TO, PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS
    + * OF USE, DATA, OR  PROFITS; OR BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON
    + * ANY  THEORY OF LIABILITY,  WHETHER  IN CONTRACT,  STRICT LIABILITY,  OR TORT
    + * (INCLUDING  NEGLIGENCE OR  OTHERWISE) ARISING IN  ANY WAY OUT OF THE  USE OF
    + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    + * 
    + * This software  consists of voluntary contributions made  by many individuals
    + * on behalf of the  Apache Software Foundation.  For more  information  on the 
    + * Apache Software Foundation, please see <http://www.apache.org/>.
    + *
    + */
    +
    +

    You can download the original license file here

    + + +
    +
    +
    + + + + + + + +
    + + + + + + + + + + + diff --git a/docs/mail.html b/docs/mail.html new file mode 100644 index 000000000..596e3394c --- /dev/null +++ b/docs/mail.html @@ -0,0 +1,279 @@ + + + + + + + + Apache Ant - Mailing Lists + + + + + + + + + + + +
    + + + + + + + + + + + +
    Apache Ant siteApache Ant logo +
    + + + + + + + + + + +
    +
    + + the Apache Ant site + + +
    +
    +
    +
    + + + + + +
    + + + + +
    Home
    +
    +
    +
    + + + + +
    + + + + + + + + + + +
    + + + + + + + + + + +
     
    +
    + +
    +
    + + + + + + + + + + + + + +
    +   + +   +
    +
    + + + + +
    +

    Mailing Lists

    +
    +
    + + +
    Mailing Lists
    +

    Please read the guidelines of + the Jakarta Project before subscribing and posting to any of + the lists below. They apply to Ant's lists as well.

    +

    The user and dev list are subscriber only lists, this means + you have to subscribe before you can post to the list. These + lists are archived at

    + +
    + + + +
    + + User List + +
    +

    + Medium Traffic + Subscribe + Unsubscribe + Archive +

    +

    This list is for developers that are using Ant in their own + projects to ask questions, share knowledge, and discuss issues + related to using Ant as a build tool.

    +
    + + + +
    + + Developer List + +
    +

    + High Traffic + Subscribe + Unsubscribe + Archive +

    +

    This is the list where participating developers of the Ant + build tool meet and discuss issues, code changes/additions, + etc. Subscribers to this list get notices of each and every + code change, build results, testing notices, etc.

    + + +
    +
    +
    + + + + + + + +
    + + + + + + + + + + + diff --git a/docs/manual/CoreTasks/cvspass.html b/docs/manual/CoreTasks/cvspass.html index de5777cfd..b26c1c5b8 100644 --- a/docs/manual/CoreTasks/cvspass.html +++ b/docs/manual/CoreTasks/cvspass.html @@ -34,13 +34,13 @@

    Examples

    -
      <cvspass cvsroot=":pserver:anoncvs@jakarta.apache.org:/home/cvspublic"
    +
      <cvspass cvsroot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic"
            password="anoncvs"
       />

    Adds an entry into the ~/.cvspass password file.


    -

    Copyright © 2001 Apache Software Foundation. All rights +

    Copyright © 2001,2003 Apache Software Foundation. All rights Reserved.

    diff --git a/docs/manual/CoreTasks/get.html b/docs/manual/CoreTasks/get.html index f536e1a70..f51c19526 100644 --- a/docs/manual/CoreTasks/get.html +++ b/docs/manual/CoreTasks/get.html @@ -81,8 +81,8 @@ to set up the proxy first.

    Examples

    -
      <get src="http://jakarta.apache.org/" dest="help/index.html"/>
    -

    Gets the index page of http://jakarta.apache.org/, and stores it in the file help/index.html.

    +
      <get src="http://ant.apache.org/" dest="help/index.html"/>
    +

    Gets the index page of http://ant.apache.org/, and stores it in the file help/index.html.

      <get src="http://jakarta.apache.org/builds/tomcat/nightly/ant.zip" 
         dest="optional.jar" 
    @@ -102,7 +102,7 @@ for progress information.
     Fetches some file from a server with access control. Because https is being used the
     fact that basic auth sends passwords in plaintext is moot.
     
    -

    Copyright © 2000-2002 Apache Software Foundation. All rights +

    Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

    diff --git a/docs/manual/CoreTasks/javac.html b/docs/manual/CoreTasks/javac.html index 7eaa23417..fb62e6d5e 100644 --- a/docs/manual/CoreTasks/javac.html +++ b/docs/manual/CoreTasks/javac.html @@ -481,7 +481,7 @@ to filter for these packages. Do not include part of your package structure in the srcdir attribute (or nested <src> elements), or Ant will recompile your source files every time you run your compile target. See the -Ant FAQ +Ant FAQ for additional information.

    Note: If you are using Ant on Windows and a new DOS window pops up @@ -559,7 +559,7 @@ while all others are false.


    -

    Copyright © 2000-2002 Apache Software Foundation. +

    Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

    diff --git a/docs/manual/CoreTasks/tempfile.html b/docs/manual/CoreTasks/tempfile.html index f234b0f37..78ce88cd8 100644 --- a/docs/manual/CoreTasks/tempfile.html +++ b/docs/manual/CoreTasks/tempfile.html @@ -22,7 +22,7 @@ - + Apache Ant @@ -184,7 +184,7 @@ the parent directory is used instead
    - Copyright © 2000-2002, Apache Software Foundation + Copyright © 2000-2003, Apache Software Foundation
    diff --git a/docs/manual/Integration/Antidote.html b/docs/manual/Integration/Antidote.html index 63621c8a2..8abb2c536 100644 --- a/docs/manual/Integration/Antidote.html +++ b/docs/manual/Integration/Antidote.html @@ -17,7 +17,7 @@

    Overview

    Antidote is the Ant subproject + HREF="http://ant.apache.org/index.html">Ant subproject for developing a graphical user interface to facilitate the efficient use of Ant. In general, its purpose is to allow the quick generation, modification, and use of Ant build files, @@ -70,12 +70,12 @@

    Online discussions about Antidote occur on the jakarta-ant + HREF="http://ant.apache.org/mail.html">Ant developer mailing list. The application infrastructure is fairly complete, but there are almost unlimited opportunities for feature contributions.

    -

    Aspiring contributors new to the Jakarta Project should +

    Aspiring contributors new to the project should (carefully) read the following for details on the contribution process:

      @@ -83,7 +83,7 @@ HREF="http://jakarta.apache.org/site/getinvolved.html">Get Involved
    • Project + HREF="http://ant.apache.org/guidelines.html">Project Guidelines
    • Source Repositories (how to contribute patches)
    • @@ -91,7 +91,7 @@
      -

      Copyright © 2001 Apache Software Foundation. All +

      Copyright © 2001,2003 Apache Software Foundation. All rights Reserved.

      diff --git a/docs/manual/OptionalTasks/setproxy.html b/docs/manual/OptionalTasks/setproxy.html index 8d6fb8044..8688e3700 100644 --- a/docs/manual/OptionalTasks/setproxy.html +++ b/docs/manual/OptionalTasks/setproxy.html @@ -22,7 +22,7 @@ - + Apache Ant @@ -208,7 +208,7 @@
      - Copyright © 2000-2002, Apache Software Foundation + Copyright © 2002-2003, Apache Software Foundation
      diff --git a/docs/manual/cover.html b/docs/manual/cover.html index 3c7906a9d..a6caeea49 100644 --- a/docs/manual/cover.html +++ b/docs/manual/cover.html @@ -10,7 +10,7 @@

      Apache Ant 1.6 Manual

      This is the manual for version 1.6alpha of - Apache Ant. + Apache Ant. If your version of Ant (as verified with ant -version) is older or newer than this version then this is not the correct manual set. Please use the documentation @@ -20,7 +20,7 @@

       


      -

      Copyright © 2000-2002 Apache Software Foundation. All rights +

      Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

      diff --git a/docs/manual/develop.html b/docs/manual/develop.html index da505fd98..60f22b416 100644 --- a/docs/manual/develop.html +++ b/docs/manual/develop.html @@ -351,12 +351,12 @@ for details on how to fetch the latest source and how to submit changes for rein source tree.

      Ant also has some -task guidelines +task guidelines which provides some advice to people developing and testing tasks. Even if you intend to keep your tasks to yourself, you should still read this as it should be informative.


      -

      Copyright © 2000-2002 Apache Software Foundation. All rights +

      Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

      diff --git a/docs/manual/feedback.html b/docs/manual/feedback.html index 8a08f3f85..592fb628a 100644 --- a/docs/manual/feedback.html +++ b/docs/manual/feedback.html @@ -27,23 +27,23 @@
    • If a task doesn't do what you expect, run ant -verbose or ant -debug to see what is happening
    • -

      If you can't fix your problem, start with the Ant +

      If you can't fix your problem, start with the Ant User Mailing List . These are other ant users who will help you learn to use ant. If they cannot fix it then someone may suggest filing a bug report, which will escalate the issue. Remember of course, that support, like all open source development tasks, is voluntary. If you haven't invested time in helping yourself by following the steps above, it is unlikely that anyone will invest the time in helping you.

      -

      Also, if you don't understand something, the Ant +

      Also, if you don't understand something, the Ant User Mailing List is the place to ask questions. Not the developer list, nor the individuals whose names appears in the source and documentation. If they answered all such emails, nobody would have any time to improve ant.

      -

      To provide feedback on this software, please subscribe to the Ant +

      To provide feedback on this software, please subscribe to the Ant User Mailing List

      If you want to contribute to Ant or stay current with the latest development, join the -Ant Development Mailing List +Ant Development Mailing List

      Archives of both lists can be found at http://archive.covalent.net/. Many @@ -52,7 +52,7 @@ href="http://marc.theaimsgroup.com" target="_top">http://marc.theaimsgroup.com


      -

      Copyright © 2000-2002 Apache Software Foundation. All rights +

      Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.

      diff --git a/docs/manual/install.html b/docs/manual/install.html index af31b337e..cf9f230f1 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -10,15 +10,13 @@

      Getting Ant

      Binary Edition

      The latest stable version of Ant is available from the Ant web page http://jakarta.apache.org/ant/. +href="http://ant.apache.org/">http://ant.apache.org/. If you like living on the edge, you can download the latest version from http://cvs.apache.org/builds/jakarta-ant/nightly/.

      Source Edition

      -

      If you prefer the source edition, you can download the source for the latest Ant release from -http://www.apache.org/dist/ant/source/. +

      If you prefer the source edition, you can download the source for the latest Ant release from http://ant.apache.org/srcdownload.cgi. Again, if you prefer the edge, you can access the code as it is being developed via CVS. The Jakarta website has details on diff --git a/docs/mission.html b/docs/mission.html new file mode 100644 index 000000000..be03503c0 --- /dev/null +++ b/docs/mission.html @@ -0,0 +1,297 @@ + + + + + + + + Apache Ant - Apache Ant Mission + + + + + + + + + + + +
      + + + + + + + + + + + +
      Apache Ant siteApache Ant logo +
      + + + + + + + + + + +
      +
      + + the Apache Ant site + + +
      +
      +
      +
      + + + + + +
      + + + + +
      Home
      +
      +
      +
      + + + + +
      + + + + + + + + + + +
      + + + + + + + + + + +
       
      +
      + +
      +
      + + + + + + + + + + + + + +
      +   + +   +
      +
      + + + + +
      +

      Apache Ant Mission

      +
      +
      + + +
      Board Resolution
      +

      Apache Ant is a project of the Apache Software Foundation. It + started as a subproject of the Apache Jakarta Project.

      +

      This is the board resolution (from the minutes) + that created the Apache Ant project:

      +
      +7.D. Resolution [R3] to create the Ant PMC
      +
      +WHEREAS, the Board of Directors deems it to be in the best
      +interests of the Foundation and consistent with the
      +Foundation's purpose to establish a Project Management
      +Committee charged with the creation and maintenance of
      +open-source software related to the Apache Ant build tool, for
      +distribution at no charge to the public.
      +
      +NOW, THEREFORE, BE IT RESOLVED, that a Project Management
      +Committee (PMC), to be known as the "Apache Ant PMC", be and
      +hereby is established pursuant to Bylaws of the Foundation; and
      +be it further
      +
      +RESOLVED, that the Apache Ant PMC be and hereby is responsible
      +for the creation and maintenance of the Ant build system and
      +related software components, based on software licensed to the
      +Foundation; and be it further
      +
      +RESOLVED, that the office of "Vice President, Apache Ant" be
      +and hereby is created, the person holding such office to serve
      +at the direction of the Board of Directors as the chair of the
      +Apache Ant PMC, and to have primary responsibility for
      +management of the projects within the scope of responsibility
      +of the Apache Ant PMC; and be it further
      +
      +RESOLVED, that the persons listed immediately below be and
      +hereby are appointed to serve as the initial members of the
      +Apache Ant PMC:
      +
      +   Bruce Atherton
      +   Stefane Bailliez
      +   Stefan Bodewig
      +   Erik Hatcher
      +   Diane Holt
      +   Donald Leslie
      +   Steve Loughran
      +   Conor MacNeill
      +   Costin Manolache
      +   Sam Ruby
      +   Jon Skeet
      +   Magesh Umasankar
      +   Christoph Wilhelms
      +
      +NOW, THEREFORE, BE IT FURTHER RESOLVED, that Conor MacNeill be
      +and hereby is appointed to the office of Vice President, Apache
      +Ant, to serve in accordance with and subject to the direction
      +of the Board of Directors and the Bylaws of the Foundation
      +until death, resignation, retirement, removal or
      +disqualification, or until a successor is appointed; and be it
      +further
      +
      +RESOLVED, that the initial Apache Ant PMC be and hereby is
      +tasked with the creation of a set of bylaws intended to
      +encourage open development and increased participation in the
      +Apache Ant Project.
      +
      +By Unanimous Vote, Resolution R3 was approved. The Ant PMC is
      +hereby created.
      +    
      + + +
      +
      +
      + + + + + + + +
      + + + + + + + + + + + diff --git a/docs/page.css b/docs/page.css new file mode 100644 index 000000000..8462a8635 --- /dev/null +++ b/docs/page.css @@ -0,0 +1,52 @@ +body { background-color: #FFFFFF; margin: 0px 0px 0px 0px; font-family: Verdana, Helvetica, sans-serif; font-size : 90%; } + +a:link { color: #0F3660; } +a:visited { color: #009999; } +a:active { color: #000066; } +a:hover { color: #000066; } + +.menu { background-color: #4C6C8F; margin: 0px; padding: 3px 8px 5px 3px; font-size : 90%; } +.menu a:link { color: #FFFFFF; text-decoration : none; } +.menu a:visited { color: #FFFFFF; text-decoration : none; } +/*.menu a:active { font-weight: bold }*/ +.menu a:hover { color: #FFCC00; text-decoration : none; } +.menu ul { margin: 0px 0px 0px 20px; padding: 0px; } +.menu li { list-style-image: url('images/label.gif'); font-weight : bold; } +.menu ul ul li .sel { list-style-image: url('images/current.gif'); font-weight : normal; } +.menu ul ul li { list-style-image: url('images/page.gif'); font-weight : normal; } + +table .title { background-color: #FFFFFF; width:100%; border: 0px; } +.dida { font-size: 60%; } + +.pre { white-space: pre;} +.nowrap { white-space: nowrap;} + +.content { padding: 5px 5px 5px 10px; font : small; font-size : 90%; } +.content .ForrestTable { width: 100%; background-color: #7099C5; color: #ffffff; font-size : 90%;} +.content .ForrestTable caption { text-align: left; color: black; font-weight: bold; } +.content .ForrestTable th { text-align: center; } +.content .ForrestTable td { background-color: #f0f0ff; color: black; } + +.frame { margin: 5px 20px 5px 20px; font-size: 90%; } +.frame .content { margin: 0px; } + +.note { border: solid 1px #7099C5; background-color: #f0f0ff; } +.note .label { background-color: #7099C5; color: #ffffff; } + +.warning { border: solid 1px #D00000; background-color: #fff0f0; } +.warning .label { background-color: #D00000; color: #ffffff; } + +.fixme { border: solid 1px #C6C600; background-color: #FAF9C3; } +.fixme .label { background-color: #C6C600; color: #ffffff; } + +.code { border-color: #CFDCED; border-style: solid; border-width: 1px; } +.codefrag { font-family: "Courier New", Courier, monospace; } + +.highlight { background-color: yellow; } + +.minitoc {margin: 5px 5px 5px 40px;} + +.dtdElement { width: 100%; font-size: 90%; background-color : #ffffff; } + +.dtdTag { color: #990000; text-transform : uppercase; font-style : normal; font-size : 120%; font-weight : bold; } + diff --git a/docs/problems.html b/docs/problems.html index ede70b45b..47f73ee1c 100644 --- a/docs/problems.html +++ b/docs/problems.html @@ -1,105 +1,207 @@ - - - - - + + - - - + + Apache Ant - Having Problems? + + - - - Apache Ant - Having Problems? - - - - - + + + +
      - - - + + + + +
      - The Apache Jakarta Project - - Apache Ant -
      - - - + +
      -
      -
      + + + + + + - - - + +
      Apache Ant siteApache Ant logo +
      + + + + + + + + + + +
      +
      + + the Apache Ant site + + +
      +
      +
      +
      + + + + + +
      + + + + +
      Home
      +
      +
      +
      -

      Apache Ant

      - -

      Download

      - -

      Jakarta

      - -

      Get Involved

      - -
      - - - + +
      - - Having Problems? - -
      -
      +
      + + + + + + + + +
      + + + + + + + + + + +
      + + + + + + + + + + +
       
      +
      + +
      +
      + + + + + + + + + + + + -
      +   + +   +
      +
      + + + + +
      +

      Having Problems?

      +
      +
      + + +
      Having Problems?

      This page details some steps you can take to try and resolve any problems you may be having with Ant. If you find you can't @@ -110,14 +212,15 @@ you may encounter - these are just some suggestions to point you in the right direction.

      - - - -
      - - Read the Manual - -
      -
      +
      + + + +
      + + Read the Manual + +

      The first step to take when you have a problem with Ant is to read the manual entry for the task or @@ -128,17 +231,15 @@ documentation bug report (see below) to help us improve the Ant documentation.

      -
      -
      - - - -
      - - Examine Debug Output - -
      -
      +
      + + + +
      + + Examine Debug Output + +

      If you're still having a problem, the next step is to try and gather additional information about what Ant is doing. @@ -152,11 +253,10 @@

      This will produce output that starts like the following:

      - +
      - +
      - Ant version 1.4.1 compiled on October 11 2001
      Buildfile: build.xml
      @@ -171,8 +271,7 @@ Build sequence for target 'debug' is [debug]
      Complete build sequence is [debug, gensrc, compile, jar, test]
      . . .
      -
      -

      @@ -203,11 +302,10 @@ Complete build sequence is [debug, gensrc, compile, jar, test]
      arguments that will get passed to the compiler, and a list of all the class files to be compiled.

      - +
      - +
      - [javac] Test.java omitted as D:\classes\Test.class is up to date.
      [javac] Unset.java added as D:\classes\Unset.class is outdated.
      @@ -218,8 +316,7 @@ D:\jdk118\classes.zip; -sourcepath D:\src\java -g:none
      [javac] File to be compiled:
      D:\src\java\Unset.java
      -
      -

      @@ -236,17 +333,15 @@ D:\src\java\Unset.java
      generated command line. This can help you to understand whether you are using the correct attributes and values.

      -
      -
      - - - -
      - - Has It Been Fixed? - -
      -
      +
      + + + +
      + + Has It Been Fixed? + +

      After examining the debug output, if you still believe that the problem you are having is caused by Ant, chances are that someone @@ -255,7 +350,7 @@ D:\src\java\Unset.java
      of Ant to see if the problem has been fixed. Nightly builds for Ant are available from the - Jakarta web site. While Ant nightly builds are typically quite + Ant web site. While Ant nightly builds are typically quite stable and are used by Gump to build many other Jakarta projects, these builds should @@ -267,17 +362,15 @@ D:\src\java\Unset.java
      area. However, even this snapshot does not contain every optional task.

      -
      -
      - - - -
      - - Has It Been Reported? - -
      -
      +
      + + + +
      + + Has It Been Reported? + +

      If the current nightly build doesn't resolve your problem, it is possible that someone else has reported the issue. It is time to @@ -295,17 +388,15 @@ D:\src\java\Unset.java
      add yourself to the CC list to follow the progress of this bug.

      -
      -
      - - - -
      - - Filing a Bug Report - -
      -
      +
      + + + +
      + + Filing a Bug Report + +

      By this time, you may have decided that there is an unreported bug in Ant. You have a few choices at this point. You can send @@ -339,17 +430,15 @@ D:\src\java\Unset.java
      you receive email asking for further information, please try to respond, as it will aid in the resolution of your bug.

      -
      -
      - - - -
      - - Asking for an Enhancement - -
      -
      +
      + + + +
      + + Asking for an Enhancement + +

      Sometimes, you may find that Ant just doesn't do what you need it to. It isn't a bug, as such, since Ant is working the way it is @@ -367,23 +456,21 @@ D:\src\java\Unset.java
      enhancment requests that cover your needs. If so, just add your vote to these.

      -
      -
      - - - -
      - - Fixing the Bug - -
      -
      +
      + + + +
      + + Fixing the Bug + +

      If you aren't satisfied with just filing a bug report, you can try to find the cause of the problem and provide a fix yourself. The best way to do that is by working with the latest code from CVS. Alternatively, you can work with the source code available from the - + source distributions. If you are going to tackle the problem at this level, you may want to discuss some details first on the ant-dev @@ -415,28 +502,32 @@ D:\src\java\Unset.java
      This makes it easier for developers who need to apply a number of different patch files.

      -
      -
      - -
      -
      +
      + + + + + + - - - -
      -
      -
      -
      - Copyright © 2000-2003, Apache Software Foundation -
      -
      - + + + + + diff --git a/docs/projects.html b/docs/projects.html index b5d3edc8b..f809e1a89 100644 --- a/docs/projects.html +++ b/docs/projects.html @@ -1,189 +1,274 @@ - - - - - + + - - - + + Apache Ant - Related Projects + + - - - Apache Ant - Related Projects - - - - - + + + +
      - - - + + + + +
      - The Apache Jakarta Project - - Apache Ant -
      - - - + +
      -
      -
      + + + - - - + +
      Apache Ant siteApache Ant logo +
      + + + + + + + + + + +
      +
      + + the Apache Ant site + + +
      +
      +
      -

      Apache Ant

      - -

      Download

      - -

      Jakarta

      - -

      Get Involved

      - -
      - - - + + + + +
      - - Related Projects - -
      -
      +
      +
      + + + + + +
      + + + + +
      Home
      +
      +
      +
      + + + + + + + + +
      + + + + + + + + + + +
      + + + + + + + + + + +
       
      +
      + +
      +
      + + + + + + + + + + + + -
      +   + +   +
      +
      + + + + +
      +

      Related Projects

      +
      +
      + + +
      Related Projects

      Nothing listed here is directly supported by the Ant developers, if you encounter any problems with them, please use the contact information.

      - - - -
      - - AntContrib - -
      -
      +
      + + + +
      + + AntContrib + +

      The Ant-Contrib project is a collection of user supplied task (like an <if> task) and a development playground for experimental tasks like a C/C++ compilation task for different compilers.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - 1.4.1 and above - -
      - URL: - - + - http://sourcefoge.net/projects/ant-contrib/ - -
      - Contact: - - + - project mailing list - -
      - License: - - + - Apache Software Foundation license - -
      -
      -
      - - - -
      - - AntDoc - -
      -
      +
      + + + +
      + + AntDoc + +

      AntDoc is a tool that generates HTML documentation from Ant buildfiles; the generated HTML is inspired from what javadoc yields. It also offers a simple Ant target launcher named @@ -191,75 +276,57 @@ AntDoc HTML pages.

      AntDoc can be run via an Ant task, AntDoc GUI can be run via an Ant task, or via a JVM launch.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - Ant 1.4.1 and higher - -
      - URL: - - + - http://mapage.noos.fr/antdoc - -
      - Contact: - - + - Edouard Mercier - -
      - License: - - + - At the moment, no license is being attached to the tool. - -
      -
      -
      - - - -
      - - AntHill - -
      -
      +
      + + + +
      + + AntHill + +

      Anthill is a build tool that promotes a controlled build process by ensuring that every build reflects the source repository contents and tagging the repository with a unique @@ -267,151 +334,115 @@ sharing of knowledge within an organization by automatically updating a project intranet site with artifacts from the latest build.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - bundles Ant 1.3, is compatible with Ant 1.3 to 1.4.1 - -
      - URL: - - + - http://www.urbancode.com/projects/anthill/ - -
      - Contact: - - + - Maciej Zawadzki - -
      - License: - - + - Mozilla-like license - -
      -
      -
      - - - -
      - - CruiseControl - -
      -
      +
      + + + +
      + + CruiseControl + +

      CruiseControl is a tool for setting up a continuous build process. CruiseControl provides an Ant wrapper and a set of tasks to automate the checkout/build/test cycle. CruiseControl also comes bundled with a servlet for viewing the status of the current build, as well as previous build results.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - Ant 1.2 and higher - -
      - URL: - - + - http://cruisecontrol.sourceforge.net/ - -
      - Contact: - - + - Project Mailing Lists and Administrators - -
      - License: - - + - Release 1.0 has been licensed under the GNU General Public License. Starting with release 1.1 the license has been changed to a BSD-like license. - -
      -
      -
      - - - -
      - - Krysalis Centipede - -
      -
      +
      + + + +
      + + Krysalis Centipede + +

      Krysalis Centipede is a project build system based on Apache Ant. Centipede uses pre-packaged modules called "cents" that it downloads and installs automatically. Cents can be @@ -424,304 +455,238 @@ to build project documentation which includes output from other cents such as Javadoc, JDepend, Checkstyle and many others.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - 1.4.1 an later - -
      - URL: - - + - http://krysalis.org/centipede/ - -
      - Contact: - - + - mailing lists - -
      - License: - - + - The Krysalis Patchy Software License, based on and fully compatible with the Apache Software Foundation license - -
      -
      -
      - - - -
      - - NAnt - -
      -
      +
      + + + +
      + + NAnt + +

      NAnt is a .NET based build tool. In theory it is kind of like make without make's wrinkles. In practice it's a lot like Ant.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - compatible in spirit. - -
      - URL: - - + - http://nant.sourceforge.net/ - -
      - Contact: - - + - project mailing list - -
      - License: - - + - GNU General Public License - -
      -
      -
      - - - -
      - - Rant - -
      -
      +
      + + + +
      + + Rant + +

      Rant stands for Remote Ant. It is a distributed build system that allows an Ant build file to launch builds on other systems and receive exceptions should they occur.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - Ant 1.4 - -
      - URL: - - + - http://sourceforge.net/projects/remoteant/ - -
      - Contact: - - + - Chris Nelson - -
      - License: - - + - MIT License - -
      -
      -
      - - - -
      - - XML Publication - -
      -
      +
      + + + +
      + + XML Publication + +

      XML Publication is a set of tools to generate Web pages from desktop documents or other structured documents using XSLT and Ant.

      - +
      - - + - - + - - + - - +
      - Compatibility: - - + - Ant 1.4 - -
      - URL: - - + - http://XMLpublication.org/ - -
      - Contact: - - + - Jean-Marc Vanel - -
      - License: - - + - GNU General Public License. - -
      -
      -
      - -
      -
      +
      + + + + + + - - - -
      -
      -
      -
      - Copyright © 2000-2003, Apache Software Foundation -
      -
      - + + + + + diff --git a/docs/resources.html b/docs/resources.html index 3ee90cdb2..b12a1e26f 100644 --- a/docs/resources.html +++ b/docs/resources.html @@ -1,197 +1,277 @@ - - - - - + + - - - + + Apache Ant - Resources + + - - - Apache Ant - Resources - - - - - + + + +
      - - - + + + + +
      - The Apache Jakarta Project - - Apache Ant -
      - - - + +
      -
      -
      + + + + + + + + + +
      Apache Ant siteApache Ant logo +
      + + + + + + + + + + +
      +
      + + the Apache Ant site + + +
      +
      +
      +
      + + + + + +
      + + + + +
      Home
      +
      +
      +
      + + + + +
      + + + + + + + + + + +
      + + + + + + + + + + +
       
      +
      + +
      +
      + + + + + + + + + + + + + + + + + +
      +   + +   +
      +
      + - - - +
      +
      -

      Apache Ant

      - -

      Download

      - -

      Jakarta

      - -

      Get Involved

      - -
      - - - -
      - - FAQs - -
      -
      - - - + +
      - - At Ant's website - -
      -
      +
      +

      Resources

      +
      +
      + + +
      FAQs
      +
      + + + +
      + + At Ant's website + +

      Starting with the release of Ant 1.4 the Ant's FAQ is bundled with the distribution, the most recent version can always be found at the website.

      - +
      - - + +
      - FAQ: - - - - http://jakarta.apache.org/ant/faq.html - - + http://ant.apache.org/faq.html +
      -
      -
      - - - -
      - - jGuru - -
      -
      +
      + + + +
      + + jGuru + +

      jGuru hosts an interactive Ant discussion forum and FAQ system

      - +
      - - + - - +
      - Forum: - - + - http://www.jguru.com/forums/home.jsp?topic=Ant - -
      - FAQ: - - + - http://www.jguru.com/faq/home.jsp?topic=Ant - -
      -
      -
      - -
      +
      Books
      - - - -
      - - Books - -
      -

      Listed by descending publication date.

      - - - -
      - - Java Development with Ant - -
      -
      +
      + + + +
      + + Java Development with Ant + +

      Covers Ant 1.5, including:

      • The new Ant 1.5 features
      • @@ -212,157 +292,109 @@
      - +
      - - + - - +
      - Authors: - - + - Erik Hatcher and Steve Loughran - -
      - URL: - - + - http://www.manning.com/antbook/ - -
      -
      -
      - - - -
      - - Ant: The Definitive Guide - -
      -
      +
      + + + +
      + + Ant: The Definitive Guide + +

      Covers Ant release 1.4.1.

      - +
      - - + - - +
      - Authors: - - + - Jesse E. Tilly and Eric M. Burke - -
      - URL: - - + - http://www.oreilly.com/catalog/anttdg/ - -
      -
      -
      - - - -
      - - Ant. Kurz und Gut. - -
      -
      +
      + + + +
      + + Ant. Kurz und Gut. + +

      A German language short reference for Ant that covers Ant 1.4. This is the original description:

      -
      - - - - - - - - - - - - - - - - -
      -  Ant kurz & gut enth�lt eine vollst�ndige Referenz der Built-in Tasks
      -  und ihrer jeweiligen Attribute sowie kurze Beispiele f�r ihre Verwendung.
      -  Daneben bietet das Buch eine knappe Einf�hrung in die Arbeit mit Ant und
      -  eine Erl�uterung der Ant-Basiselemente (Projekte, Properties, Targets und Tasks).
      -  Behandelt werden au�erdem grundlegende Konzepte wie Filesets, Patternsets und
      -  Pfadstrukturen, das Schreiben eigener Tasks, die Aufruf-Syntax und Optional Tasks. 
      -
      - +
      +  Ant kurz & gut enthält eine vollständige Referenz der Built-in Tasks
      +  und ihrer jeweiligen Attribute sowie kurze Beispiele für ihre Verwendung.
      +  Daneben bietet das Buch eine knappe Einführung in die Arbeit mit Ant und
      +  eine Erläuterung der Ant-Basiselemente (Projekte, Properties, Targets und Tasks).
      +  Behandelt werden außerdem grundlegende Konzepte wie Filesets, Patternsets und
      +  Pfadstrukturen, das Schreiben eigener Tasks, die Aufruf-Syntax und Optional Tasks. 
      +
      - - + - - +
      - Author: - - + - Stefan Edlich - -
      - URL: - - + - http://www.amazon.de/exec/obidos/ASIN/3897212412/ - -
      -
      -
      - - - +
      +
      - - Java Tools for eXtreme Programming - -
      -
      +
      + + + +
      + + Java Tools for eXtreme Programming + +

      This book covers the following XP subjects:

      • Automated unit and functional testing
      • @@ -371,961 +403,736 @@
      • How Ant, JUnit, JUnitPerf, Cactus, HTTPUnit, and JMeter can be used to achieve the goals of the XP methodology
      - +
      - - + - - +
      - Authors: - - + - Richard Hightower and Nicholas Lesiecki - -
      - URL: - - + - http://www.wiley.com/cda/product/0,,047120708X,00.html - -
      -
      -
      +
      Articles and Presentations
      -
      -
      - - - +
      +
      - - Articles and Presentations - -
      -

      The following sections list articles and presentations written about Apache Ant. If you've written something that should be included, please post it to one of the mailing lists.

      -
      -
      +
      Articles
      - - - +
      +
      - - Articles - -
      -
      - - - -
      - - Ant in Anger: Using Ant in a Production Development System - -
      -
      +
      + + + +
      + + Ant in Anger: Using Ant in a Production Development System + +

      This document describes strategies and some basic examples of how to use Ant in larger team development projects.

      - +
      - - + - - + +
      - Author: - - + - Steve Loughran - -
      - URL: - - - - http://jakarta.apache.org/ant/ant_in_anger.html - - + http://ant.apache.org/ant_in_anger.html +
      -
      -
      - - - -
      - - Ant Task Guidelines - -
      -
      +
      + + + +
      + + Ant Task Guidelines + +

      This document describes how to write custom Ant tasks, and how to submit them to potentially be included in Ant.

      - +
      - - + - - + +
      - Author: - - + - Steve Loughran - -
      - URL: - - - - http://jakarta.apache.org/ant/ant_task_guidelines.html - - + http://ant.apache.org/ant_task_guidelines.html +
      -
      -
      - - - -
      - - Automating the build and test process - -
      -
      +
      + + + +
      + + Automating the build and test process + +

      This article demonstrates an approach to the automated build and test process. Working with Ant 1.3 and the JUnit test framework, it shows how to automate a process that captures pertinent information about each test suite run, generates an attractive report, and e-mails the report.

      - +
      - - + - - +
      - Author: - - + - Erik Hatcher - -
      - URL: - - + - http://www.ibm.com/developerworks/java/library/j-junitmail/ - -
      -
      -
      - - - -
      - - Incremental development with Ant and JUnit - -
      -
      +
      + + + +
      + + Incremental development with Ant and JUnit + +

      This article explores the benefits of unit testing with Ant and JUnit, detailing how to develop automated unit tests and integrate them into your build process.

      - +
      - - + - - +
      - Author: - - + - Malcolm Davis - -
      - URL: - - + - http://www-106.ibm.com/developerworks/library/j-ant/?dwzone=java - -
      -
      -
      - - - -
      - - Automate your build process using Java and Ant - -
      -
      +
      + + + +
      + + Automate your build process using Java and Ant + +

      This article provides an introduction to using Ant with some basic examples and by highlighting some of the important tasks.

      - +
      - - + - - +
      - Author: - - + - Michael Cymerman - -
      - URL: - - + - http://www.javaworld.com/javaworld/jw-10-2000/jw-1020-ant.html - -
      -
      -
      - - - -
      - - Short tutorial in Cactus' (formerly J2EEUnit) documentation - -
      -
      +
      + + + +
      + + Short tutorial in Cactus' (formerly J2EEUnit) documentation + +

      There is a short tutorial on how to use Ant in Cactus' documentation. It has a slant towards build files that will be used with Cactus.

      - +
      - - + - - +
      - Author: - - + - Cactus development team - -
      - URL: - - + - http://jakarta.apache.org/cactus/howto_ant_primer.html - -
      -
      -
      - - - -
      - - Developing custom Ant tasks with VisualAge for Java - -
      -
      +
      + + + +
      + + Developing custom Ant tasks with VisualAge for Java + +

      This article outlines how to integrate Ant into VisualAge for Java, and how to write and debug custom tasks using the IDE and the integrated debugger.

      - +
      - - + - - +
      - Author: - - + - Glenn McAllister - -
      - URL: - - + - http://www7.software.ibm.com/vad.nsf/data/document2366?OpenDocument&p=1&BCT=1&Footer=1 - -
      -
      -
      - - - -
      - - Automated builds with VisualAge for Java and Ant - -
      -
      +
      + + + +
      + + Automated builds with VisualAge for Java and Ant + +

      This article shows how you can perform command line builds with a VisualAge for Java repository.

      - +
      - - + - - +
      - Author: - - + - Glenn McAllister - -
      - URL: - - + - http://www7.software.ibm.com/vad.nsf/Data/Document4366?OpenDocument&p=1&BCT=3&Footer=1 - -
      -
      -
      - - - -
      - - Ant: A Build Tool from the Jakarta Project - -
      -
      +
      + + + +
      + + Ant: A Build Tool from the Jakarta Project + +

      This article is from the "Best Practices" section of Sun's Dot-Com Builder Site.

      - +
      - - + - - +
      - Author: - - + - Laura Geele Wang - -
      - URL: - - + - http://dcb.sun.com/practices/profiles/ant.jsp - -
      -
      -
      - - - -
      - - Making a Mountain Out of an Anthill - -
      -
      +
      + + + +
      + + Making a Mountain Out of an Anthill + +

      This article is from the June 2001 issue of the Java Developer' Journal. You need to be a registered JDJ subscriber to view this article.

      - +
      - - + - - +
      - Author: - - + - Neal Ford - -
      - URL: - - + - http://www.sys-con.com/java/archivesa.cfm?volume=06&issue=06 - -
      -
      -
      - - - -
      - - Using Ant and Weblogic EJBs - -
      -
      +
      + + + +
      + + Using Ant and Weblogic EJBs + +

      This article describes how to use Ant to create Weblogic EJBs, and some workarounds for issues you may encounter.

      - +
      - - + - - +
      - Author: - - + - Jesse E. Tilly - -
      - URL: - - + - http://www.onjava.com/pub/a/onjava/2001/06/25/antejb.html - -
      -
      -
      - - - -
      - - An Introduction to Ant - -
      -
      +
      + + + +
      + + An Introduction to Ant + +

      This article is a short introduction into the basic concepts of Ant.

      - +
      - - + - - +
      - Author: - - + - Jayakrishnan Nair - -
      - URL: - - + - http://varnam.org/articles/ant.html - -
      -
      -
      - - - -
      - - Using JavaScript with Ant - -
      -
      +
      + + + +
      + + Using JavaScript with Ant + +

      A tutorial about using JavaScript and XSLT with Ant.

      - +
      - - + - - +
      - Author: - - + - Dylan Schiemann - -
      - URL: - - + - http://www.sitepen.com/ant/javascript.html - -
      -
      -
      - - - -
      - - Building with Ant - -
      -
      +
      + + + +
      + + Building with Ant + +

      Series of articles that describe a framework for web application development based on Ant and JUnit.

      - +
      - - + - - +
      - Author: - - + - Alex Chaffee - -
      - URL: - - + - Introduction: http://softwaredev.earthweb.com/sdtech/article/0,,12065_989631,00.html
      Directory Structure: http://softwaredev.earthweb.com/sdtech/article/0,,12082_994991,00.html
      Deployment and Distribution: http://softwaredev.earthweb.com/sdtech/article/0,,12077_998241,00.html -
      -
      -
      -
      - - - -
      - - Developing with JAXB and Ant - -
      -
      +
      + + + +
      + + Developing with JAXB and Ant + +

      Series of articles that shows how to use Ant together with the Java API for XML Binding (JAXB).

      - +
      - - + - - +
      - Author: - - + - Joseph Shelby - -
      - URL: - - + - http://www.onjava.com/pub/a/onjava/2002/03/06/jaxant1.html
      http://www.onjava.com/pub/a/onjava/2002/03/13/jaxbant2.html -
      -
      -
      -
      -
      -
      +
      Presentations
      - - - -
      - - Presentations - -
      -
      - - - -
      - - Ant - presented to the Tucson Java Users Group - -
      -
      +
      + + + +
      + + Ant - presented to the Tucson Java Users Group + +

      A PowerPoint technical overview presentation on Ant. Comes complete with a straightforward example demonstrating code compilation, JAR'ing, JUnit testing, JUnit reporting, and Zipping a distribution. A few advanced topics are touched upon like property immutabality and using <antcall> to get around it, build listeners, and writing custom tasks.

      - +
      - - + - - +
      - Author: - - + - Erik Hatcher - -
      - URL: - - + - http://erik.hatcher.net/ant-jug.zip - -
      -
      -
      - - - -
      - - Ant Build Tool - -
      -
      +
      + + + +
      + + Ant Build Tool + +

      A PowerPoint presentation on Ant 1.2. It provides a basic overview of Ant's capabilities.

      - +
      - - + - - +
      - Author: - - + - Patrick Chanezon - -
      - URL: - - + - http://people.netscape.com/chanezon/tech/ant/ant_preso.ppt - -
      -
      -
      - - - -
      - - Ant - -
      -
      +
      + + + +
      + + Ant + +

      A detailed Ant 1.3 PowerPoint presentation, made at the St. Louis Java Users Group meeting in March 2001. Includes a detailed build file and basic descriptions of all the built in and optional tasks. Updated for Ant 1.4 in October 2001. Available in PDF format now.

      - +
      - - + - - +
      - Author: - - + - Mark Volkmann - -
      - URL: - - + - http://www.ociweb.com/jnb/files/Ant.pdf - -
      -
      -
      - - - -
      - - Modern Development Crises - -
      -
      +
      + + + +
      + + Modern Development Crises + +

      This presentation is an overview of the current state of software development today. There are a couple of slides that briefly cover Ant.

      - +
      - - + - - +
      - Author: - - + - Steve Loughran - -
      - URL: - - + - http://www.iseran.com/Steve/modern_development_processes.html - -
      -
      -
      - - - -
      - - When Web Services Go Bad - -
      -
      +
      + + + +
      + + When Web Services Go Bad + +

      A presentation from the Web Services DevCon in March 2002.

      - +
      - - + - - +
      - Author: - - + - Steve Loughran - -
      - URL: - - + - http://www.iseran.com/Steve/papers/when_web_services_go_bad.html - -
      -
      -
      -
      -
      -
      +
      + + + + + + - - - -
      -
      -
      -
      - Copyright © 2000-2003, Apache Software Foundation -
      -
      - + + + + + diff --git a/docs/srcdownload.html b/docs/srcdownload.html index 1365b1952..c3abf6b8f 100644 --- a/docs/srcdownload.html +++ b/docs/srcdownload.html @@ -1,104 +1,205 @@ - - - - - + + - - - - - - Apache Ant - Downloading Ant - Source Distribution - - - - - + + Apache Ant - Downloading Ant - Source Distribution + + + + +
      + + + + + + +
      + + + + + + + + - - - + +
      Apache Ant siteApache Ant logo +
      + + + + + + + + + + +
      +
      + + the Apache Ant site + + +
      +
      +
      +
      + + + + + +
      + + + + +
      Home
      +
      +
      +
      - The Apache Jakarta Project - - Apache Ant -
      - - - +
      -
      -
      + + + +
      + + + + + + + + + + +
      + + + + + + + + + + +
       
      +
      + +
      +
      + + + + + + + + + + + + + + + + + +
      +   + +   +
      +
      + - - - +
      +
      -

      Apache Ant

      - -

      Download

      - -

      Jakarta

      - -

      Get Involved

      - -
      - - - + +
      - - Downloading Ant - -
      -
      +
      +

      Downloading Ant - Source Distribution

      +
      +
      + + +
      Downloading Ant

      Use the links below to download a source distribution of Ant from one of our mirrors. You must verify the integrity of the @@ -113,17 +214,10 @@ Thus they must be untarred with a GNU compatible version of

      If you do not see the file you need in the links below, please see the master distribution directory or, preferably, its mirror.

      - -
      +
      Mirror
      - - - +
      +
      - - Mirror - -
      -

      You are currently using [preferred]. If you encounter a problem with this mirror, please select another mirror. If all mirrors are failing, there are backup mirrors (at the end of @@ -142,17 +236,10 @@ Other mirrors: -

      -
      +
      Current Release of Ant
      - - - +
      +
      - - Current Release of Ant - -
      -

      Currently, Apache Ant 1.5.1 is the best available version, see the release notes.

        @@ -171,46 +258,25 @@ Other mirrors:
      +
      Nightly Builds
      - - - +
      +
      - - Nightly Builds - -
      -

      If you wish to use the latest Ant features, you can try downloading a nightly build.

      -
      -
      +
      Old Ant Releases
      - - - +
      +
      - - Old Ant Releases - -
      -

      Older releases of Ant can be found here. Those releases are only provided as zip archives that can be extracted by jar xf archive.zip - we highly recommend to not use those releases but upgrade to Ant's latest release.

      -
      -
      +
      Verify Releases
      - - - -
      - - Verify Releases - -
      -

      It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures.

      The PGP signatures can be verified using PGP or GPG. First @@ -240,25 +306,32 @@ included in many unix distributions. It is also available as part of Textutils. Windows users can get binary md5 programs from here, here, or here.

      We highly recommend to verify the PGP signature, though.

      -
      -
      -
      +
      + + + + + + - - - -
      -
      -
      -
      - Copyright © 2000-2003, Apache Software Foundation -
      -
      - + + + + + diff --git a/xdocs/antnews.xml b/xdocs/antnews.xml index c7db58504..689cd343b 100644 --- a/xdocs/antnews.xml +++ b/xdocs/antnews.xml @@ -5,14 +5,14 @@ Conor MacNeill Stefan Bodewig Magesh Umasankar - Ant News + News

      October 3, 2002 - Ant 1.5.1 Available !

      The final version of Ant 1.5.1 is now available for - + download. If you have any feedback on this release, feel free to join the discussion on the ant-dev and ant-user mailing lists.

      @@ -21,8 +21,7 @@

      August 19, 2002 - Ant 1.5.1 Beta1 Available !

      The first beta version of Ant 1.5.1 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

      @@ -44,8 +43,7 @@

      June 24, 2002 - Ant 1.5 Beta3 Available!

      The third beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

      @@ -53,8 +51,7 @@

      June 1, 2002 - Ant 1.5 Beta2 Available!

      The second beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

      @@ -62,8 +59,7 @@

      Ant 1.5 Beta1 Available !

      The first beta version of Ant 1.5 is now available for - - download. If you have any feedback on the beta feel free to join the + download. If you have any feedback on the beta feel free to join the discussion on the ant-dev and ant-user mailing lists.

      @@ -176,7 +172,7 @@

      If you want to shape the future of Ant, join the - Ant-Dev mailing list and contribute + Ant-Dev mailing list and contribute your ideas.

      diff --git a/xdocs/bindownload.xml b/xdocs/bindownload.xml index 434bb7c37..4ee9402ff 100644 --- a/xdocs/bindownload.xml +++ b/xdocs/bindownload.xml @@ -12,8 +12,8 @@

      Use the links below to download a binary distribution of Ant from one of our mirrors. You must -verify the integrity of -the downloaded files using signatures downloaded from our main +verify the integrity of the +downloaded files using signatures downloaded from our main distribution directory.

      Ant is distributed as zip, tar.gz and diff --git a/xdocs/contributors.xml b/xdocs/contributors.xml new file mode 100644 index 000000000..a88619027 --- /dev/null +++ b/xdocs/contributors.xml @@ -0,0 +1,278 @@ + + + + Contributors + + + +

      + + + +

      + Bruce Atherton (bruce at callenish.com - http://www.callenish.com/~bruce) +
      +Currently a Systems Architect with Avue Technologies, Bruce has been +working with Java since version 1.0a2. He also claims to be one of the first +people to mark up a FAQ with HTML, for a web browser of the distant past +called Cello. +

      + +

      + Stephane Bailliez
      +

      + +

      + Stefan Bodewig (stefan.bodewig at epost.de) +
      +Stefan is a senior developer at BoST interactive, where he is mainly +responsible for a rule based configurator system. He spends some +time working on Open Source projects with Ant currently taking the +biggest share of it. +

      + +

      + Erik Hatcher (ehatcher at apache.org - http://erik.hatcher.net) +
      +Erik is the co-author of +Java Development with Ant and speaks on Ant and other topics at +No Fluff, Just Stuff +symposiums as well as other venues. Erik is the President of +eHatcher Solutions, Inc. +

      + +

      + Diane Holt
      +

      + +

      + Donald Leslie
      +

      + +

      + Steve Loughran
      +

      + +

      + Conor MacNeill (conor at cortexebusiness.com.au) +
      +Conor is a senior developer at Cortex eBusiness, where he develops +J2EE based systems. In his spare time he helps with the development of +the Ant build tool. He is also serving as the Chairman of this PMC. +

      + +

      + Costin Monolache
      +

      + +

      + + Sam Ruby + + (rubys at us.ibm.com) +
      +Sam takes a perverse pleasure in integrating disparate things. He is +a member of the PHP group, Apache +XML PMC, Apache +sponsor for the xml-soap subproject +and convener of ECMA TC39 TG3. He is +also serving as the Chairman of the Jakarta PMC. +

      + +

      + Jon Skeet
      +

      + +

      + Magesh Umasankar (umagesh at apache.org) +
      +Magesh is a lead software developer at +Manugistics, where +he is responsible for some of the Revenue Optimization +solutions. +

      + +

      + Christoph Wilhelms (christoph.wilhelms at t-online.de) +
      +Christoph is teamleader and a lead software engineer at +IMPRESS SOFTWARE. He is resposible for +the development of administration tools and development environment for +the IMPRESS Engine, a Java-based intergration software. At the Ant-Project +he takes care of Antidote - the Ant GUI. +

      + +
      + + +

      + James Duncan Davidson (duncan at x180.net - http://x180.net/) +
      + +By day, Duncan works in the Open Source Program Office at Sun +Microsystems where he helps various Open Source efforts within Sun +"do the right thing". Previously at Sun he was responsible +for the Servlet API Specifications 2.1 and 2.2 as well as the Java API +for XML Parsing 1.0 and was the original author of Tomcat and Ant. He +was one of the rabble-rousers within Sun that helped make the Jakarta +Project a reality and served as the first Chairman of the Jakarta PMC. +

      + +
      + +
      +
      + + + +

      + Preston Bannister
      +

      + +

      + Nick Davis
      +

      + +

      + Darrell DeBoer
      +

      + +

      + Peter Donald (peter at apache.org) +
      + +Peter is an avid java developer who is active in the +Avalon and +Ant projects. +In his spare time he develops a distributed virtual environment +(ie military simulator or 3D game) using java technologies. +

      + +

      + Danno Ferrin (shemnon at yahoo.com) +
      +Danno has been programming in Java since Summer 96. Danno wrote a JSP +engine on his own and released it the very same day Jakarta was +announced at JavaOne. Since then, he decided to join the Jakarta +project in a spirit of co-operation over competition. +

      + +

      + + Jason Hunter (jh at servlets.com) +
      +Jason is author of "Java Servlet Programming" (O'Reilly) and publisher +of http://www.servlets.com/. +He works at CollabNet. +

      + +

      + Arun Jamwal +
      +

      + +

      + Arnout J. Kuiper (ajkuiper at planet.nl) +
      + +Arnout J. Kuiper is a Java Architect with the Sun Java Center at Sun +Microsystems. His main focus is web-related technologies on the Java +platform (J2EE, XML, ...). +

      + +

      + Adam Murdoch +
      +

      + +

      + Harish Prabhandham (harishp at onebox.com) +
      +Harish is an engineer with the J2EE team at Sun, primarily responsible +for implementing security in the J2EE Reference Implementation +(RI). He integrated various technologies including servlet/JSP +implementations from Tomcat into the J2EE RI. These days, he hacks PHP +code during the day. +

      + +

      + Nico Seessle
      +

      + +

      + Gal Shachor (shachor at il.ibm.com) +
      +Gal Shachor is a research staff member at IBM. He wrote his first +Servlet container (ServletExpress) at the beginning of 1997. Later on +ServletExpress (and Gal) merged into WebSphere, and Gal participated +in the development of WebSphere 1, 2 and 3. +

      + +

      + Jon S. Stevens (jon at collab.net) +
      + +Jon is a Co-Founder of Clear Ink +Corp and recently left to work on Scarab a next generation Open +Source Java Servlet based Issue/Bug tracking system for CollabNet. He is an active developer +of the Apache JServ Servlet +Engine for the Apache Web Server and Co-Author of the Element Construction Set as +well as the web application framework, Turbine. +

      + +

      + James Todd (jwtodd at pacbell.net) +
      +James has developed real time customer oriented apps for roughly 10 +years the last 5 of which have predominately been fully integrated, +front and back, extraNet implementations which have been based on +Apache, Java and Tcl. +

      + +

      + Anil Vijendran (akv at eng.sun.com) +
      +Anil Vijendran is the principal developer of the JSP engine in +Tomcat. He's done some pretty scary things in his past life -- +implementing the CORBA IDL to C++ 2.0 mapping, skydiving, IDL to Java +compilers, Object Databases (SIGSEV, you da man!) for C++, Java ORB +and EJB runtime environments -- in that order. +

      + +
      + +

      + Simeon H.K. Fitch (simeon.fitch at mseedsoft.com) +
      +Simeon is owner of Mustard Seed Software, which specializes in developing +distributed applications and user interfaces for the science, engineering, +and research oriented clients. He is the lead architect and developer for +Antidote, the GUI for Ant. +

      + +

      + Thomas Haas +
      +

      + +

      + Stefano Mazzocchi (stefano at apache.org) +
      +Stefano is addicted to software design, Java programming and +open development. In the last 4 years, he has contributed way too much +time to Apache, expecially on JServ, JMeter, Avalon, JAMES, Ant, Cocoon +and helping to bring more projects into Apache-land, such as FOP, Batik, +POI and Xindice. The problem is that he's too picky to be satisfied :-) +

      + +

      + Glenn McAllister (glenn at somanetworks.com) +
      +Glenn McAllister is a software developer at SOMA Networks, was formerly +the same at IBM (plus tech writer plus build guy), and does some writing +on the side for the VADD Technical Journal. +

      +
      +
      + + diff --git a/xdocs/cvs.xml b/xdocs/cvs.xml new file mode 100644 index 000000000..0f7d6fc54 --- /dev/null +++ b/xdocs/cvs.xml @@ -0,0 +1,41 @@ + + + + + CVS Repositories + + + + +
      + +

      Anyone can checkout source code from our anonymous CVS + server. To do so, simply use the following commands (if you are + using a GUI CVS client, configure it appropriatly):

      + + +cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
      +password: anoncvs + + +cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout [module-name] + +

      Modules available for access are (click the links to view the + CVS tree via ViewCVS):

      + + + +

      If you are not familiar with CVS, Jakarta's + CVS page may hold many helpful hints.

      +
      + +
      \ No newline at end of file diff --git a/xdocs/faq.xml b/xdocs/faq.xml index 0fa21556a..c4f6c98ac 100644 --- a/xdocs/faq.xml +++ b/xdocs/faq.xml @@ -12,7 +12,7 @@ document?

      The latest version can always be found at Ant's homepage - http://jakarta.apache.org/ant/faq.html.

      + http://ant.apache.org/faq.html.

      diff --git a/xdocs/guidelines.xml b/xdocs/guidelines.xml new file mode 100644 index 000000000..338d4d757 --- /dev/null +++ b/xdocs/guidelines.xml @@ -0,0 +1,23 @@ + + + + + Project Guidelines + + + + +
      + +

      We are still in the process of defining the guidelines for this + project - to get an idea what they may look like, we want to point + you to the guidelines of the Jakarta + and httpd + projects as well as the work currently on the way at the Incubator project.

      + +
      + +
      \ No newline at end of file diff --git a/xdocs/index.xml b/xdocs/index.xml index 9d48dd1e8..d2fd2e271 100644 --- a/xdocs/index.xml +++ b/xdocs/index.xml @@ -4,7 +4,7 @@ Conor MacNeill Stefan Bodewig - Ant + Welcome @@ -13,8 +13,8 @@

      Apache Ant 1.5.1 Released!

      Version 1.5.1 of Ant has been released. It is available for - download as binary or as source distribution.

      + download as binary or as source distribution.

      @@ -96,7 +96,7 @@ Comprehensive documentation is included in the source and binary distributions.
      • Get Involved
      • -
      • Join Mailing Lists
      • +
      • Join Mailing Lists
      • Search the Dev Mailing List
      • Search the User Mailing List diff --git a/xdocs/legal.xml b/xdocs/legal.xml new file mode 100644 index 000000000..44b8d19bc --- /dev/null +++ b/xdocs/legal.xml @@ -0,0 +1,30 @@ + + + + + Jon S. Stevens + Legal + + + + +
        + +

        All material on this website is Copyright © 1999-2002, + The Apache Software Foundation.

        + +

        Sun, Sun Microsystems, Solaris, Java, JavaServer Web + Development Kit, and JavaServer Pages are trademarks or + registered trademarks of Sun Microsystems, Inc. UNIX is a + registered trademark in the United States and other countries, + exclusively licensed through X/Open Company, Ltd. Windows, + WindowsNT, and Win32 are registered trademarks of Microsoft + Corp. All other product names mentioned herein and throughout + the entire web site are trademarks of their respective + owners.

        + +
        + + +
        + diff --git a/xdocs/license.xml b/xdocs/license.xml new file mode 100644 index 000000000..fb3189c77 --- /dev/null +++ b/xdocs/license.xml @@ -0,0 +1,65 @@ + + + + + License + + + + +
        + + /* + * ============================================================================ + * The Apache Software License, Version 1.1 + * ============================================================================ + * + * Copyright (C) 2000-2003 The Apache Software Foundation. All + * rights reserved. + * + * Redistribution and use in source and binary forms, with or without modifica- + * tion, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. The end-user documentation included with the redistribution, if any, must + * include the following acknowledgment: "This product includes software + * developed by the Apache Software Foundation (http://www.apache.org/)." + * Alternately, this acknowledgment may appear in the software itself, if + * and wherever such third-party acknowledgments normally appear. + * + * 4. The names "Ant" and "Apache Software Foundation" must not be used to + * endorse or promote products derived from this software without prior + * written permission. For written permission, please contact + * apache@apache.org. + * + * 5. Products derived from this software may not be called "Apache", nor may + * "Apache" appear in their name, without prior written permission of the + * Apache Software Foundation. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- + * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * This software consists of voluntary contributions made by many individuals + * on behalf of the Apache Software Foundation. For more information on the + * Apache Software Foundation, please see <http://www.apache.org/>. + * + */ + +

        You can download the original license file here

        . +
        + +
        \ No newline at end of file diff --git a/xdocs/mail.xml b/xdocs/mail.xml new file mode 100644 index 000000000..59bb04eaa --- /dev/null +++ b/xdocs/mail.xml @@ -0,0 +1,55 @@ + + + + + Mailing Lists + + + + +
        + +

        Please read the guidelines of + the Jakarta Project before subscribing and posting to any of + the lists below. They apply to Ant's lists as well.

        + +

        The user and dev list are subscriber only lists, this means + you have to subscribe before you can post to the list. These + lists are archived at

        + + + + +

        + Medium Traffic + Subscribe + Unsubscribe + Archive +

        + +

        This list is for developers that are using Ant in their own + projects to ask questions, share knowledge, and discuss issues + related to using Ant as a build tool.

        +
        + + +

        + High Traffic + Subscribe + Unsubscribe + Archive +

        + +

        This is the list where participating developers of the Ant + build tool meet and discuss issues, code changes/additions, + etc. Subscribers to this list get notices of each and every + code change, build results, testing notices, etc.

        +
        +
        + + +
        \ No newline at end of file diff --git a/xdocs/mission.xml b/xdocs/mission.xml new file mode 100644 index 000000000..24a693748 --- /dev/null +++ b/xdocs/mission.xml @@ -0,0 +1,83 @@ + + + + + Apache Ant Mission + + + +
        + +

        Apache Ant is a project of the Apache Software Foundation. It + started as a subproject of the Apache Jakarta Project.

        + +

        This is the board resolution (from the minutes) + that created the Apache Ant project:

        + + +7.D. Resolution [R3] to create the Ant PMC + +WHEREAS, the Board of Directors deems it to be in the best +interests of the Foundation and consistent with the +Foundation's purpose to establish a Project Management +Committee charged with the creation and maintenance of +open-source software related to the Apache Ant build tool, for +distribution at no charge to the public. + +NOW, THEREFORE, BE IT RESOLVED, that a Project Management +Committee (PMC), to be known as the "Apache Ant PMC", be and +hereby is established pursuant to Bylaws of the Foundation; and +be it further + +RESOLVED, that the Apache Ant PMC be and hereby is responsible +for the creation and maintenance of the Ant build system and +related software components, based on software licensed to the +Foundation; and be it further + +RESOLVED, that the office of "Vice President, Apache Ant" be +and hereby is created, the person holding such office to serve +at the direction of the Board of Directors as the chair of the +Apache Ant PMC, and to have primary responsibility for +management of the projects within the scope of responsibility +of the Apache Ant PMC; and be it further + +RESOLVED, that the persons listed immediately below be and +hereby are appointed to serve as the initial members of the +Apache Ant PMC: + + Bruce Atherton + Stefane Bailliez + Stefan Bodewig + Erik Hatcher + Diane Holt + Donald Leslie + Steve Loughran + Conor MacNeill + Costin Manolache + Sam Ruby + Jon Skeet + Magesh Umasankar + Christoph Wilhelms + +NOW, THEREFORE, BE IT FURTHER RESOLVED, that Conor MacNeill be +and hereby is appointed to the office of Vice President, Apache +Ant, to serve in accordance with and subject to the direction +of the Board of Directors and the Bylaws of the Foundation +until death, resignation, retirement, removal or +disqualification, or until a successor is appointed; and be it +further + +RESOLVED, that the initial Apache Ant PMC be and hereby is +tasked with the creation of a set of bylaws intended to +encourage open development and increased participation in the +Apache Ant Project. + +By Unanimous Vote, Resolution R3 was approved. The Ant PMC is +hereby created. + + +
        + +
        \ No newline at end of file diff --git a/xdocs/problems.xml b/xdocs/problems.xml index cba339406..fe37facd2 100644 --- a/xdocs/problems.xml +++ b/xdocs/problems.xml @@ -131,7 +131,7 @@ D:\src\java\Unset.java

        of Ant to see if the problem has been fixed. Nightly builds for Ant are available from the - Jakarta web site. While Ant nightly builds are typically quite + Ant web site. While Ant nightly builds are typically quite stable and are used by Gump to build many other Jakarta projects, these builds should @@ -227,7 +227,7 @@ D:\src\java\Unset.java

        try to find the cause of the problem and provide a fix yourself. The best way to do that is by working with the latest code from CVS. Alternatively, you can work with the source code available from the - + source distributions. If you are going to tackle the problem at this level, you may want to discuss some details first on the ant-dev diff --git a/xdocs/resources.xml b/xdocs/resources.xml index e06ab6437..70c346376 100644 --- a/xdocs/resources.xml +++ b/xdocs/resources.xml @@ -17,7 +17,7 @@ - +
        FAQ:http://jakarta.apache.org/ant/faq.htmlhttp://ant.apache.org/faq.html
        @@ -96,11 +96,11 @@ 1.4. This is the original description:

        - Ant kurz & gut enth�lt eine vollst�ndige Referenz der Built-in Tasks - und ihrer jeweiligen Attribute sowie kurze Beispiele f�r ihre Verwendung. - Daneben bietet das Buch eine knappe Einf�hrung in die Arbeit mit Ant und - eine Erl�uterung der Ant-Basiselemente (Projekte, Properties, Targets und Tasks). - Behandelt werden au�erdem grundlegende Konzepte wie Filesets, Patternsets und + Ant kurz & gut enthält eine vollständige Referenz der Built-in Tasks + und ihrer jeweiligen Attribute sowie kurze Beispiele für ihre Verwendung. + Daneben bietet das Buch eine knappe Einführung in die Arbeit mit Ant und + eine Erläuterung der Ant-Basiselemente (Projekte, Properties, Targets und Tasks). + Behandelt werden außerdem grundlegende Konzepte wie Filesets, Patternsets und Pfadstrukturen, das Schreiben eigener Tasks, die Aufruf-Syntax und Optional Tasks. @@ -160,7 +160,7 @@ - +
        URL:http://jakarta.apache.org/ant/ant_in_anger.htmlhttp://ant.apache.org/ant_in_anger.html
        @@ -176,7 +176,7 @@ URL: - http://jakarta.apache.org/ant/ant_task_guidelines.html + http://ant.apache.org/ant_task_guidelines.html diff --git a/xdocs/stylesheets/faq.vsl b/xdocs/stylesheets/faq.vsl deleted file mode 100644 index e7f22e443..000000000 --- a/xdocs/stylesheets/faq.vsl +++ /dev/null @@ -1,117 +0,0 @@ - - - - - ## Defined variables - #set ($bodybg = "#ffffff") - #set ($bodyfg = "#000000") - #set ($bodylink = "#525D76") - #set ($bannerbg = "#525D76") - #set ($bannerfg = "#ffffff") - #set ($subbannerbg = "#828DA6") - #set ($subbannerfg = "#ffffff") - #set ($tablethbg = "#039acc") - #set ($tabletdbg = "#a0ddf0") - #set ($pound = "#" ) - - -#faqs() - - -## This is where the FAQ specific macro's live - -#macro (toc $section) - - - -
        - - $section.getAttributeValue("title") - -
        -
        -
          - #foreach ($faq in $section.getChildren("faq") ) - #subtoc ($faq) - #end -
        -
        -
        -#end - -#macro (subtoc $faq) - #set ($id = $faq.getAttributeValue("id")) -
      • - $xmlout.outputString($faq.getChild("question"), true) -
      • -#end - -#macro (answers $section) - #foreach ($faq in $section.getChildren("faq") ) - #faq ($faq) - #end -#end - -#macro (faq $faq) - #set ($id = $faq.getAttributeValue("id")) -   - - - -
        - - - $xmlout.outputString($faq.getChild("question"), true) - - -
        -
        - #foreach ($item in $faq.getChild("answer").getChildren()) - #if ($item.getName().equals("img")) - #image ($item) - #elseif ($item.getName().equals("source")) - #source ($item) - #elseif ($item.getName().equals("table")) - #table ($item) - #else - $xmlout.outputString($item) - #end - #end -
        -
        -#end - -#macro (faqs) - #header() - - - -
        - - Questions - -
        -
        - #set ($allFaqSections = $root.getChildren("faqsection")) - #foreach ( $faqSection in $allFaqSections ) - #toc ($faqSection) - #end -
        -
        - - - - -
        - - Answers - -
        -
        - #foreach ( $faqSection in $allFaqSections ) - #answers ($faqSection) - #end -
        -
        - #footer() -#end diff --git a/xdocs/stylesheets/project.xml b/xdocs/stylesheets/project.xml index 60db26758..316611c70 100644 --- a/xdocs/stylesheets/project.xml +++ b/xdocs/stylesheets/project.xml @@ -1,17 +1,18 @@ - + Apache Ant Apache Ant - - - + + + + + + @@ -19,31 +20,30 @@ href="/external.html"/> - - - - - - - - - - + + - - - - + + - + + + + + + + + + diff --git a/xdocs/stylesheets/site.vsl b/xdocs/stylesheets/site.vsl index b2ff8e525..17cc57301 100644 --- a/xdocs/stylesheets/site.vsl +++ b/xdocs/stylesheets/site.vsl @@ -1,33 +1,81 @@ - - - +#* + * ============================================================================ + * The Apache Software License, Version 1.1 + * ============================================================================ + * + * Copyright (C) 2000-2003 The Apache Software Foundation. All + * rights reserved. + * + * Redistribution and use in source and binary forms, with or without modifica- + * tion, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. The end-user documentation included with the redistribution, if any, must + * include the following acknowledgment: "This product includes software + * developed by the Apache Software Foundation (http://www.apache.org/)." + * Alternately, this acknowledgment may appear in the software itself, if + * and wherever such third-party acknowledgments normally appear. + * + * 4. The names "Ant" and "Apache Software Foundation" must not be used to + * endorse or promote products derived from this software without prior + * written permission. For written permission, please contact + * apache@apache.org. + * + * 5. Products derived from this software may not be called "Apache", nor may + * "Apache" appear in their name, without prior written permission of the + * Apache Software Foundation. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- + * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * This software consists of voluntary contributions made by many individuals + * on behalf of the Apache Software Foundation. For more information on the + * Apache Software Foundation, please see . + * + *# + +## Content Stylesheet for Site ## Defined variables - #set ($bodybg = "#ffffff") - #set ($bodyfg = "#000000") - #set ($bodylink = "#525D76") - #set ($bannerbg = "#525D76") - #set ($bannerfg = "#ffffff") - #set ($subbannerbg = "#828DA6") - #set ($subbannerfg = "#ffffff") - #set ($tablethbg = "#039acc") - #set ($tabletdbg = "#a0ddf0") - - + #set ($lightbg = "#ffffff") + #set ($lightfg = "#ffffff") + #set ($darkfg = "#000000") + #set ($active = "#ffcc00") + #set ($blue3 = "#294563") + #set ($blue2 = "#4C6C8F") + #set ($blue1 = "#CFDCED") + #set ($sourceborder = "#023264") + #set ($pound = "#" ) +## start the processing #document() - +## end the processing ## This is where the common page macro's live #macro ( subsection $subsection) - - - -
        - - $subsection.getAttributeValue("name") - -
        -
        +
        + + + +
        + + $subsection.getAttributeValue("name") + +
        #foreach ( $items in $subsection.getChildren() ) #if ($items.getName().equals("img")) #image ($items) @@ -39,20 +87,13 @@ $xmlout.outputString($items) #end #end -
        -
        #end #macro ( section $section) - - - -
        - - $section.getAttributeValue("name") - -
        -
        +
        + + +
        $section.getAttributeValue("name")
        #foreach ( $items in $section.getChildren() ) #if ($items.getName().equals("img")) #image ($items) @@ -66,16 +107,103 @@ $xmlout.outputString($items) #end #end -
        -
        +#end + +## This is where the FAQ specific macro's live + +#macro (toc $section) +
        + + +
        + + $section.getAttributeValue("title") + +
        +
          + #foreach ($faq in $section.getChildren("faq") ) + #subtoc ($faq) + #end +
        +#end + +#macro (subtoc $faq) + #set ($id = $faq.getAttributeValue("id")) +
      • + $xmlout.outputString($faq.getChild("question"), true) +
      • +#end + +#macro (answers $section) + #foreach ($faq in $section.getChildren("faq") ) + #faq ($faq) + #end +#end + +#macro (faq $faq) + #set ($id = $faq.getAttributeValue("id")) +
        + + + +
        + + + $xmlout.outputString($faq.getChild("question"), true) + + +
        + #foreach ($item in $faq.getChild("answer").getChildren()) + #if ($item.getName().equals("img")) + #image ($item) + #elseif ($item.getName().equals("source")) + #source ($item) + #elseif ($item.getName().equals("table")) + #table ($item) + #else + $xmlout.outputString($item) + #end + #end #end #macro (document) #header() + + + + +
        +

        $root.getChild("properties").getChild("title").getText()

        +
        #set ($allSections = $root.getChild("body").getChildren("section")) #foreach ( $section in $allSections ) #section ($section) #end + + #if ($root.getChildren("faqsection").size() > 0) + #set ($allFaqSections = $root.getChildren("faqsection")) + + +
        + + Questions + +
        + #foreach ( $faqSection in $allFaqSections ) + #toc ($faqSection) + #end + + + +
        + + Answers + +
        + #foreach ( $faqSection in $allFaqSections ) + #answers ($faqSection) + #end + #end + #footer() #end diff --git a/xdocs/stylesheets/templates.vm b/xdocs/stylesheets/templates.vm index f00e65ef8..52b3baa71 100644 --- a/xdocs/stylesheets/templates.vm +++ b/xdocs/stylesheets/templates.vm @@ -1,7 +1,57 @@ +#* + * ============================================================================ + * The Apache Software License, Version 1.1 + * ============================================================================ + * + * Copyright (C) 2000-2003 The Apache Software Foundation. All + * rights reserved. + * + * Redistribution and use in source and binary forms, with or without modifica- + * tion, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. The end-user documentation included with the redistribution, if any, must + * include the following acknowledgment: "This product includes software + * developed by the Apache Software Foundation (http://www.apache.org/)." + * Alternately, this acknowledgment may appear in the software itself, if + * and wherever such third-party acknowledgments normally appear. + * + * 4. The names "Ant" and "Apache Software Foundation" must not be used to + * endorse or promote products derived from this software without prior + * written permission. For written permission, please contact + * apache@apache.org. + * + * 5. Products derived from this software may not be called "Apache", nor may + * "Apache" appear in their name, without prior written permission of the + * Apache Software Foundation. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND + * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU- + * DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * This software consists of voluntary contributions made by many individuals + * on behalf of the Apache Software Foundation. For more information on the + * Apache Software Foundation, please see . + * + *# + ## This is where the common macro's live #macro ( table $table) - +
        #foreach ( $items in $table.getChildren() ) #if ($items.getName().equals("tr")) #tr ($items) @@ -33,15 +83,13 @@ #else #set ($rowspan = 1) #end - #end @@ -56,16 +104,14 @@ #else #set ($rowspan = 1) #end - + #end #macro ( projectanchor $name $value ) @@ -96,121 +142,171 @@ #if ($value.getAttributeValue("alt")) #set ($align=$value.getAttributeValue("alt")) #end - $!align + $!alt #end #macro ( source $value) -
        -
        - #if ($value.getText().length() != 0 || $value.hasChildren()) $xmlout.outputString($value, true) #else   #end - - #if ($value.getText().length() != 0 || $value.hasChildren()) $xmlout.outputString($value, true) #else   #end - -
        - - - - - - - - - - - - - - - -
        $escape.getText($value.getText())
        - +
        $escape.getText($value.getText())
        #end #macro ( makeProject ) #set ($menus = $project.getChild("body").getChildren("menu")) + #end #macro (header) - - - #set ($authors = $root.getChild("properties").getChildren("author")) - #foreach ( $au in $authors ) - #metaauthor ( $au.getText() $au.getAttributeValue("email") ) - #end - - #if ($root.getChild("properties").getChild("base")) - #set ($url = $root.getChild("properties").getChild("base").getAttributeValue("href")) - #if ($url) - - #else - - #end - #end - - $project.getChild("title").getText() - $root.getChild("properties").getChild("title").getText() + + $project.getChild("title").getText() - $root.getChild("properties").getChild("title").getText() + + #set ($authors = $root.getChild("properties").getChildren("author")) + #foreach ( $au in $authors ) + #metaauthor ( $au.getText() $au.getAttributeValue("email") ) + #end - - - - + + +
        - #getProjectImage() + + + +
        - - - + +
        -
        -
        - - - + + + + + + + +
        - #makeProject() - + Apache Ant siteApache Ant logo +
        + + + + + + + + + + +
        +
        + + the Apache Ant site + + +
        +
        +
        +
        + + + + + +
        + + + + +
        Home
        +
        +
        +
        + + + - - - - +
        + + + + + + + + + + +
        + + + + + + + + + + +
         
        +
        + #makeProject() +
        +
        + + + + + + + + + + + + + +
        +   + +   +
        +
        #end #macro (footer) +
        +
        -
        -
        -
        - Copyright © 2000-2003, Apache Software Foundation -
        -
        + + + + + + +