Merge branch 'idea90' of git.labs.intellij.net:idea/community into idea90
[fedora-idea.git] / lib / ant / WHATSNEW
blob5afe7732ac21668de90d8ec1cfd32a515890859c
1 Changes from Ant 1.7.0 TO current Ant 1.7.1 version
2 =============================================
4 Changes that could break older environments:
5 -------------------------------------------
7 * String resources only have properties single expanded. If you relied on
8   <string> resources being expanded more than once, it no longer happens.
9   Bugzilla report 42277.
11 * A String resource's encoding attribute was only taken into account when
12   set from the resource's OutputStream; the InputStream provided the String's
13   binary content according to the platform's default encoding. Behavior has
14   been modified to encode outgoing (InputStream) content as well as encoding
15   incoming (OutputStream) content.
17 * <java> with fork now returns gives -1 instead of 0 as result when failonerror
18   is false and some exception (including timeout) occurs. Br 42377. 
20 * ant-type attribute has been marked as deprecated and a warning has been
21   issued if it is encountered in the build file.
22   
23 * FileUtils.createTempFile now actually creates the file.
24   The TempFile task still does not create the file by default, can be instructed
25   to do so however using a new parameter.
26   Bugzilla report 33969.
28 Fixed bugs:
29 -----------
31 * The default logger was failing to print complete stack traces for exceptions
32   other than BuildException, thus omitting often important diagnostic
33   information. Bugzilla 43398.
35 * Error in FTP task
36   Bugzilla report 41724
38 * Regression: Locator fails with URI encoding problem when spaces in path
39   Bugzilla report 42222
41 * Regression in Locator: running Ant off a network share does not work:
42   message "URI has authority component" appears
43   Bugzilla report 42275
45 * Improvements in AntClassLoader Speed.
46   Bugzilla report 42259
48 * Error in handling of some permissions, most notably the AllPermission on
49   jdk 1.5
50   Bugzilla report 41776
52 * Replace task summary output incorrect.
53   Bugzilla report 41544
55 * Dependset crashes ant when timestamp on files change during Dependset
56   execution.
57   Bugzilla report 41284
59 * Bug in org.apache.tools.ant.types.resources.comparators.Date
60   Bugzilla report 41411
62 * <junit> in Ant 1.7.0 could throw NPE if no <classpath> was defined.
63   Bugzilla report 41422.
65 * In Ant 1.7.0, <fileset> in <javadoc> does not by default include only
66   **/*.java as the documentation claims and earlier revisions did.
67   Bugzilla report 41264.
69 * SPI support in jar was broken.
70   Bugzilla report 41201.
71   
72 * jsch-0.1.30 causes SCP task to hang
73   Bugzilla report 41090.
75 * Target from imported file listed twice in projecthelp.
76   Bugzilla report 41226.
78 * <sql> task double-expands properties if expandproperties is true,
79   and expands properties if expandproperties is false.
80   Bugzilla report 41204.
82 * Rolling back Bugzilla 32927 (set a default description for a javadoc tag
83   if not set) as it caused a BC problem.
84   Bugzilla report 41268.
86 * <apt> forks properly and so memory settings are picked up.
87   Bug report 41280.
89 * Regression: NPE was thrown when using <pathconvert> against a
90   (third-party instantiated) fileset with null Project reference.
92 * Strip out all -J arguments to non forking rmic adapters, specifically
93   the Sun and Weblogic compilers.
94   Bug report 41349
96 * Synchonization issues in PropertyHelper.  Bugzilla 41353.
98 * <concat binary="true" append="true"> did not append.  Bugzilla 41399.
100 * -autoproxy turns Java1.5+ automatic proxy support on. Bugzilla 41904
102 * Handle null result of system getProperty(). Bugzilla 42334.
104 * Regression: concat fixlastline="true" should not have applied to
105   nested text, but did in Ant 1.7.0. Bugzilla 42369.
107 * Regression: ant.version was not passed down in <ant>, <subant>.
108   This worked in Ant 1.6.5, but not in 1.7.0.
109   ant.core.lib (added in 1.7.0) was also not being propagated.
110   Bugzilla bug 42263
112 * Regression: bzip2 task created corrupted output files for some inputs.
113   Bugzilla bug 41596.
115 * Regression: <available> with <filepath> did not work.
116   Bugzilla 42735.
118 * ant script, cd may output to stdout.
119   Bugzilla 42739.
121 * Modified selector doesn't update the cache if only one file has changed.
122   Bugzilla 42802.
124 * Regression: Path subclasses that overrode list() stopped working in
125   resourceCollection contexts in Ant 1.7.0. Bugzilla 42967.
127 * War task failed with "No WEB-INF/web.xml file was added" when called
128   a second time. Bugzilla 43121.
130 * FilterMapper could throw an NPE.
131   Bugzilla 43292.
133 * Regession nested macrodefs with elements could cause StackOverFlow.
134   Bugzilla 43324.
136 * <touch> task couldn't differentiate between "no resources specified" and "no resources
137   matched." Bugzilla report 43799.
139 * Some changes to <junit> broke third party tasks that extend it (like
140   Apache Cactus' Ant task).  The changes have been modified so that
141   subclases should now work again - without any changes to the
142   subclass.
144 Other changes:
145 --------------
147 * Various small optimizations speed up common tasks such as <javac> on large
148   filesets, reducing both I/O and CPU usage.
150 * Profiling logger has been added with basic profiling capabilities.
152 * <script> now has basic support for JavaFX scripts
154 * SSH task can now take a command parameter containing the commands to execute.
155   This allows you to connect to a server and execute a number of commands
156   without constantly reconnecting for each command.
158 * Upgraded XML API to XML commons version 1.3.04.
160 * Upgraded to Xerces 2.9.0
162 * <script> can now work with bsf.jar and js.jar in its <classpath>.
164 * add errorProperty and updatedProperty to <javac>
165   Bugzilla 35637 and 28941.
167 * add classpathref attribute to <whichresource>
168   Bugzilla 41158.
170 * reduce logging noise of <apply skipemptyfilesets="true">
171   Bugzilla 29154
173 * Show Previous Revision in the tagdiff.xsl stylesheet
174   Bugzilla 29143
176 * Allow <mapper refid> to refer directly to a FileNameMapper instance.
178 * If you try and use a type in a namespace (or an antlib), and the type is not
179   recognized but there are other definitions in that namespace, Ant lists what
180   the known definitions are. This helps you find spelling errors.
182 * Add a <last> resource collection, corresponding to <first>.
184 * Add new <truncate> task.
186 * <junitreport> xsl stylesheets allow setting the title used in <title> and <h1> tags by
187   using <report><param> element.  Bugzilla 41742.
189 * Add IgnoreDependenciesExecutor for weird cases when the user wants to run
190   only the targets explicitly specified.
192 * Patternset allows nested inverted patternsets using <invert>.
194 * <manifest> checks for validity of attribute names.
196 * JUnitVersionHelper.getTestCaseClassName is now public. Bugzilla 42231
198 * <string> resource supports nested text. Bugzilla bug 42276
200 * <scriptdef> now sources scripts from nested resources/resource collections. This lets you
201   define scripts in JARs, remote URLs, or any other supported resource. Bugzilla report 41597.
203 * <concat> is now usable as a single-element ResourceCollection.
205 * It is now possible to provide the value of a <striplinecomments> filter's
206   <comment> nested element as nested text instead of using the 'value'
207   attribute.
209 * A new logger, BigProjectLogger, lists the project name with every target   
211 * Default text added to macrodef. Bugzilla report 42301.
213 * "rawblobs" attribute added to SQL task.
215 * Add new retry task container.
217 * <jar> has a new strict attribute that checks if the jar complies with
218   the jar packaging version specification.
220 * <javac> has a new attribute - includeDestClasses.
221   Bugzilla 40776.
223 * <fileset> has a new attribute - errorOnMissingDir.
224   Bugzilla 11270.
226 * <javac> handles package-info.java files, there were repeatedly compiled.
227   Bugzilla 43114.
229 Changes from Ant 1.6.5 to Ant 1.7.0
230 ===================================
232 Changes that could break older environments:
233 -------------------------------------------
235 * Initial support for JDK 6 (JSR 223) scripting.
236   <*script*> tasks will now use javax.scripting if BSF is
237   not available, or if explicitly requested by using
238   a "manager" attribute.
240 * Removed launcher classes from nodeps jar.
242 * <classconstants> filter reader uses ISO-8859-1 encoding to read
243   the java class file. Bugzilla report 33604.
245 * Defer reference process. Bugzilla 36955, 34458, 37688.
246   This may break build files in which a reference was set in a target which was
247   never executed. Historically, Ant would set the reference early on, during parse
248   time, so the datatype would be defined. Now it requires the reference to have
249   been in a bit of the build file which was actually executed. If you get
250   an error about an undefined reference, locate the reference and move it somewhere
251   where it is used, or fix the depends attribute of the target in question to
252   depend on the target which defines the reference/datatype.
253   As a result of testing on real live build scripts, a fall-back mechanism
254   was put it place to allow references taht are out-of-band to be resolved. If
255   this happens a big warning message is logged. This fall-back mechanism will
256   be removed in Ant 1.8.0.
258 * <script> and <scriptdef> now set the current thread context.
260 * Unrestrict the dbvendor names in the websphere element of the ejbjar task.
261   Bugzilla Report 40475.
263 * <env> nested element in <java>, <exec> and others is now case-insensitive
264   for windows OS. Bugzilla Report 28874.
266 * Removed support for xalan1 completely. Users of Xalan1 for Ant builds will
267   have to stay at ant 1.6.5 or upgrade to xalan2.
269 * Use org.apache.log4j.Logger instead of org.apache.log4j.Category.
270   Category has been deprecated for ~2 years and has been removed from
271   the log4j code.  Logger was introduced in log4j 1.2 so users of
272   log4j 1.1 and log4j 1.0 need to upgrade to a newer version of log4j.
273   Bugzilla Report 31951.
275 * build.sysclasspath now also affects the bootclasspath handling of
276   spawned Java VMs.  If you set build.sysclasspath to anything other
277   than "ignore" (or leave it unset, since "ignore" is the default when
278   it comes to bootclasspath handling), then the bootclasspath of the
279   VM running Ant will be added to the bootclasspath you've specified.
281 * The <java fork="false"> now as per default installs a security manager
282   using the default permissions. This is now independent of the
283   failonerror attribute.  Bugzilla report 33361.
285 * <signjar> now notices when the jar and signedjar are equal, and switches
286   to the same dependency logic as when signedjar is omitted. This may break
287   something that depended upon signing in this situation. However, since
288   invoking the JDK jarsigner program with -signedjar set to the source jar
289   actually crashes the JVM on our (Java1.5) systems, we don't think any
290   build files which actually worked will be affected by the change.
292 * <signjar> used to ignore a nested fileset when a jar was also provided as an
293   attribute, printing a warning message; now it signs files in the fileset.
295 * An improved method of handling timestamp granularity differences between
296   client and server was added to the <ftp> task.  FTP servers typically
297   have HH:mm timestamps whereas local filesystems have HH:mm:ss timestamps.
298   Previously, this required tweaking with the timediffmillis attribute
299   which also was used to handle timezone differences.  Now, there is a new
300   timestampgranularity attribute.  The default value for get operations is 0
301   since the user has the more powerful preservelastmodified attribute to work
302   with.  Since this is not available on put operations the default value
303   adds a minute to the server timestamp in order to account for this,
304   Scripts which previously used timediffmillis to do this compensation may
305   need to be rewritten.  timediffmillis has now been deprecated.
307 * Support for the XSL:P XML parser has been removed.
308   Bugzilla Report 23455.
310 * Visual Age for Java optional tasks removed as the required library is no
311   longer available.
313 * Testlet (test) optional task removed as the required library is no
314   longer available.
316 * IContract optional task removed as the required library is no
317   longer available.
319 * Metamata (maudit, mmetrics, and mparse tasks) removed as the required 
320   library is no longer available.
322 * Sitraka (jpcoverage, jpcovmerge, jpcovreport) tasks suppressed as the 
323   required library is no longer available.
325 * <fixcrlf> used \r (Mac) line endings on OS X, whose proper line separator
326   is \n (Unix).  Bugzilla report 39585.
328 * <scp> now optionally supports the sftp protocol, you may need a
329   newer jsch.jar.  Bugzilla Report 39373.
331 * Ant launcher program prints errors to stderr, and exits with a 2 exit code
332   value if, for any reason, it cannot actually start Ant proper. This will only
333   affect programs/scripts that called the launcher and which did not want to
334   receive an error if Ant itself would not start
336 * All .NET tasks are now deprecated in favor of the new .NET Antlib:
337   http://ant.apache.org/antlibs/dotnet/index.html
339 Fixed bugs:
340 -----------
341 * Directory deletion did not work properly.
342   Bugzilla 40972.
344 * docletpath attribute of javadoc was ignored.
345   Bugzilla 40900.
347 * Fixed incorrect recursion in DOMUtil.listChildNodes().
348   Bugzilla 40918.
350 * CompressedResource.compareTo() did not
351   take comparison with another CompressedResource into account.
352   Bugzilla 40949.
354 * Avoid possible NPE in Jar.java.
355   Bugzilla 40847.
357 * regression in attribute prefix (+ others) for refid in zipfileset and tarfileset.
358   Bugzilla 41004, 30498.
360 * dependset failed if the basedir of a target fileset did not exist.
361   Bugzilla 40916.
363 * Recursive filtering encountered NullPointerExceptions under certain
364   circumstances.  Bugzilla 41086.
366 * XmlProperty overrides previously set property value when handling duplicate
367   elements. Bugzilla 41080.
369 * Having many tasks causes OOM.  Bugzilla 41049.
371 * Regression: <path> was evaluating nested content only once, so that it could
372   not e.g. pick up files that didn't exist the first time through.
373   Bugzilla 41151.
375 * OOM caused by IH holding on to classes and thus their classloaders.
376   Bugzilla 28283 and 33061.
378 * <delete> doesnt delete when defaultexcludes="false" and no includes is set
379   fixed. Bugzilla 40313.
381 * Behavior change of DirectoryScanner/AbstractFileset when conditional include
382   patterns are used. Bugzilla 40722.
384 * <javac> fails with NPE when compiling with eclipse ecj 3.1.x.
385   Bugzilla 40839.
387 * JUnitTestRunner had a NPE when unable to create parser, the exception
388   containing the error did not get reported. Bugzilla 36733.
390 * <checksum> with file and todir option failed. Bugzilla report 37386.
392 * <path location="loc"> was broken (Regression from beta1).
393   Bugzilla report 40547.
395 * Nested fileset in <cab> did not work. Bugzilla report 39439.
397 * The ant wrapper script should now correctly locate the java
398   executable in more recent IBM JDKs for AIX as well.
400 * URLResource did not close jar files, and also did not disconnect HTTPConnection (s).
402 * Error calling junitreport. Bugzilla 40595.
404 * <junittask/> created junitvmwatcher*.properties files but did not close and delete them.
406 * <xmlproperty> did not create properties for empty leaf elements.
407   Bugzilla report 26286.
409 * UnknownElement.maybeConfigure always configured.
410   Bugzilla report 40641.
412 * No check for refid when prefix attribute is set in zipfileset.
413   Bugzilla report 30498.
415 * Fix for junit4 issue introduced since beta2.
416   Bugzilla report 40682.
418 * Error in duplicate project name with <import> and <antcall>.
419   Bugzilla report 39920.
421 * junit4 did not work with fork=no and junit4 in $ANT_HOME/lib.
422   Bugzilla report 40697.
424 * PathConvert on Windows should process forward and back slashes equivalently.
425   Bugzilla report 32884.
427 * ant.bat now looks in %USERPROFILE% and %HOMEDRIVE%%HOMEPATH% in addition to
428   %HOME% for pre/post batch files. Bugzilla report 39298.
430 * The inheritance hierarchy of the legacy <path> type was changed; code built
431   against Ant 1.7 would therefore no longer execute on older versions of Ant.
432   Since <path> is historically heavily used this was undesirable, and since it
433   is also avoidable, the change to <path>'s taxonomy was reverted.
435 * <zip filesonly="true"> included empty directories.  Bugzilla report 40258.
437 * Invalid hash code of Target causes XmlLogger to fail.
438   Bugzilla report 40207.
440 * Macro element did not include top level Text. Bugzilla report 36803.
442 * AntClassLoader did not isolate resources when isolate was set. Bugzilla report 38747.
444 * Diagnostics broken when using java 1.4. Bugzilla report 40395.
446 * Exception reporting in <copy> was broken. Bugzilla report 40300.
448 * Handling of corrupt tar files, TarInputStream.read() never returns EOF.
449   Bugzilla report 39924.
451 * Some bugs in ReaderInputStream. Bugzilla report 39635.
453 * <antlr> did not recognise whether the target is up-to-date for html option.
454   Bugzilla report 38451.
456 * Documented minimal version of jsch now 0.1.29.
457   Bugzilla report 40333.
459 * <available> searched parent directories for files.
460   Bugzilla report 37148.
462 * The build could be halted if a file path contained more ".." components than
463   the actual depth of the preceding path. Now such paths are left
464   alone (meaning they will likely be treated as nonexistent
465   files). Bugzilla Report 40281.
467 * Converting a <dirset> to a string was broken. Bugzilla Report 39683.
469 * Manifests have improved line length handling, taking care of encoding.
470   Bug reports 37548 / 34425.
472 * <manifest> now closes the inputstream explicitly. Bug report 39628.
474 * <rpm> now also correctly searches the first element of the path.
475   Bug report 39345.
477 * ant.bat now handles classpath set to "". Bug report 38914.
479 * <junit> now supports JUnit 4. Bugzilla Report 38811.
481 * <junit> can now work with junit.jar in its <classpath>. Bugzilla
482   Report 38799.
484 * Some potential NullPointerExceptions, Bugzilla Reports 37765 and 38056.
486 * Problem when adding multiple filter files, Bugzilla Report 37341.
488 * Problem referencing jars specified by Class-Path attribute in manifest
489   of a ant task jar file, when this ant task jar file is located in
490   a directory with space, Bugzilla Report 37085.
492 * Backward incompatible change in ZipFileSet, Bugzilla Report 35824.
494 * Wrong replacement of file separator chars prevens junitbatchtest
495   from running correctly on files from a zipfileset. Bugzilla Report 35499.
497 * Calling close twice on ReaderInputStream gave a nullpointer exception.
498   Bugzilla Report 35544.
500 * Memory leak from IntrospectionHelper.getHelper(Class) in embedded
501   environments. Bugzilla Report 30162.
503 * Translate task does not remove tokens when a key is not found.
504   It logs a verbose message.  Bugzilla Report 13936.
506 * Incorrect task name with invalid "javac" task after a "presetdef".
507   Bugzilla reports 31389 and 29499.
509 * <manifest> was not printing warnings about invalid manifest elements.
510   Bugzilla report 32190.
512 * <replace> got out of memory on large files (part of report 32566).
513   <replace> can now handle files as long as there is enough disk space
514   available.
516 * Commandline.describeCommand() methods would attempt to describe
517   arguments even when none, other than the executable name, were present.
519 * Create signjar's helper ExecTask instance directly rather than by
520   typedef discovery mechanisms. Bugzilla report 33433.
522 * FileUtils.resolveFile() promised to return absolute files but
523   did not always do so.
525 * <ftp> failed to retrieve a file when the path towards the file contained
526   an element starting with . Bugzilla report 33770.
528 * "<rmic> always compiles on Java1.5" bugzilla report=33862. Fixed default
529   stub version to always be "compat", even on Java1.5+.
531 * The .NET compilation tasks failed if filenames given as references
532   contained spaces.  Bugzilla Report 27170.
534 * SQL task would try access result sets of statements that didn't
535   return any, causing problems with Informix IDS 9.2 and IBM DB2 8.1
536   FixPak 6 (or later). Bugzilla Reports 27162 and 29954.
538 * Task.init() was called twice for most tasks.  Bugzilla Report 34411.
540 * JavaTest testcases sometimes fail on windows. Bugzilla Report 34502.
542 * Targets with identical name work in imported project. Bugzilla Report 34566.
544 * DemuxOutputStream now uses a WeakHashMap to store the thread-stream mapping,
545   to avoid holding on to thread references after they terminate.
547 * <xmlvalidate> and <schemavalidate> create a new parser for every file in a
548   fileset, and so validate multiple files properly. Bugzilla Report 32791.
550 * <tar> / <untar> now accepts files upto 8GB, <tar> gives an error if larger
551   files are to be included. This is the POSIX size limit.
553 * <junitreport> removed line-breaks from stack-traces.  Bugzilla
554   Report 34963.
556 * Off-by-one error in environment setup for execution under OpenVMS fixed.
558 * Bugzilla report 36171: -noclasspath crashes ant if no system
559   classpath is set.
561 * <pvcs> used wrong switch for retrieving revisions by label.
562   Bugzilla Report 36359.
564 * <sshexec> closed System.out, disabling output on second and subsequent
565   invocations.  Bugzilla report 36302.
567 * <cvschangelog> was crashing with CVS versions >= 1.12.x due to change in
568   the date format. Bugzilla report 30962.
570 * The same IntrospectionHelper instance was continuously added as a listener
571   to project. Bugzilla report 37184.
573 * FileUtils.toURI() was not encoding non-ASCII characters to ASCII,
574   causing impossibility to process XML entities referenced by XML
575   documents in non ASCII paths. Bugzilla report 37348.
577 * > 1 ssh invocations to a given host would fail. Bugzilla report 36207.
579 * EmailTask was eating SMTP error messages. Bugzilla report 37547.
581 * PropertySet API setMapper(...) didn't properly set up the Mapper.
582   Bugzilla report 37760.
584 * Proper return code for ant.bat. Bugzilla report 13655.
586 * Project not set on ChainReaderHelpers used by the Redirector.
587   Bugzilla report 37958.
589 * Copy task would fail on locked (or otherwise uncopyable) files even if
590   failonerror set to false. Bugzilla report 38175.
592 * <junit> task did not print all the Test names when using forkmode='once'.
593   Bugzilla report 37426.
595 * <available> could leak resources, Bugzilla Report 38260.
597 * Redirector called Thread.sleep in a synchronized block. Bugzilla
598   report 37767.
600 * CCUnlock's objselect attribute could exhibit unpredictable behavior;
601   standardized improperly included objselect and objsel property accessors to
602   delegate to the inherited objSelect property accessor. Bugzilla report 37766.
604 * <unzip> and <untar> now correctly merge multiple nested patternsets.
605   Bugzilla Report 38973.
607 * On case-insensitive filesystems, a <move> to change filename case
608   erroneously deleted the "destination" file before attempting to rename
609   the source file.  Bugzilla 37701.
611 * <scp> can now handle uris with @s other than the final one denoting the
612   domain.  Bugzilla 38082.
614 * If the class invoked by the <java> task threw a ClassNotFoundException,
615   this was misinterpreted as the specified class itself not being found.
617 * <echoproperties> setPrefix javadoc claimed null or empty prefix would be
618   ignored; instead an error was thrown.  Bugzilla report 39954.
620 * <get> would fetch files that were up to date, because it used > in a
621   remote/local timestamp comparison, not >=. Bugzilla 35607.
623 * <xslt> passes the current file (name + directory) to the
624   stylesheet/transformation.  xsl-parameter name is configurable.
625   Bugzilla report 21042.
627 * The <zip> API allowed creation of directories in file-only archives; a
628   habitual offender was the subclassed <jar>, which included META-INF/ in
629   the destination file regardless of whether filesonly was set to true.
631 * <rmic> has a new adapter, xnew, to use the -XNew back end on java1.5+.
632   By forking rmic, this works on java1.6+. Bugzilla report 38732.
634 * Copy of UnknownElement in macroinstance was not recursive.
635   Bugzilla report 40238.
637 * Mixing of add and addConfigured methods in Mapper/ChainedMapper
638   causes incorrect chaining. Bugzilla report 40228.
640 Other changes:
641 --------------
643 * Warn user when a reference in the form "${refid}" cannot be resolved as this
644   is a sign they probably meant "refid" (misuse of property expansion syntax).
646 * Add dtd to javadoc for junit.
647   Bugzilla 40754.
649 * Add quiet attribute to loadfile/resource.
650   Bugzilla 38249.
652 * Make Locator#fromURI also append the drive letter when running under Windows
653   with JDK 1.3 or 1.2.
655 * Do not uppercase the drive letters systematically in FileUtils#normalize.
657 * Java 5 enumerations may now be used as values in XML attributes in place of
658   EnumeratedAttribute. Bugzilla 41058.
660 * Create a pom file for ant-testutil and add ant-testutil.jar to the ant
661   distribution. Bugzilla 40980.
663 * Roll back automatic proxy enabling on Java 1.5. It broke things like
664   Oracle JDBC drivers, and Ant itself on IBM's JVM on AIX, and didnt
665   seem to work to well the rest of the time.
666   To enable the feature, use the -autoproxy command line option.
668 * Upgraded XML API and parser to Xerces 2.8.1
670 * A code review of some threaded logic has tightened up the synchronization
671   of Watchdog, ExecuteWatchdog and ExecuteJava, which could reduce the occurence
672   of race conditions here, especially on Java1.5+.
674 * Allow broken reference build files. The defer reference processing would
675   break too many files - so allow them with a warning.
677 * Removed dependency on sun.misc.UUEncoder for UUMailer.
679 * Added regex attribute to the echoproperties task.
680   Bugzilla 40019.
682 * <war> task now allows you to omit the web.xml file. as this is optional
683   in the servlet 2.5 and Java EE 5 APIs. set needxmlfile="false" to
684   avoid a missing web.xml file from halting the build.
686 * Diagnostics catches and logs security exceptions when accessing system properties.
688 * <javadoc> useexternalfile now applies to all command line arguments
689   of javadoc. Bugzilla report 40852.
691 * javadoc/tag@description is now set to the name if description is
692   not specified. Bugzill report 32927.
694 * Some performance improvements, including Bugzilla report 25778.
696 * Add <matches> condition. Bugzilla report 28883.
698 * Extending JAR-Task for SPI. Bugzilla report 31520.
700 * Added <tokens> resource collection for convenient creation of string
701   resources from other resources' content. Inspired by Bugzilla 40504.
703 * Added <compare> resource selector to select resources based on the
704   results of their comparison to other resources.
706 * Added outputtoformatters attribute to <junit> to allow suppression
707   of noisey tests. Bugzilla report 12817.
709 * Log level of message 'Overriding previous definition of reference to'
710   set to Verbose. Bugzilla report 17240.
712 * Added setbeans attribute to <script> to allow <script>'s to be
713   run without referencing all references.
714   Bugzilla report 37688.
716 * Added classpath attribute and nested element to <script> to allow
717   the language jars to be specified in the build script.
718   Bugzilla report 29676.
720 * Trim the driver attribute on the <sql> task. Bugzilla report 21228.
722 * Allow (jar) files as well as directories to be given to jdepend.
723   Bugzilla report 28865.
725 * Convert SplashTask to use NOT sun internal classes.
726   Bugzilla report 35619.
728 * Made PatternSet#hasPatterns public to allow custom filesets access.
729   Bugzilla report 36772.
731 * Added searchparents attribute to <available>. Bugzilla report 39549.
733 * Tasks that don't extend Ant's Task class will now get the build file
734   location reflected into a method of the signature void setLocation(Location)
735   - if such a method exists.
737 * Remove needless synchronization in DirectoryScanner.
738   Bugzilla report 40237.
740 * Improved recursion detection for lines with multiple matches of same token
741   on a single line.  Bugzilla report 38456.
743 * Task will now log correctly even if no project is set.
744   Bugzilla report 38458.
746 * Use alternative names for the command line arguments in javac. Bugzilla
747   Report 37546.
749 * The Reference class now has a project field that will get
750   used (if set) in preference to the passed in project, when
751   dereferencing the reference. Bugzilla Report 25777.
753 * On DOS and Netware, filenames beginning with a drive letter
754   and followed by a colon but with no directory separator following
755   the colon are no longer (incorrectly) accepted as absolute pathnames
756   by FileUtils.normalize() and FileUtils.isAbsolutePath().  Netware
757   volumes can still be specified without an intervening separator.
758   UNC pathnames on Windows must include a server and share name, i.e.
759   "\\a\b" to be considered valid absolute paths.
761 * A bug in SQLExec would prevent the execution of trailing,
762   non-semicolon-delimited statements.  Bugzilla Report 37764.
764 * InputHandler implementations may now call InputRequest.getDefaultValue()
765   if they wish. The default handler uses this also. Bugzilla report 28621.
767 * Took in bugzilla report 39320, "Simple code cleanups"
769 * Improve compatibility with GNU Classpath and java versions prior to
770   1.5. Bugzilla 39027.
772 * ${ant.core.lib} may now be used to refer to the library containing the
773   Ant classes, for instance useful when compiling tasks.
775 * Minor performance improvements Bugzilla report 37777
777 * New task <manifestclasspath> converts a path into a property
778   suitable as the value for a manifest's Class-Path attribute.
780 * Fixed references to obsoleted CVS web site. Bugzilla Report 36854.
782 * Log fine-grained events at verbose level from JUnit. Bugzilla report 31885.
784 * <WsdlToDotnet> and <style> are now deprecated in favor of <wsdltodotnet> and
785   <xslt>, respectively. Bugzilla report 25832.
787 * <echoproperties> now (alphanumerically) sorts the property list
788   before echoing. Bugzilla report 18976.
790 * A new base class DispatchTask has been added to facilitate elegant
791   creation of tasks with multiple actions.
793 * Major revision of <wsdltodotnet>. Supports mono wsdl and the microsoft
794   wsdl run on mono, as well as most of the .NET WSE2.0 options. Extra
795   schemas (files or urls) can be named in the <schema> element.
796   Compilers can be selected using the compiler attribute, which defaults
797   to "microsoft" on windows, and "mono" on everything else.
799 * It is now possible to specify the pattern created/parsed by <checksum>.
800   Bugzilla Report 16539.
802 * Added a new "failall" value for the onerror attribute of <typedef>.
803   Bugzilla report 31685.
805 * unzip/unwar/unjar/untar now supports a nested mapper, which lets you unzip
806   in useful ways.
808 * Junit task -- display suite first.
809   Bugzilla report 31962.
811 * Added isSigned condition and signedselector selector
812   Bugzilla report 32126.
814 * Added preserveLastModified attribute to signjar task.
815   Bugzilla report 30987.
817 * Added <scriptcondition> condition, for inline scripted conditions
819 * Added <xor> condition for exclusive-or combining of nested conditions.
821 * Added <scriptselector> selector for scripted file selection
823 * ant -diagnostics lists contents of ${user.home}/.ant/lib , and
824   checks that the java.io.tmpdir directory exists and is writeable.
826 * mail task accepts nested header element.  Bugzilla report 24713.
828 * zip/jar/war/ear supports level attribute for deflate compression level.
829   Bugzilla report 25513.
831 * Added loginputstring attribute to the redirector type.
833 * Tighten security by sending storepass and keypass to signjar
834   via the input stream of the forked process.
836 * New task <schemavalidate> extends <xmlvalidate> with extra support
837   for XML Schema (XSD) files.
839 * <fixcrlf> supports a file attribute for easy fixup of a single file.
841 * New condition <parsersupports> which can look for XML parser feature or
842   property support in the parser Ant is using.
844 * fixcrlf can be used in a filterchain.
846 * <sync> has a new nested element <preserveInTarget> that can be used
847   to protect extra-content in the target directory.  Bugzilla Report
848   21832.
850 * <signjar> now supports:
851   -nested filesets at the same time as the jar attribute
852   -a destDir attribute with the appropriate dependency logic, which
853    can be used with the jar attribute or nested filesets
854   -a mapper to permit filename remapping on signing
855   -tsaurl and tsacert attributes for timestamped JAR signing
856   -nested <sysproperty> elements, which can be used for proxy setup
857   and the like
859 * The linecontains and linecontainsregexp filterreaders now support a
860   negate attribute to select lines -not- containing specified text.
861   Bugzilla Report 34374.
863 * <os> condition adds "winnt" as a family which can be tested. This is
864   all windows platforms other than the Win9x line or Windows CE.
866 * <exec> (and hence, <apply> and any other derived classes) have an OsFamily
867   attribute, which can restrict execution to a single OS family.
869 * Added "backtrace" attribute to macrodef. Bugzilla report 27219.
871 * Ant main provides some diagnostics if it ever sees a -cp or -lib option,
872   as this is indicative of a script mismatch. Bugzilla report 34860
874 * <junitreport> prints a special message if supplied an empty XML File. This
875   can be caused by the test JVM exiting during a test, either via a
876   System.exit() call or a JVM crash.
878 * Project name is now used for *all* targets so one can write consistent import
879   build files. Bugzilla report 28444.
881 * New condition <typefound> that can be used to probe for the declaration
882   and implementation of a task, type, preset, macro, scriptdef, whatever.
883   As it tests for the implementation, it can be used to check for optional
884   tasks being available.
886 * Check for 1.5.* Ant main class. (weblogic.jar in classpath reports)
888 * New condition <isfailure> that tests the return-code of an executable. This
889   contains platform-specific logic and is better than comparing the result with
890   "0".
892 * Added initial support for Resource Collections, including the
893   resourcecount task.
895 * property attribute of pathconvert is now optional. If omitted the
896   result will be written to the log.
898 * New mapper, <scriptmapper>, supports scripted mapping of source files/strings
899   to destination strings.
901 * Add the echoxml task. This will echo nested XML to a file, with
902   the normal <?xml ?> processor instruction. UTF-8 encoding only; no-namespace
903   support.
905 * Try to make subprojects of custom Project subclasses instances of the
906   same type. Bugzilla report 17901.
908 * <ssh> and <scp> support keyboard-interactive authentication now.
910 * <javadoc> now supports -breakiterator for custom doclets if Ant is
911   running on JSE 5.0 or higher.  Bugzilla Report: 34580.
913 * New logger, TimestampedLogger, that prints the wall time that a build
914   finished/failed. Use with
915   -logger org.apache.tools.ant.listener.TimestampedLogger
917 * <junitreport> now generates pages alltests-errors.html and
918   alltests-fails.html, that list only the errors and failures, respectively.
919   Bugzilla Report: 36226
921 * New task <makeurl> that can turn a file reference into an absolute file://
922   url; and nested filesets/paths into a (space, comma, whatever) separated
923   list of URLs. Useful for RMI classpath setup, amongst other things.
925 * <xslt> now accepts nested FileNameMappers e.g. <globmapper>.
926   Bugzilla report 37604.
928 * New task <loadresource> that accompanies <loadfile> for non file resources.
930 * <echo> now supports an encoding when saving to a file.
932 * New GreedyInputHandler added.
934 * Add textfile attribute to the <filesmatch> condition. When true, the text
935   contents of the two files are compared, ignoring line ending differences.
937 * New <resourcesmatch> condition.
939 * Added the onmissingfiltersfile attribute to filterset. Bugzilla report 19845.
941 * Added the inline handler element to the input task.
943 * <sql> supports property expansion if you set the expandProperties
944   attribute. By default it does not expand properties, something we
945   dare not change for fear of breaking complex SQL operations in
946   existing files.
948 * <javadoc>'s packagenames attribute is now optional and defaults to "*".
950 * <javac>'s source and target attributes as well as <javadoc>'s source
951   attribute will read default values from the properties
952   ant.build.javac.source and ant.build.javac.target.
954 * Handling of ' ', '#' in CLASSPATH and '#' in -lib (cannot use ' '
955   in -lib on UNIX at the moment). Bugzilla Report 39295.
957 * <scp> now optionally supports the sftp protocol.  Bugzilla Report 39373.
959 * Resources can now be used to indicate the location of the stylesheet to use
960   in <xslt>. Bugzilla Report 39407.
962 * New <antversion> condition. Bugzilla report 32804.
964 * ReplaceTokens should allow properties files. Bugzilla report 39688.
966 * FTP Account could not be specified in ant FTP task. Bugzilla report 39720.
968 * Minor performance updates. Bugzilla report 39565.
970 * New deleteonexit attribute for the <tempfile> task. Bugzilla report 39842.
971   Remember that the exit of the JVM can be a long time coming,
972   especially under an IDE. Don't rely on this being called.
974 * <scriptdef>-created scripts have support for nested text. All text
975   passed to a scripted task can be accessed via self.text.
977 * <fixcrlf> now supports an outputencoding attribute.  Bugzilla report 39697.
979 * <junitreport> now supports nested XSL parameters. Bugzilla report 39708.
981 * <javacc> has a jdkversion attribute to pass the desired JDK version
982   down to javacc.  Bugzilla report 38715.
984 * <cvs> prints passfile info at -verbose level instead of -info. Bugzilla
985   report 35268
987 * When <javac> can't find the compiler class, it prints out java.home for
988   immediate diagnostics
990 * Ant launcher now supports a -main attribute so that you can specify
991   an extension class to the built in org.apache.tools.ant.Main
992   class. This class must implement the interface AntMain
994 Changes from Ant 1.6.4 to Ant 1.6.5
995 ===================================
997 Changes that could break older environments:
998 --------------------------------------------
1000 Fixed bugs:
1001 -----------
1003 * <move> was unable to replace existing files or write into
1004   existing directories.  Bugzilla report 34962.
1006 * <macrodef> with redefined default values was incorrect. (Fix for
1007    31215 had a bug). Bugzilla report 35109.
1009 * <javadoc> will convert backslashes to forwardslashes when generating file
1010   list by useexternalfile. Bugzilla report 27814.
1012 Changes from Ant 1.6.3 to Ant 1.6.4
1013 ===================================
1015 Changes that could break older environments:
1016 --------------------------------------------
1017 * <ftp> task has had a number of changes.  Uptodate calculation previously
1018   did not call a file uptodate if the source timestamp and the destination
1019   timestamp were equal. Bugzilla report 34941.  Any script that attempted
1020   to compensate for this by using the timediffmillis attribute might need
1021   to be tweaked.
1024 Fixed bugs:
1025 -----------
1027 * Sun javah failed with java.lang.NoClassDefFoundError.
1028   Bugzilla report 34681.
1030 * DirectoryScanner.slowScan() was broken. Bugzilla report 34722.
1032 * DirectoryScanner.scan() could throw a NullPointerException on
1033   case-insensitive filesystems (read Windows or MacOS X).
1035 * Get w/authentication failed with ArrayOutOfBoundsExceptions.
1036   Bugzilla report 34734.
1038 * Granularity attribute for <sync> task was undocumented.
1039   Bugzilla report 34871.
1041 * <unzip> and <untar> could leave file handles open on invalid
1042   archives.  Bugzilla report 34893.
1044 * propertyset threw NPE with nested, mapped propertysets.
1046 Other changes:
1047 --------------
1049 * AntXMLContext.setCurrentTargets() is now public. Bugzilla report 34680.
1051 Changes from Ant 1.6.2 to Ant 1.6.3
1052 ===================================
1054 Changes that could break older environments:
1055 --------------------------------------------
1057 * The subant task used the canonical version of a file path. This
1058   has been changed to use the absolute path. Bugzilla 30438.
1060 * Tar now writes two EOF blocks rather than one.
1061   Bugzilla report 28776
1063 * The Reference object now has a project field which it uses in preference
1064   to the project passed in. This allows composite references to be
1065   handled to nested projects.
1066   Bugzilla report 25777
1068 * <junit> with filtertrace="true" will now also swallow lines for the
1069   sun.reflect package.  If you need to see them in your stack trace,
1070   you must set filtertrace to false.
1071   Bugzilla Report 22758
1073 * The jikes compiler adapter now supports -bootclasspath, -extdirs and
1074   -sourcepath and also uses the same logic for debug flags as javac.
1075   This means, the jikes compiler adapter now requires Jikes 1.15 or later.
1076   Bugzilla Reports 25868, 26404 and 32609.
1078 * The gcj compiler adapter used to include the Java runtime classes
1079   even if includeJavaRuntime was set to false, unless the
1080   bootclasspath has been specified as well.  It will now always adhere
1081   to includeJavaRuntime, you may need to set it to true explicitly now
1082   if you relied on the old behavior.
1084 Other changes:
1085 --------------
1087 * <javadoc> can now take an attribute 'executable'. Bugzilla report 30606.
1089 * New attribute ignorecontents for <different> selector
1091 * Javadoc fixes for Location, Project, and RuntimeConfigurable
1092   Bugzilla 30160.
1094 * Enable to choose the regexp implementation without system property.
1095   Bugzilla Report 15390.
1097 * Expose objects and methods in IntrospectionHelper. Bugzilla Report 30794.
1099 * Allow file attribute of <move> to rename a directory.
1100   Bugzilla Report 22863.
1102 * Add xmlcatalog nested element to XmlProperty. Bugzilla report 27053.
1104 * New attribute alwayslog for <redirector> type.
1106 * Added <target> nested elements to <ant> and <antcall> to allow
1107   specification of multiple sub-build targets, which are executed
1108   with a single dependency analysis.
1110 * Refactored Target invocation into org.apache.tools.ant.Executor
1111   implementations.  Bugzilla Reports 21421, 29248.
1113 * <rmic> now also supports Kaffe's rmic version shipping with Kaffe
1114   1.1.2 and above.
1116 * added casesensitive attribute to <globmapper> and <regexpmapper>
1117   Bugzilla report 16686
1119 * added handledirsep attribute to <globmapper> and <regexpmapper>
1120   Bugzilla report 32487
1122 * added a new mapper <filtermapper>
1124 * When a BuildListener tried to access System.err or System.out, Ant
1125   would have thrown an exception - this has been changed.  Ant now
1126   silently ignores the message.  BuildListeners still should avoid
1127   accessing either stream.
1129 * Added a comment attribute to the zip task.
1130   Bugzilla report 22793.
1132 * Overloaded FileUtils.createNewFile with a boolean mkdirs attribute
1133   to create nonexistent parent directories.
1135 * <apply> has a new "force" attribute that, when true, disables
1136   checking of target files.
1138 * Made the dest attribute of the apply task optional; mapped target
1139   filenames will be interpreted as absolute pathnames when dest is omitted.
1141 * Changed default tempdir for <javac> from user.dir to java.io.tmpdir.
1143 * Added searchpath attribute to <exec> for searching path variable(s)
1144   when resolveexecutable = true.
1146 * Added revision and userid attributes to <pvcs> documentation.
1148 * Added support to the touch task for a mkdirs attribute to create
1149   nonexistent parent directories before touching new files.
1151 * Added support to the touch task for a pattern attribute to allow
1152   alternate datetime formats.
1154 * Added support to the touch task to map touched files using a nested
1155   mapper element.
1157 * Added support to the touch task for a verbose attribute to suppress
1158   logging of new file creation.
1160 * bad link in docs to the enhancement page in bugzilla.
1161   Bugzilla report 33252.
1163 * Added length task to get strings' and files' lengths.
1165 * <native2ascii> and <javah> now also support Kaffe's versions.
1167 * Recursive token expansion in a filterset can now be disabled by
1168   setting its recurse attribute to false.
1170 * Pathconvert no longer requires that one of (targetos|pathsep|dirsep)
1171   be set; platform defaults are used when this is the case.
1173 * Added preservelastmodified attribute to fixcrlf task. Bugzilla 25770.
1175 * Added isfileselected condition.
1177 * Added verbose="true|false" attribute to <subant>. When verbose is enabled,
1178   the directory name is logged on entry and exit of the sub-build.
1179   Bugzilla 33787.
1181 * Added -nouserlib option to allow running ant without automatically loading
1182   up ${user.home}/.lib/ant. This is useful when compiling ant, and antlibs.
1183   Modified the build.sh and build.bat to use the option.
1185 * Added -noclasspath option to allow running ant WITHOUT using CLASSPATH env
1186   variable. Modified ant.bat to do this so that %CLASSPATH% is not looked at.
1188 * Add else attribute to the condition task, which specifies an
1189   optional alternate value to set the property to if the nested
1190   condition evaluates to false. Bugzilla report 33074.
1192 * Ant generated jar files should now be detected as jar files by
1193   Solaris.  Bugzilla Report 32649.
1195 * <rexec> with a single command should now work with unusal login
1196   dialogs without special read/write pairs.  Bugzilla Report 26632.
1198 * <csc>'s extraoptions can now contain multiple arguments.
1199   Bugzilla Report 23599.
1201 * <macrodef> with default values set by properties would be
1202   seen as new definitions when called twice with different properties.
1203   This was confusing so the definitions are now treated as similar.
1204   Bugzilla Report 31215.
1206 * <javadoc> has a new attribute "includenosourcepackages" that can be
1207   used to document packages that don't hold source files but a
1208   package.html file.  Bugzilla Report 25339.
1210 * <rpm> has new attributes failonerror and quiet.
1212 * Added two tutorials
1213   - beginner: introduction into Ant
1214   - task developers: using path, fileset etc
1216 * a number of new attributes that allow the user to handle non-standard
1217   server listing formats and time zone differences have been added in
1218   the <ftp> task.
1221 Fixed bugs:
1222 -----------
1224 * Do not pass on ThreadDeath when halting <java fork="false">. Bugzilla
1225   32941.
1227 * Killing a thread running <java fork="true"> (e.g. from an IDE) would
1228   not stop the forked process. Bugzilla 31928.
1230 * Programs run with <java fork="true"> can now accept standard input
1231   from the Ant console.  (Programs run with <java fork="false"> could
1232   already do so.)  Bugzilla 24918.
1234 * AbstractCvsTask prematurely closed its outputStream and errorStream.
1235   Bugzilla 30097.
1237 * Impossible to use implicit classpath for <taskdef>
1238   when Ant core loader != Java application loader and
1239   Path.systemClassPath taken from ${java.class.path} Bugzilla 30161.
1241 * MacroInstance did not clean up nested elements correctly in the execute
1242   method, causing multiple use of the same macro instance with nested
1243   elements to fail.
1245 * checksum fileext property doc wrong. Bugzilla 30787.
1247 * FTP task, getTimeDiff method was returning wrong value. Bugzilla 30595.
1249 * make sure that Zip and its derivates call the createEmptyZip method when
1250  there are no resources to zip/jar/...
1252 * Zip task was not zipping when only empty directories were found.
1253   Bugzilla 30365.
1255 * Jar task was not including manifest files when duplicate="preserve" was
1256   chosen. Bugzilla 32802.
1258 * ant.bat was missing runAntNoClasspath label for goto.
1259   Bugzilla 34510.
1261 * Classpath was treated in the same way as -lib options. Bugzilla 28046.
1263 * Manual page for cvsversion contained incorrect attributes and did not
1264   say since 1.6.1. Bugzilla 31408.
1266 * Typo in definition of <cvsversion> task causing it not to be defined.
1267   Bugzilla 31403.
1269 * Execution of top level tasks in imported files get delayed by targets.
1270   Bugzilla report 31487.
1272 * ExecTask executes checkConfiguration() even though os does not match.
1273   Bugzilla report 31805.
1275 * Concat task instance could not be run twice.
1276   Bugzilla report 31814.
1278 * NPE using XmlLogger and antlib.
1279   Bugzilla report 31840.
1281 * Properties.propertyNames() should be used instead of .keys().
1282   Bugzilla report 27261.
1284 * Target location is not set for default target.
1285   Bugzilla report 32267.
1287 * Incorrect classloader parent in junittask when using with
1288   ant-junit.jar and junit.jar not in the project classloader. Bugzilla
1289   report 28474.
1291 * getResources() on the classloader returned by ClasspathUtils would
1292   see each resource twice - if the resource is in the project
1293   classpath and if the classloader is requested with a null path.
1295 * XMLValidate used URL#getFile rather than the ant method FileUtils#fromURI
1296   Bugzilla report 32508
1298 * fixed Regexp-Mapper docs which gave outdated instructions (optional.jar)
1299   Bugzilla report 28584
1301 * <scp> using <fileset> didn't work with OpenSSH 3.9 and later.
1302   Bugzilla report 31939
1304 * <setproxy> failed to set user/password on some JDKs.
1305   Bugzilla report 32667
1307 * untar would go into infinite loop for some invalid tar files.
1308   Bugzilla report 29877
1310 * forked <javac> won't pass -source to a JDK 1.1 or 1.2 javac anymore.
1311   Bugzilla report 32948
1313 * propertyset references did not handle nested propertyset references.
1315 * oata.types.Description.getDescription(Project) would throw a
1316   NullPointerException when the "ant.targets" reference was unset.
1318 * Wrapper scripts did not detect WINNT value of dynamic OS environment
1319   variable when logged into workstations using Novell authentication.
1320   Bugzilla Report 30366.
1322 * DependScanner.getResource() always returned nonexistent resources,
1323   even when the resource actually existed.  Bugzilla Report 30558.
1325 * <apply> was broken with classfilesets.  Bugzilla Report 30567.
1327 * <available> returned false positives when checking a file
1328   passed in with the current basedir leading twice:
1329   e.g. ${basedir}${file.separator}${basedir}${file.separator}foo .
1331 * The first file open that took place when using input files with the
1332   <exec>, <apply>, or <java> tasks was always logged to System.out
1333   instead of to the managing Task.
1335 * <telnet> and <rexec> would try to disconnect from servers they never
1336   connetced to, potentially leading to exceptions in commons-net.
1337   Bugzilla Report 33618.
1339 * <zip> would drop files matched by defaultexcludes during updates.
1340   Bugzilla Report 33412.
1342 * <zip> couldn't store files with size between 2GB and 4GB (the
1343   upper limit set by the ZIP format itself).  Bugzilla Report 33310.
1345 * NPE when when <presetdef> tries to configure a task that
1346   cannot be instantiated. Bugzilla Report 33689.
1348 * <javac debug="false"> created an invalid command line when running
1349   the Symantec Java compiler.
1351 * Get with usetimestamp did not work on Java 1.2.
1353 * Get with usetimestamp did not work when local timestamp roughly >= now.
1355 * The framed JUnit report now handles multiple reports for the same
1356   testcase properly.  Bugzilla Report 32745.
1358 * <cab> didn't work for files with spaces in their names on Windows.
1359   Bugzilla Report 17182.
1361 * The VAJ tasks could fail if the project name contained characters
1362   that need to get URL encoded.  Bugzilla Report 23322.
1364 * TarInputStream#read() wasn't implemented correctly.  Bugzilla Report
1365   34097.
1367 * <xslt> failed to process file-hierarchies of more than one level if
1368   scanincludeddirectories was true.  Bugzilla Report 24866.
1370 * forkmode="perBatch" or "once" would ignore extension attributes that
1371   had been specified for <formatter>s.  Bugzilla Report 32973.
1373 * The refid attribute of the I/O redirector was not functional.
1375 Changes from Ant 1.6.1 to Ant 1.6.2
1376 ===================================
1378 Changes that could break older environments:
1379 --------------------------------------------
1381 * The import task used the canonical version of a file path. This
1382   has been changed to use the absolute path. Bugzilla 28505.
1384 * ant-xalan2.jar has been removed since the only class contained in it
1385   didn't depend on Xalan-J 2 at all.  Its sole dependency has always
1386   been TraX and so it has been merged into ant-trax.jar.
1388 * All exceptions thrown by tasks are now wrapped in a buildexception
1389   giving the location in the buildfile of the task.
1391 * Nested elements for namespaced tasks and types may belong to the
1392   Ant default namespace as well as the task's or type's namespace.
1394 * <junitreport> will very likely no longer work with Xalan-J 1.
1396   Note that Xalan-J 1 has been deprecated for a very long time and we
1397   highly recommend that you upgrade.
1399   If you really need to continue using Xalan-J 1, please copy the
1400   junit-frames-xalan1.xsl from the distribution's etc directory as
1401   junit-frames.xsl into a new directory and use the task's styledir
1402   attribute to point to.  This is the last version of the XSLT
1403   stylesheet that is expected to be compatible with Xalan-J 1.
1405 Fixed bugs:
1406 -----------
1408 * eliminate memory leak in AntClassLoader. Bugzilla Report 8689.
1410 * subant haltonfailure=false did not catch all failures. Bugzilla Report 27007.
1412 * macrodef @@ escaping was broken.  Bugzilla Report 27069.
1414 * MacroDef did not allow attributes named 'description'. Bugzilla Report 27175.
1416 * Throw build exception if name attribute missing from patternset#NameEntry.
1417   Bugzilla Report 25982.
1419 * Throw build exception if target repeated in build file, but allow targets
1420   to be repeated in imported files.
1422 * <apply> didn't compare timestamps of source and targetfiles when
1423   using a nested <filelist>.  Bugzilla Report 26985.
1425 * tagdiff.xml was broken in ant 1.6.1. Bugzilla Report 27057.
1427 * if the basedir contained .. or . dirs, and the build file name contained
1428   .. or ., the basedir was set incorrectly. Bugzilla Report 26765.
1430 * regression from ant 1.5, exec task outputted two redundant trailing newlines.
1431   Bugzilla Report 27546.
1433 * NPE when running commons listener. Bugzilla Report 27373.
1435 * <java> swallowed the stack trace of exceptions thrown by the
1436   executed program if run in the same VM.
1438 * -projecthelp swallowed (configuration) errors silently.
1439   Bugzilla report 27732.
1441 * filterset used by filtertask doesn't respect loglevel. Bugzilla Report 27568.
1443 * wrong compare used in ProjectComponent for logging. Bugzilla Report 28070.
1445 * failOnAny attribute for <parallel> was broken. Bugzilla Report 28122.
1447 * If <javac> uses gcj and any of the nested <compilerarg>s implies
1448   compilation to native code (like -o or --main), Ant will not pass
1449   the -C switch to gcj.  This means you can now compile to native code
1450   with gcj which has been impossible in Ant < 1.6.2.
1452 * <import optional="false"> and <import optional="true">
1453   behaved identically.
1455 * <xslt> now sets the context classloader if you've specified a nested
1456   <classpath>.  Bugzilla Report 24802.
1458 * <zip> and friends would delete the original file when trying to update
1459   a read-only archive.  Bugzilla Report 28419.
1461 * <junit> and <assertions> are working together. Bugzilla report 27218
1463 * AntClassLoader#getResource could return invalid URLs.  Bugzilla
1464   Report 28060.
1466 * Ant failed to locate tools.jar if the jre directory name wasn't all
1467   lowercase.  Bugzilla Report 25798.
1469 * Redirector exhibited inconsistent behavior with regard to split
1470   output.  When sent to file only, files would be created in all
1471   cases; when split file-property, files were only created if
1472   writes were performed.
1474 * fixed case handling of scriptdef attributes and elements.
1476 * UNC pathnames did not work for ANT_HOME or -lib locations on Windows.
1477   Bugzilla report 27922.
1479 * replacestring tokenfilter only replaced the first occurrence.
1481 * AntLikeTasksAtTopLevelTest failed on cygwin.
1483 * I/O-intensive processes hung when executed via <exec spawn="true">.
1484   Bugzilla reports 23893/26852.
1486 * JDependTask did not close an output file. Bugzilla Report 28557.
1488 * Using <macrodef> could break XmlLogger. Bugzilla Report 28993.
1490 * <genkey> no longer requires keytool to be in your PATH.  Bugzilla
1491   Report 29382.
1493 * <symlink> could create cyclic links.  Bugzilla Report 25181.
1495 * <zip whenempty="skip"> didn't work in a common situation.  Bugzilla
1496   Report 22865.
1498 * <scp> now properly handles remote files and directories with spaces
1499   in their names.  Bugzilla Report 26097.
1501 * <scp> now has (local|remote)tofile attributes to rename files on the
1502   fly.  Bugzilla Report 26758.
1504 * <telnet> and <rexec> didn't close the session.  Bugzilla Report 25935.
1506 * <subant> and XmlLogger didn't play nicley together.
1508 Other changes:
1509 --------------
1510 * doc fix concerning the dependencies of the ftp task
1511   Bugzilla Report 29334.
1513 * <xmlvalidate> has now a property nested element,
1514   allowing to set string properties for the parser
1515   Bugzilla Report 23395.
1517 * Docs fixes for xmlvalidate.html, javadoc.html, starteam.
1518   Bugzilla Reports 27092, 27284, 27554.
1520 * <pathconvert> now accepts nested <mapper>s.  Bugzilla Report 26364.
1522 * Shipped XML parser is now Xerces-J 2.6.2.
1524 * Added nested file element to filelist.
1526 * spelling fixes, occurred. Bugzilla Report 27282.
1528 * add uid and gid to tarfileset. Bugzilla Report 19120.
1530 * <scp> has a verbose attribute to get some feedback during the
1531   transfer and new [local|remote][File|Todir] alternatives to file and
1532   todir that explicitly state the direction of the transfer.
1534 * The OS/2 wrapper scripts have been adapted to use the new launcher.
1535   Bugzilla Report 28226.
1537 * <sshexec> now also captures stderr output.  Bugzilla Report 28349.
1539 * <xslt> now supports a nested <mapper>.  Bugzilla Report 11249.
1541 * <touch> has filelist support.
1543 * <nice> task lets you set the priority of the current thread; non-forking
1544   <java> code will inherit this priority in their main thread.
1546 * New attribute "negate" on <propertyset> to invert selection criteria.
1548 * Target now supports a Location member.  Bugzilla Report 28599.
1550 * New "pattern" attribute for <date> selector.
1552 * <junit> has a new forkmode attribute that controls the number of
1553   Java VMs that get created when forking tests.  This allows you to
1554   run all tests in a single forked JVM reducing the overhead of VM
1555   creation a lot.  Bugzilla Report 24697.
1557 * <jar> can now optionally create an index for jars different than the
1558   one it currently builds as well.  See the new <indexjars> element
1559   for details.  Bugzilla Report 14255.
1561 * Permit building under JDK 1.5. Bugzilla Report 28996.
1563 * minor Javadoc changes. Bugzilla Report 28998.
1565 * Misc. corrections in SignJar.java. Bugzilla Report 28999.
1567 * Remove redundant <hr> from javah.html. Bugzilla Report 28995.
1569 * Ignore built distributions. Bugzilla Report 28997.
1571 * A new roundup attribute on <zip> and related task can be used to
1572   control whether the file modification times inside the archive will
1573   be rounded up or down (since zips only store modification times with
1574   a granularity of two seconds).  The default remains to round up.
1575   Bugzilla Report 17934.
1577 * A binary option has been added to <concat>. Bugzilla Report 26312.
1579 * Added DynamicConfiguratorNS, an namespace aware version of
1580   DynamicConfigurator. Bugzilla Report 28436.
1582 * Add implicit nested element to <macrodef>. Bugzilla Report 25633.
1584 * Add deleteonexit attribute to <delete>.
1586 * Added Target.getIf/Unless().  Bugzilla Report 29320.
1588 * <fail> has a status attribute that can be used to pass an exit
1589   status back to the command line.
1591 * <fail> accepts a nested <condition>.
1593 * <loadproperties> supports loading from a resource.
1594   Bugzilla Report 28340.
1596 * Nested file mappers and a container mapper implementation have been
1597   introduced.  Additionally, the <mapper> element now accepts "defined"
1598   nested FileNameMapper implementations directly, allowing a usage
1599   comparable to those of <condition>, <filter>, and <selector>.
1601 * New <redirector> type introduced to provide extreme I/O flexibility.
1602   Initial support for <exec>, <apply>, and <java> tasks.
1604 * <apply> has a new ignoremissing attribute (default true for BC)
1605   which will allow nonexistent files specified via <filelist>s to
1606   be passed to the executable.  Bugzilla Report 29585.
1608 * <junitreport> now also works with Xalan XSLTC and/or JDK 1.5.
1609   Bugzilla Report 27541.
1611 * <jspc> doesn't work properly with Tomcat 5.x.  We've implemented a
1612   work-around but don't intend to support future changes in Tomcat
1613   5.x.  Please use the jspc task that ships with Tomcat instead of
1614   Ant's.
1616 Changes from Ant 1.6.0 to Ant 1.6.1
1617 =============================================
1619 Changes that could break older environments:
1620 --------------------------------------------
1622 * License is now Apache Software License 2.0
1623   see http://www.apache.org/licenses/ for more information
1625 Fixed bugs:
1626 -----------
1627 * Remove a recursive template call in the junit xsls that could trigger a stack
1628   overflow. It now uses Xalan extensions to call a Java class directly.
1629   Bugzilla Report 19301
1631 * Fix spurious infinite loop detection for filters (introduced in ant 1.6.0).
1632   Bugzilla Report 23154.
1634 * Fix handling of default ant namespace for nested elements.
1636 * Fix jboss element of ejb task (introduced in ant 1.6.0).
1638 * <whichresource> failed to load classes correctly.
1640 * Ant could fail to start with a NullPointerException if
1641   ANT_HOME/lib/ant-launcher.jar was part of the system CLASSPATH.
1643 * presetdef'ed types did not work with the ant-type attribute
1645 * fixed case handling of macrodef attributes and elements. Bugzilla
1646   Reports 25687 and 26225.
1648 * <java> ignored the append attribute, Bugzilla Report 26137.
1650 * The gcj compiler adapter for <javac> failed if the destination
1651   directory didn't exist.  Bugzilla Report 25856.
1653 * Ant now fails with a more useful message if a new process will be
1654   forked in a directory and that directory doesn't exist.
1656 * <splash> used to break the build on non-GUI environments.  Bugzilla
1657   report 11482.
1659 * Ant 1.6.0 cannot run build scripts in directories with non-ASCII names.
1660   Bugzilla Report 26642.
1662 Other changes:
1663 --------------
1664 * Shipped XML parser is now Xerces-J 2.6.1
1666 * Translate task logs a debug message specifying the number of files
1667   that it processed.  Bugzilla Report 13938.
1669 * <fixcrlf> has a new attribute - fixlast. Bugzilla Report 23262.
1671 * <p4submit> has 2 new attributes, needsresolveproperty and changeproperty.
1672   Bugzilla Report 25711.
1674 * add description attributes to macrodef attributes and elements.
1675   Bugzilla Report 24711.
1677 * Extending ClearCase Tasks :
1678  - Added an extra option to 'failonerr' to each ClearCase task/command.
1679  - Extended the functionality of cccheckout. It can check (notco) to see if
1680   the desired element is already checked out to the current view. Thus it
1681    won't attempt to check it out again.
1682  - Added three new ClearCase commands: ccmkattr, ccmkdir, ccmkelem
1683   Bugzilla Report 26253.
1685 * added nested text support to <macrodef>
1687 * added initial support for Java 1.5.  Java 1.5 is now correctly
1688   detected by Ant and treated just like Java 1.4.  You can now specify
1689   source="1.5" in the <javac> task.
1691 * created new task <cvsversion>
1693 * added support for branch logging via the tag attribute in <cvschangelog>
1694   Bugzilla Report 13510.
1696 * added support the groovy language in the script and scriptdef tasks
1698 Changes from Ant 1.5.4 to Ant 1.6.0
1699 ===================================
1701 Changes that could break older environments:
1702 --------------------------------------------
1704 * This version of Ant can not be built with JDK 1.1 and requires at
1705   least Java 1.2 at runtime as well.  Compiling for a 1.1 target is
1706   still supported.
1708 * Targets cannot have the empty string as their name any longer.
1710 * ant.jar's manifest does no longer include a Class-Path entry, so it
1711   is no longer possible to run Ant via "java -jar ant.jar" without
1712   manually altering the CLASSPATH.  Instead of that a file
1713   ant-bootstrap.jar is included in the etc directory of the binary
1714   distribution, copy this to the lib directory and use
1715   "java -jar ant-bootstrap.jar" instead if you want to run Ant without
1716   the wrapper script (not recommended).
1718 * The <script> task now requires Apache BSF instead of the older IBM
1719   version.  See <http://jakarta.apache.org/bsf/>
1721 * <xmlproperty> will no longer fail if the file to be loaded doesn't exist.
1723 * XML namespaces are now enabled in the XML parser, meaning XML namespace
1724   declarations no longer cause errors. However task names containing colons
1725   will cause errors unless there is a corresponding namespace uri.
1727 * The <ftp> and <telnet> tasks now require Jakarta Commons Net instead
1728   of the older ORO Netcomponents version.  See
1729   <http://jakarta.apache.org/commons/net/index.html>.
1731 * <input> will no longer prompt the user and wait for input if the
1732   addproperty attribute is set to a property that has already been
1733   defined in the project.  If you rely on the task waiting for input,
1734   don't use the addproperty attribute.
1736 * The Class-Path attribute in manifests will no longer merge the
1737   entries of all manifests found, but will be treated like all other
1738   manifest attributes - the most recent attribute(s) will be used.
1740 * New Launch mechanism implemented. This moves some functionality from
1741   the batch files / shell scripts into Java. This removes environment
1742   limitations, for command issues, directory depth issues on Windows. Also
1743   allows a per-user library location to be used if the main Ant install
1744   is locked down.
1746 * The Entry nested element of PropertyFile will not any more have its value
1747   attribute (actually increment) overwritten with the new value of the entry
1748   after execution.
1750 * Output stored from a <java> or <exec> task is now exactly as generated. No
1751   conversion to platform end-of-line characters is performed.
1753 * <translate> will now preserve line endings.
1755 * <ftp> followsymlinks="false" in nested fileset definitions is explicitly
1756   required in order to exclude remote symbolic links (when doing a get, chmod,
1757   delete, rmdir).
1759 * The values of the Copy#fileCopyMap variable has changed from String to
1760   String[]. (In java 1.5 terms it was Hashtable<String, String> and
1761   is now Hashtable<String, String[]>). This will affect third party code
1762   that extend Copy and override Copy#doFileOperations.
1764 * <loadproperties> didn't expand properties while <property file="..."/>
1765   does, so they were not equivalent.  This has been fixed, which means
1766   that propetries may get expanded twice if you use an
1767   <expandproperties> filterreader.  Bugzilla Report 17782.
1769 * User defined tasks and typedefs are now handled internally in the
1770   same way as predefined tasks and typedefs. Also tasks and typedefs
1771   are resolved at a later stage. This causes some
1772   differences especially for user defined task containers.
1774 * <checksum> log message "Calculating checksum ..." has been degraded
1775   from INFO to VERBOSE.
1777 Fixed bugs:
1778 -----------
1779 * Filter readers were not handling line endings properly.  Bugzilla
1780   Report 18476.
1782 * Filtersets were also not handling line endings properly.
1784 * Expand tasks did not behave as expected with PatternSets.
1786 * <property environment=... /> now works on OS/400.
1788 * <cab> could hang listcab on large <fileset>s.
1790 * The starteam stcheckout, stcheckin tasks now correctly compute
1791   status of files against whatever local tree they are run against
1792   and, optionally, will not process a file if it is current.
1793   Previously you had to process everything unless you ran against the
1794   default folder which wasn't the normal use-case for ant-starteam.
1795   The stlist task now similarly displays that status correctly making
1796   it a more generally useful tool.
1798 * entity includes would cause exceptions if path names included spaces.
1800 * addConfiguredXXX would not work for TaskAdapter wrapped tasks
1802 * Fix <ilasm> outputfile testing so that the output file does not need
1803   to exist beforehand.
1805 * Ant will now exit with a return code of 1 if it encounters problems
1806   with the command line arguments.
1808 * ClassLoader creation changes to use a factory method in Project. A new
1809   class AntClassLoader2 implemented for 1.2+ specific features including
1810   Package information and addition of classes specified in the Class-Path
1811   element of a Jar's manifest.
1813 * It is now possible in <exec> to resolve the executable to a project
1814   basedir or execution dir relative executable. The resolveExecutable
1815   must be used to pick up such executables.
1817 * splash screen wouldn't disappear when build was finished.
1819 * <exec> output and error streams can now be redirected independently
1820   to either a property or a file (or both)
1822 * TarEntry's File-arg constructor would fail with a
1823   StringIndexOutOfBoundsException on all OSes where os.name is shorter
1824   than seven characters.  Bugzilla Report 18105.
1826 * <copy> and <move>'s failonerror didn't apply to filesets pointing to
1827   non-existant directories.  Bugzilla Report 18414.
1829 * The <stripjavacomments> filter sometimes removed parts of string
1830   constants.  Bugzilla Report 17441.
1832 * <antlr> will now recompile your grammar if the supergrammar has
1833   changed.  Bugzilla Report 12691.
1835 * <property env> will now work on Unices with /bin/env instead of
1836   /usr/bin/env.  Bugzilla Report 17642.
1838 * <jar index="on"> could include multiple index lists.  Bugzilla 10262.
1840 * The index created by <jar> didn't conform to the spec as it didn't
1841   include the top-level entries.  Bugzilla Report 16972.
1843 * <tar> and <zip> didn't honor the defaultexcludes attribute for the
1844   implicit fileset.  Bugzilla Report 18637.
1846 * The <replacetokens> filter would throw an exception if the token's
1847   value was an empty string.  Bugzilla Report 18625.
1849 * Perforce tasks relying on output from the server such as <p4change>
1850   and <p4label> were hanging. Bugzilla Reports 18129 and 18956.
1852 * Improve exception and logging behavior of Perforce tasks.
1853   Bugzilla report 18154.
1855 * build.sh install had a problem on cygwin (with REALANTHOME).
1856   Bugzilla Report 17257
1858 * <replaceregexp> didn't work for multi-byte encodings if byline was false.
1859   Bugzilla Report 19187.
1861 * <replaceregexp> was altering unnecessarily the timestamp of the directories
1862   containing the files to process
1863   Bugzilla Report 22541.
1865 * file names that include spaces need to be quoted inside the @argfile
1866   argument using forked <javac> and (all JDKS).  Bugzilla Report 10499.
1867   NB : a first correction was only introducing quotes for JDK 1.4
1868   It has been changed to quote for all external compilers when paths
1869   contain spaces.
1870   Also the backslashes need to be converted to forward slashes
1871   Bugzilla Report 17683.
1873 * Setting filesonly to true in <zip> and related tasks would cause the
1874   archives to be always recreated.  Bugzilla Report 19449.
1876 * file names that include spaces need to be quoted inside the @argfile
1877   argument using <javadoc> and JDK 1.4.  Bugzilla Report 16871.
1879 * <junit> didn't work with custom formatters that were only available
1880   on the user specified classpath when a timeout occurred.  Bugzilla
1881   Report 19953.
1883 * <different> selector : make ignoreFileTimes effectively default to true
1884   and fix a bug in the comparison of timestamps. Bugzilla Report 20205.
1886 * <different> selector can now be nested directly under a fileset
1887   Bugzilla Report 20220.
1889 * <cvstagdiff> had a problem with "dd-MM-yy hh:mm:ss" formats
1890   Bugzilla Report 15995.
1892 * <cvstagdiff> cvsroot and package attributes added to the root
1893   element tagdiff of the xml output
1894   Bugzilla Report 16081.
1896 * <cvstagdiff> had a problem with aliased modules and with requests for
1897   multiple modules. Bugzilla Reports 21373 and 22877.
1899 * <cvstagdiff> could not parse properly the revision number of new files with
1900   CVS 1.11.9 or higher. Bugzilla Report 24406.
1902 * <fixcrlf> make fixcrlf create its temporary files in the default directory
1903   of FileUtils#createTempFile instead of the destination dir of fixcrlf.
1904   Bugzilla Report 20870.
1906 * <ejbjar> implementation for Borland.
1907   Prevent the task from being blocked by error messages coming from java2iiop.
1908   Bugzilla Report 19385.
1910 * <unzip>'s and <untar>'s nested patternsets didn't work as documented
1911   when the pattern ended in a slash or backslash.  Bugzilla Report 20969.
1913 * <fixcrlf> will now create the parent directories for the destination
1914   files if necessary.  Bugzilla Report 20840.
1916 * <xmlproperty> now handles CDATA sections. BugZilla Report 17195
1918 * <translate> now translate tokens that are placed close together.
1919   Bugzilla Report 17297
1921 * Nested websphere element for ejbjar does not support spaces in file name.
1922   Bugzilla Report 21298
1924 * Don't multiply Class-Path attributes when updating jars.  Bugzilla
1925   Report 21170.
1927 * Do not overwrite the value (increment) attribute of PropertyFile nested
1928   Entry element. Bugzilla Report 21505.
1930 * Prevent sysproperties with no key or no value from being added in <junit>.
1931   Bugzilla Report 21684.
1933 * Allow references to be properly inherited via antcall
1934   Bugzilla Report 21724.
1936 * ftp chmod failed when the remote system was UNIX and local system Windows
1937   Bugzilla Report 21865.
1939 * ftp put with chmod failed when the remote system was UNIX and local system
1940   Windows. Bugzilla Report 23143.
1942 * ftp did not set the ascii mode explicity, causing problems with ftp servers
1943   having binary as default
1945 * ftp was not able to download files when they were pointed to by symbolic
1946   links. Bugzilla Report 14063.
1948 * ftp is able to download also directories pointed to by symbolic links.
1950 * replace would change \r\n into \r\r\n under Windows.
1952 * junitreport with frames did not display a link for classes without a package
1953   or in the top package.
1954   Bugzilla Report 21915.
1956 * Project.toBoolean(String) now handles null as argument and does not throw a
1957   NullPointerException any more.
1959 * The socket condition will now close the socket created to test.
1960   Bugzilla Report 23040.
1962 * <junit includeantruntime="true" fork="true"> replaced the CLASSPATH instead
1963   of adding to it.  Bugzilla Report 14971.
1965 * <splash> could fail on JVMs that use null to indicate the system classloader.
1966   Bugzilla Report 23320.
1968 * <xmlcatalog>s only worked when defined inside of tasks.  Bugzilla
1969   Report 20965.
1971 * <csc> and siblings (<vbc> <jsharpc>) handle large filesets by
1972 automatic use of response files.  Bugzilla report #19630
1974 Other changes:
1975 --------------
1977 * Shipped XML parser is now Xerces 2.6.0
1979 * All tasks can be used outside of <target>s.  Note that some tasks
1980   will not work at all outside of targets as they would cause infinite
1981   loops (<antcall> as well as <ant> and <subant> if they invoke the
1982   current build file).
1984 * Six new Clearcase tasks added.
1986 * A new filter reader namely tokenfilter has been added.  Bugzilla
1987   Report 18312.
1989 * A new attribute named skip is added to the TailFilter and
1990   HeadFilter filter readers.
1992 * The filesetmanifest attribute of <jar> has been reenabled.
1994 * The start and end tokens for <translate> may now be longer than a
1995   single character.
1997 * <setproxy> lets you set the username and password for proxies that
1998   want authentication
2000 * <loadproperties> has a new encoding attribute.
2002 * <echoproperties> can now create XML output.
2004 * <echoproperties> has a new srcfile attribute that can make it read
2005   properties files and output them instead of Ant's properties.
2007 * <filterset> will now resolve filters recursively.
2009 * <input> has a new attribute that allows you to specify a default value.
2011 * Added <image> task (requires JAI).
2013 * <image> task has now proportions attribute in the <scale/> nested element
2014   instead of keepproportions (bringing in more functionality)
2016 * New condition <isreference>
2018 * <ftp> now has a preservelastmodified attribute to preserve the
2019   timestamp of a downloaded file.
2021 * new rmdir action for <ftp> that removes directories from a fileset.
2023 * <ftp> has attributes timediffauto and timediffmillis to use together
2024   with the newer attribute to tell ant to take into account a time difference
2025   between client and remote side.
2026   Bugzilla Report 19358.
2028 * <ftp> has been optimized to go directly to the include patterns.
2029   This reduces scanning time under UNIX when followsymlinks="true"
2030   and casesensitive="true" (the default)
2031   Bugzilla Report 20103.
2033 * The SOS and VSS tasks will no longer unconditionally prepend a $ to
2034   vsspath or projectpath.
2036 * OS/400 now gets detected by the os condition.
2038 * <arg> has a new attribute pathref that can be used to reference
2039   previously defined paths.
2041 * <xmlproperty> has been improved, you can now expand ${properties},
2042   define ids or paths and use Ant's location magic for filename resolutions
2043   in the XML file.
2045 * <xmlcatalog> will now support external catalogs according to the
2046   OASIS "Open Catalog" standard - if resolver.jar (newer than version
2047   1.0) from Apache's xml-commons is in your CLASSPATH.
2049 * Starteam tasks now have support for revision labels and build labels.
2050   Checkouts now have the option of using repository timestamps, instead
2051   of current.
2053 * new task <symlink> that creates and maintains symbolic links.
2055 * new tasks <chown> and <chgrp> which are wrappers of the Unix commands.
2057 * new task <attrib> to change file attributes on Windows systems.
2059 * <style> has a new attribute reloadstylesheet to work around a
2060   bug in widespread Xalan versions.
2062 * <tarfileset> has a new dirmode attribute to specify the permissions
2063   for directories.
2065 * <fixcrlf>'s eol attribute now also understands "mac", "unix" and "dos".
2067 * <classfileset> now picks up dependencies of the form MyClass.class. This
2068   works for the code generated by the Sun java compiler. It may not work for
2069   all compilers.
2071 * a new attribute "globalopts" can be added to all Perforce tasks.
2072   You can put in it all the strings described by p4 help usage. Refer to
2073   the docs for more information.
2075 * new Perforce tasks <p4integrate> , <p4resolve>, and <p4labelsync>
2077 * <p4submit> will change the property p4.change if the Perforce server
2078   renumbers the change list.
2079   It will set the property p4.needsresolve if the submit fails,
2080   and the message says that file(s) need to be resolved.
2082 * <replaceregexp> now has an optional encoding attribute to support
2083   replacing in files that are in a different encoding than the
2084   platform's default.
2086 * The <exec> task may now have its input redirected from either a file
2087   or a string from the build file. The error output can be separated
2088   to a different file when outut is redirected. standard error may be
2089   logged to the Ant log when redirecting output to a file
2091 * The <java> task also supports the input redirection and separate
2092   error streams introduced to the <exec> task. In addition, it is now
2093   possible to save the output into a property for use within the build
2094   file as was possible with <exec> in Ant 1.5
2096 * The <javadoc> task <tag> subelement has been enhanced to allow files
2097   with tag mappings to be used.
2099 * New tasks: <scp> supports file transfers, <sshexec> executes a
2100   command over SSH.  They require jsch, a BSD licensed SSH library that
2101   can be found at http://www.jcraft.com/jsch/index.html
2103 * New filterreader <escapeunicode/>.
2105 * Support for HP's NonStop Kernel (Tandem) OS has been added.
2107 * <cab>'s basedir attribute is now optional if you specify nested
2108   filesets.  Bugzilla Report 18046.
2110 * New task <sync> that synchronizes two directory trees.
2112 * <apply> has new forwardslash attribute that can force filenames to
2113   use forward slashes (/) as file separators even on platforms with a
2114   different separator.  This is useful if you want to run certain
2115   ported Unix tools.
2117 * Copy has a new outputencoding attribute that can be used to change
2118   the encoding while copying files.  Bugzilla Report 18217.
2120 * The xml formatter for JUnit will now honor test case names set with
2121   setName.  Bugzilla Report 17040.
2123 * JUnit now has an attribute reloading, which, when set to false,
2124   makes the task reuse the same class loader for a series of tests.
2126 * <concat> now supports filtering and can check timestamps before
2127   overriding a file.  Bugzilla Report 18166.
2129 * <junit> has a new attribute tempdir that controls the placement of
2130   temporary files.  Bugzilla Report 15454.
2132 * <jdepend> now supports a new nested element <classespath> which is
2133   the same as <sourcespath> but point to compiled classes (the
2134   prefered mode of operation for JDepend > 2.5).  Additionally, nested
2135   <exclude> elements can be used to exclude certain packages from
2136   being parsed.  Bugzilla Report 17134.
2138 * The JProbe tasks now also work with JProbe 4.x.  Bugzilla Report 14849.
2140 * <javacc> and <jjtree> will now autodetect JavaCC 3.x and can use it.
2142 * <sql> has a new attribute to control escape processing.
2144 * <sql> is able to display properly several resultsets if you are
2145   running a compound sql statement. Bugzilla Report 21594.
2147 * A new <containsregexp> selector has been added, that selects files
2148   if their content matches a certain regular expression.
2150 * <antlr>'s debug attribute has been enabled.  Bugzilla Report 19051.
2152 * <mail> has a new attribute charset. Bugzilla Report 15434.
2154 * <mail> has new attributes user and password for SMTP auth.
2155   maillogger can also use this.
2156   The implementation only works with JavaMail (encoding="MIME").
2157   Implementation with plain mail remains to do.
2158   Bugzilla Report 5969.
2160 * <mail> and mailloger support SMTP over TLS/SSL
2161   Bugzilla Report 19180.
2163 * <mail> the attributes from, replyto ,tolist, cclist, bcclist
2164   can now contain email addresses of the form name <address@xyz.com>
2165   or (name) address@xyz.com
2166   Bugzilla Report 22474.
2168 * <mail> (version PlainMail)
2169   prevent blank headers from being sent,
2170   make the order of the headers of plain mail messages predictable
2171   Bugzilla Report 22088.
2173 * <zipfileset> can now be defined in the main body of a project
2174   and referred to with refid="xyz". Bugzilla Report 17007.
2176 * A wrapper script for OS/2 has been added.
2178 * <unzip> will now detect and successfully extract self-extracting
2179   archives.  Bugzilla Report 16213.
2181 * <stcheckout> has a new attribute "converteol" that can be used to
2182   control the automatic line-end conversion performed on ASCII files.
2183   Bugzilla Report 18884.
2185 * Users can now modify the list of default excludes using the new
2186   defaultexcludes task.  Bugzilla Report 12700.
2188 * There is a new data type <propertyset> that can be used to collect
2189   properties.  It is supported by <ant>, <antcall>, <subant>, <java>,
2190   <echoproperties> and <junit>.
2192 * <concat> can now control the encoding of the output as well and optionally
2193   add new-line characters at the end of files that get concatenated but
2194   don't end in newlines.  Bugzilla Report 12511.
2196 * <rpm> will detect the rpmbuild executable of RedHat 8.0 and newer
2197   and use that if it is on your PATH.  Bugzilla Report 14650.
2199 * A new task <rexec> has been added that requires commons-net to work.
2200   Bugzilla Report 19541.
2202 * <javadoc> now supports a nested <arg> element in addition to the
2203   additionalparams attribute.
2205 * You can now determine the order of standard tags in <javadoc> via
2206   <tag> elements - you must not use the description attribute for them.
2207   Bugzilla Report 18912.
2209 * <javadoc> now supports the -noqualifier switch.  Bugzilla Report 19288.
2211 * <javac>'s executable attribute can now also be used to specify the
2212   executable for jikes, jvc, sj or gcj.  Bugzilla Report 13814.
2214 * <javac> has a new attribute tempdir that can control the placement
2215   of temporary files.  Bugzilla Report 19765.
2217 * A new magic property build.compiler.jvc.extensions has been added
2218   that can be used to turn of Microsoft extensions while using the jvc
2219   compiler.  Bugzilla Report 19826.
2221 * You can now limit the parallelism of <apply> and <chmod> by using the new
2222   maxparallel attribute.
2224 * With the new addsourcefile attribute, you can make <apply> ommit the
2225   source file names from the command line.  Bugzilla Report 13654.
2227 * <apply> and <chmod> now support nested <filelist>s as well as <dirset>s.
2228   Bugzilla Reports 15929 and 20687.
2230 * <apply> and <chmod> will display a summary if you set the new
2231   verbose attribute to true.  Bugzilla Report 19883.
2233 * <copy>/<move>'s failonerror attribute can now also be used to
2234   continue the build if an I/O error caused a problem.  Bugzilla
2235   Report 12999.
2237 * new selector <type/> allowing to select only files or only directories.
2238   Bugzilla Report 20222.
2240 * <java> and <junit> now support a nested <bootclasspath> element that
2241   will be ignored if not forking a new VM.
2243 * <junit>'s nested <formatter> elements now support if/unless clauses.
2245 * <ejbjar>
2246   cmpversion attribute added
2247   jboss element will look for jbosscmp-jdbc.xml descriptor
2248   if ejbjar has cmpversion="2.0" set
2249   Bugzilla Reports 14707 and 14709.
2251 * <pvcs> config attribute added to set the location of a specific PVCS
2252   .cfg file
2253   Bugzilla Report 9752
2255 * <mapper> has an "unpackage" mapper
2256   Bugzilla Report 18908
2258 * Added <scriptdef> task allowing tasks to be defined using any BSF-supported
2259   scripting language.
2261 * <touch>'s datetime attribute can now accept time with a granularity
2262   of seconds as well.  Bugzilla Report 21014.
2264 * <checksum> has two new properties: totalproperty and todir.
2266 * FileUtils#createTempFile will now create temporary files in the
2267   directory pointed to by the property java.io.tmpdir
2269 * <unzip> and friends now supports an optional encoding attribute to
2270   enable it to expand archives created with filenames using an encoding
2271   other than UTF8.  Bugzilla Report 10504.
2273 * <patch> has a new attribute destfile that can be used to create a new
2274   file instead of patching files in place.
2276 * OpenVMS is detected as a valid OS family.
2278 * DirectoryScanner has been optimized for cases where include patterns do not
2279   start with wildcards.  Bugzilla Report 20103.
2281 * DirectoryScanner begins to be optimized not to scan excluded directories.
2282   Bugzilla Report 21941.
2284 * Added keep-going feature. Bugzilla Report 21144
2286 * The archives generated by <zip> and friends will now contain CRC and
2287   size information in the "local file header", thereby providing this
2288   information to applications that read the archives using
2289   java.util.ZipInputStream.  Bugzilla Report 19195.
2291 * <copy> and <move> can now handle mappers that return multiple
2292   mappings per source path. This behaviour is enabled by using
2293   an enablemultiplemapping attribute. Bugzilla Report 21320.
2295 * <exec> will now work on OpenVMS (please read the notes in
2296   <exec>'s manual page).  Bugzilla Report 21877.
2298 * <exec> will now have a new attribute spawn (default false).
2299   If set to true, the process will be spawned. Bugzilla Report 5907.
2301 * <java> will now have a new attribute spawn (default false).
2302   If set to true, the process will be spawned. Bugzilla Report 5907.
2304 * <parallel> now supports a timeout which can be used to recover
2305   from deadlocks, etc in the parallel threads. <parallel> also
2306   now supports a <daemons> nested element. This can be used to
2307   run tasks in daemon threads which the parallel task will not
2308   wait for before completing. A new attribute failonany will cause
2309   <parallel> to throw an exception if any thread fails without
2310   waiting for all other threads to complete.
2312 * <zip> and friends will consume far less memory than they used to
2313   when run with compress="false".  Bugzilla Report 21899.
2315 * <if/> and <unless/> attributes added to <param/> element of <style>
2316    Bugzilla Report 22044
2318 * <zip> and friends have a new attribute "keepcompression" that can be
2319   used to incrementally build an archive mixing compressed and uncompressed
2320   entries.
2322 * <junit>'s XML formatter adds a new classname attribute to the <testcase>
2323   elements.
2325 * new <permissions> type add permission handling to the code
2326   this type can be nested in the <java> and <junit> tasks.
2327   Bugzilla Report 22533.
2329 * additional shortcuts for ant options (-d --> -debug, -e --> -emacs,
2330   -h --> -help, -p --> -projecthelp, -s --> -find).
2332 * new selector <modified>. "cache" was renamed to "modified".
2333   Bugzilla Report 20474.
2335 * <stcheckout> and <stlist> have a new asofdate attribute that can be
2336   used to checkout/list files based on a date instead of a label.
2337   Bugzilla Report 20578.
2339 * New filter <concatfilter>. Adds the content of file at the beginning
2340   or end of a file. Discussion started at
2341   http://marc.theaimsgroup.com/?l=ant-user&m=106366791228585&w=2
2343 * New task <import>
2345 * New task <macrodef>
2347 * New task <presetdef>
2349 * Ant libraries that can make use of namespaces to avoid name
2350   clashes of custom tasks
2352 * <java> and <junit> now support <assertions>, which let you enable
2353   and disable Java1.4 assertions on a package or class basis. These
2354   only work when fork=true, currently.
2356 * .NET tasks expanded with VB support <vbc> and J#, via <jsharp>,
2357   <importtypelib> and <ilasm>. <csc> supports nested <src> types,
2358   <defines> for (potentially conditional) definitions, <reference>
2359   filesets for references. The executable attribute lets you switch to
2360   mono or other implementations -<csc> has been tested with Mono on
2361   Linux and OSX.
2364 Changes from Ant 1.5.3 to Ant 1.5.4
2365 ===================================
2367 Changes that could break older environments:
2368 --------------------------------------------
2370 * If the Visual Age tasks used to work for you, they may stop doing so
2371   now - and we'd like to know about it.  The current set of tasks is
2372   supposed to work with any version of VAJ starting with 3.0.
2374 Fixed bugs:
2375 -----------
2377 * The Visual Age for Java tasks didn't work (at least for versions 3.0
2378   and higher).  Bugzilla Report 10016.
2380 * URL-encoding in <vaj*port> didn't work properly.
2382 * VAJRemoteUtil called getAbsolutePath instead of getPath
2383   causing problems when using a Windows VAJ server from a UNIX server.
2384   Bugzilla Report 20457.
2386 * VAJImport task failed with NullPointerException when using DirectoryScanner.
2387   Bugzilla Report 22080.
2389 Other changes:
2390 --------------
2392 * Shipped XML parser is now Xerces 2.5.0
2394 * <javah> will invoke oldjavah on JDK 1.4.2.  Bugzilla Report 18667.
2396 * The VAJ tasks now support a haltonfailure attribute to conditionally
2397   keep building even if they fail.
2399 * It is now possible to use the latest (versioned or unversioned) edition
2400   in <vajload> by using special wildcard characters.  Also fixes
2401   Bugzilla Report 2236.
2403 Changes from Ant 1.5.2 to Ant 1.5.3
2404 ===================================
2406 Changes that could break older environments:
2407 --------------------------------------------
2409 * The <zip> task and friends have again changed a method signature
2410   (sorry, was necessary to fix bug 17780).  The return type of
2411   getResourcesToAdd has changed.
2413 Fixed bugs:
2414 -----------
2416 * <zipfileset>'s filemode would get ignored and the dirmode was used
2417   for the included files as well.  As a side effect, WinZIP was unable
2418   to extract or display the files, so they seemed to be missing from
2419   the archive.  Bugzilla Report 17648.
2421 * <ftp> could use the wrong path separator when trying to change the
2422   remote working directory.  Bugzilla Report 17735.
2424 * <jar update="true"> would loose all original files if you didn't
2425   specify any nested <(zip)fileset>s and the manifest had changed.
2426   Bugzilla Report 17780.
2428 * If you used a value starting with \ on Windows for the appxml
2429   attribute of <ear> or the webxml attribute of <war>, it would be
2430   ignored.  Bugzilla Report 17871.
2432 * Ant will no longer implicitly add Sun's rt.jar in <javac> when you
2433   use jvc and don't specify a bootclasspath.  Bugzilla Report 18055.
2435 * The prefix attribute of <zipfileset> would not generate directory
2436   entries for the prefix itself.  Bugzilla Report 18403.
2438 * starteam checkout can now handle deleted labels.  Bugzilla Report 17646.
2440 * The Unix wrapper script failed if you invoked it as a relative
2441   symlink and ANT_HOME has not been set.  Bugzilla Report 17721.
2443 Other Changes:
2444 --------------
2445 * Added ability to specify manifest encoding for the <jar> and
2446   <manifest> tasks
2448 Changes from Ant 1.5.1 to Ant 1.5.2
2449 =============================================
2451 Changes that could break older environments:
2452 --------------------------------------------
2453 * ANT_OPTS environment variable is now applied at the start of the
2454   Java command line, allowing position specific parameters of some
2455   JVMs, such as -classic to be specified.
2457 * ZipScanner#getIncludedFiles will now return the names of the ZipEntries
2458   that have been matched instead of the name of the archive.
2460 * The <zip> task and friends have been heavily modified, almost every
2461   method signature of the Zip class has changed.  If you have subclassed
2462   Zip (or one of its subclasses), your class will most likely not
2463   compile against the current code base.  If it still compiles, it will
2464   probably not work as in Ant 1.5.1.
2466 Fixed bugs:
2467 -----------
2468 * <translate> was not ignoring comment lines.
2470 * <manifest> wouldn't update an existing manifest if only an attribute
2471   of an existing section changed.
2473 * ant.bat now supports the ANT_ARGS and JAVACMD environment variables
2474   again (like Ant 1.5 did).
2476 * The "plain" <junit> <formatter> could throw a NullPointerException
2477   if an error occurred in setUp.
2479 * <junit> will now produce output when a test times out as well.
2481 * <replace> would count some internal character replacements when
2482   reporting the number of replaced tokens.
2484 * <concat> would cause an exception if a <filelist> pointed to files
2485   that do not exist.
2487 * <javadoc> will now pass -source to custom doclets as well.
2489 * <cvstagdiff> would throw a NullPointException if there had been no
2490   differences.
2492 * <cvschangelog> could miss today's changes.
2494 * <concat> could append newline characters between concatenated files.
2496 * <xmlvalidate> ignored the specified encoding of the files to
2497   validate.
2499 * the errorsbeginat attribute of the <http> condition didn't work.
2501 * Ant will try to force loading of certain packages like com.sun.*
2502   from the system classloader.  The packages are determined by the
2503   version of the JVM running Ant.
2505 * Ant didn't find the runtime libraries on IBM's JDK 1.4 for Linux.
2507 * random component of temporary files is now always a positive integer.
2509 * Ant could incorrectly try to use the 1.4 regexp implementation even
2510   if it isn't available if you run the JVM with -Xverify:none.
2512 * Ant would die with an exception if you used nested <reference>
2513   elements in Ant and the refid attribute didn't point to an existing
2514   project reference.
2516 * The <get> task can now be compiled (and Ant thus bootstrapped) using
2517   Kaffee.
2519 * build.sysclasspath will now be honored by more tasks.
2521 * The signjar keystore attribute has been reverted to a String allowing
2522   it to once again accept URLs. This should not affect current File based usage
2523   unless you are extending the Signjar task.
2525 * <jar update="true"> would remove the original manifest.
2527 * fix up folder creation in PVCS task
2529 * <tar>'s up-to-date check didn't work for nested <(tar)fileset>s.
2531 * Corrected a problem in XMLLogger where it would not associated
2532   messages with a taskdef'd task
2534 * <uptodate> now works when using attributes (i.e. not filesets) and pointing
2535   to the same file
2537 * Java task (and output system) now stores output which doos not end
2538   with a line feed.
2540 * splash screen wouldn't disappear when build was finished.
2542 * <exec> now supports OS/2.
2544 * <zip> and friends would only update/recreate existing archives if
2545   the files to add/update have been newer than the archive.
2547 * <javadoc>'s <link> element could fail for offline="true" on some JDKs.
2549 Other changes:
2550 --------------
2552 * MailLogger now sets the Date header correctly.
2554 * Shipped XML parser is now Xerces 2.3.0
2556 * signjar now accepts a maxmemory attribute to allow the memory allocated to the
2557   jarsigner tool to be specified. The jarsigner from the JDK's JAVA_HOME bin
2558   dir is now used rather than the first jarsigner on the path.
2560 * **/.DS_Store has been added to the list of default pattern excludes.
2562 * The Created-By header in the default manifest now contains the JVM
2563   vendor and version according to the jar specification. A new header,
2564   Ant-Version provides the Ant version used to create the jar.
2566 * <zip> can now store Unix permissions in a way that can be
2567   reconstructed by Info-Zip's unzip command.
2569 Changes from Ant 1.5.1Beta1 to 1.5.1
2570 ====================================
2572 Fixed bugs:
2573 -----------
2575 * <tstamp>'s prefix attribute failed to apply to nested <format> elements.
2577 * <junitreport> created an empty junit-noframes.html if no format had
2578   been specified.
2580 * <basename> would remove more than it should if the file name
2581   contained more than one dot.
2583 * <filterset>s nested into <filterset>s didn't work.
2585 Other changes:
2586 --------------
2588 * Shipped XML parser is now Xerces 2.2.0
2590 * Filesets now support a 'file' attribute, allowing a single-file
2591   fileset to be constructed without having to specify its parent
2592   directory separately.
2594 * <junit> will now return the result of a call to getName instead of
2595   "unknown" for Test implementations that don't extend TestCase but have
2596   a public String getName() method.
2598 Changes from Ant 1.5 to 1.5.1Beta1
2599 ==================================
2601 Fixed bugs:
2602 -----------
2603 * Date/time in CvsChangeLog was in local timezone and 12 hour format leading
2604   to a problem when sorting by time. It is now UTC (GMT) and in 24-hour
2605   format as per cvs 'specifications'.
2607 * CvsTagDiff now supports ampersand modules or modules that have a different
2608   root directory than their name.
2610 * EjbJar threw NPEs for the Websphere element. The property 'websphere.home'
2611   was not documented.
2613 * Mail example in the documentation was not correct.
2615 * Checksum was broken in the following scenario:
2616   (using verifyproperty OR in a condition) AND using filesets
2617   with multiple files.
2619 * The ExpandProperties filter threw NPEs when defined using
2620   the <filterreader> format.
2622 * The sh wrapper script didn't work under Cygwin if ANT_HOME wasn't
2623   set with a Unix style filename.
2625 * The sh wrapper script could fail if you started Ant from a directory
2626   with whitespace in its name.
2628 * ant -diagnostics was not working properly when the task dependency
2629   was missing and was just printing the missing dependency.
2631 * If a task got redefined via <taskdef>, it lost its child elements.
2633 * <property>'s classpathref attribute was broken.
2635 * <arg line="''" /> would result in no command line argument, will now
2636   be a single empty argument.  Use <arg value="''"/> if you need the
2637   quotes literally.
2639 * <replaceregexp> could append a newline character at the end of the
2640   file.
2642 Other changes:
2643 --------------
2645 * Appendix E of Java Development with Ant (Loughran/Hatcher) was
2646   contributed to the docs.
2648 * <available> will only print deprecration warnings if it is actually
2649   used to change the value of a property.
2651 Changes from Ant 1.5beta3 to Ant 1.5
2652 ====================================
2654 Changes that could break older environments:
2655 --------------------------------------------
2657 * The filesetmanifest attribute added to <jar> after the 1.4.1
2658   release has been removed for now.  This change may affect only
2659   the 1.5Beta/1.6Alpha users.  An attempt will be made to add this
2660   feature back into Ant 1.6.
2662 Fixed bugs:
2663 -----------
2665 * <zip> and friends would always update existing archive if you set
2666   the update attribute to true.
2668 * To support backward compatibility with older versions, <pathconvert>
2669   will once again set the property, even if the result is the empty
2670   string, unless the new 'setonempty' attribute is set to false|no|off
2671   (default is "true").
2673 * The manifest task would crash XmlLogger
2675 Other changes:
2676 --------------
2678 * added **/.svn and **/.svn/** to the default excludes
2680 Changes from Ant 1.5beta2 to Ant 1.5beta3
2681 =========================================
2683 Changes that could break older environments:
2684 --------------------------------------------
2686 * <pvcs> default filenameformat has been different from Ant 1.4.1.
2687   Now it is different from 1.5beta1 and 1.5beta2.
2689 * <pathconvert> won't set the property if the result is the empty string.
2691 Fixed bugs:
2692 -----------
2694 * <available> could fail to find files or directories that happen to
2695   start with the name of the project's basedir but are not children of
2696   the basedir.
2698 * Nested <property>'s inside <ant> can now be overriden by subsequent
2699   <ant> and <antcall> tasks.
2701 * <xslt>'s outputtype attribute wouldn't do anything.
2703 * <linecontains> filterreader could swallow lines.
2705 * <sequential> used to configure the tasks (set their attributes)
2706   before the first task has been executed.  This means that properties
2707   that have been set by nested task seemed to be unset for the other
2708   tasks in the same <sequential> element.
2710 * <javac>'s sourcepath setting has been ignored by some compiler
2711   implementations.
2713 * <javadoc>'s packagelist attribute didn't work.
2715 * the plain mailer would always use port 25 in <mail>.
2717 * Ant's default logger could swallow empty lines.
2719 * ejbjar's iPlanet nested element now can process multiple descriptors.
2721 * IPlanetEjbc was looking in the wrong place for four iiop files.
2723 * <javac> would pass the -source switch to JDK 1.3's javac, even
2724   though it doesn't support it.
2726 Other changes:
2727 --------------
2729 * <checksum> now uses a buffer (of configurable size).
2731 * The "Trying to override task definition" warning has been degraded
2732   to verbose level if the two task definitions only differ in the class
2733   loader instance that has loaded the definition.
2735 * Add a jvmargs to the ejbjar's weblogic element to allow additional
2736   arguments to be provided to the VM runnign ejbc. Document the
2737   jvmdebuglevel attribute which can be used to avoid warnings about
2738   interface classess being found on the classpath. Document the new
2739   <sysproperty> element which allows JVM properties to be defined.
2740   Added an outputdir attribute to allow the destination to be a
2741   directory into which the exploded jar is written.
2743 * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
2745 Changes from Ant 1.5beta1 to Ant 1.5beta2
2746 =========================================
2748 Changes that could break older environments:
2749 --------------------------------------------
2751 * Properties will now be expanded in mail message bodies.  This means
2752   that one $ sign will be stripped if your mail message contains the text $$.
2754 * org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
2756 * Available#setFile now again uses a File argument as it did in 1.4,
2757   this may break environments that have been adapted to the String
2758   argument version present in 1.5beta1.
2760 Fixed bugs:
2761 -----------
2762 * When <move> attempts a rename, it deletes the destination file, if it
2763   exists, before renaming the source file.  However, <move> was not
2764   checking if the destination file was actually a directory before
2765   trying to delete it.
2767 * Make CVS Tasks to work under Cygwin.
2769 * Fix LineContains to handle huge files elegantly without causing
2770   Stack Overflows.
2772 * if you ask for the "classic" compiler on Java1.4, you get upgraded to
2773   "modern" because there is no classic compiler any more.
2775 * the <http> condition was viewing 404 'not found' exceptions as success. Now
2776   it defaults to viewing any response >=400 as an error, and has an
2777   errorsBeginAt attribute you can use if you want a higher or lower value.
2779 * <get> throws a build exception on an http authorization error, unless you
2780   have set ignoreerrors to true.
2782 * <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
2783   case, though the old spelling is retained for anyone who used it.
2785 * Merging of Manifests in jar now works as documented.
2787 * paths that have been separated by colons would be incorrectly parsed
2788   on NetWare.
2790 * runant.pl now supports NetWare.
2792 * <tempfile> and <setproxy> tasks were in beta1, but not defined by
2793   default; They now are. <tempfile> fills a property with the name of a
2794   temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
2795   settings.
2797 * <available classname="foo" ignoresystemclasses="true"> failed for
2798   JDK 1.1 and 1.2, even if the class could be found on the
2799   user-specified classpath.
2801 * <property environment=... /> now works on z/OS.
2803 * forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
2804   use a temporary file to hold the names of the files to compile under
2805   some conditons, but 1.1 doesn't support this feature.  Ant will no
2806   longer try this, but you may run into problems with the length of the
2807   command line now.
2809 * the refid attribute for <property>s nested into <ant> or <param>s
2810   nested into <antcall> didn't work.
2812 * <replaceregexp> didn't work for nested <fileset>s.
2814 * <javadoc> dropped sourcepath entries if no "interesting" .java
2815   source files  could be found below them.  This has been backwards
2816   incompatible and caused problems with custom doclets like xdoclet.
2818 * Using the doclet, docletpath or docletpathref attributes of
2819   <javadoc> may have caused NullPointerExceptions.
2821 * nested <filesets> of <javadoc> would include too much.
2823 * <dependset> will no longer choke on <targetfileset>s that point to
2824   non-existing directories.
2826 * <patch> didn't work at all.
2828 * <replace> and <replaceregexp> now fail if the file they are working
2829   on is locked.
2831 * <javadoc> would pick up the wrong executable in the combination JDK
2832   1.2 and AIX.
2834 Other changes:
2835 --------------
2837 * z/OS now gets detected by the os condition.
2839 * <fileset> and <dirset> now have an optional followsymlink attribute
2840   that can prevent Ant from following symbolic links on some platforms.
2842 * BeanShell is now supported in the <script> task.
2844 * <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
2845   based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
2846   this ejbc class has been deprecated. To avoid the deprecation warning use
2847   ejbcclass="weblogic.ejbc".
2849 * <ejbjar> will add a manifest to the generated jar based on the naming
2850   convention in use. This overrides the manifest specified in the
2851   <ejbjar> attribute
2854 Changes from Ant 1.4.1 to 1.5beta1
2855 ==================================
2857 Changes that could break older environments:
2858 --------------------------------------------
2860 * Important: Single $ signs are no longer silently stripped!
2861   Before you panic that we have broken all your build files, we have kept
2862   the old "$$" -> "$" behaviour. So only build files which accidentally had
2863   a $ sign in a string that was being silently stripped may break.
2864   We added this fix to stop newbie confusion; if you want to write a
2865   build file which works on ant versions 1.4.1 or earlier, stay with
2866   the double $$ sign rule.
2868 * Project.getBuildListeners now returns a clone of the listener
2869   list. Changes to the returned list will not affect the listeners
2870   currently attached to the Project. It also means that it is safe to
2871   iterate over the returned list if listeners are added or removed
2872   during the traversal.
2874 * <pvcs> default filenameformat has been different from Ant 1.4.1.
2876 * Some messages that are printed during startup will not be
2877   written to the logfile specified via -logfile as they might destroy
2878   the format of the file for special BuildLoggers (like XmlLogger).
2880 * The filesetmanifest attribute added to <jar> after the 1.4.1
2881   release has been removed for now.  This change may affect only
2882   the 1.5Beta/1.6Alpha users.  An attempt will be made to add this
2883   feature back into Ant 1.6.
2884 * Shipped XML parser is now Xerces 2.0.1 along with the XML Parser APIs.
2885   XML Parser APIs is a separate jar that contains the necessary
2886   JAXP/DOM/SAX classes.
2888 * <telnet> was fixed to expand properties inside nested <read> and
2889   <write> elements; before this only happened when you assigned the text
2890   to the string attribute. If you had $ signs in the string, they may
2891   need escaping.
2893 * the RegexpMatcher interface has been extended to support case
2894   insensitive matches and other options - custom implementations of
2895   this interface won't work any longer.  We recommend to use the new
2896   Regexp interface that also supports substitution instead of the
2897   RegexpMatcher interface in the future.
2899 * <gzip> will throw an exception if your src attribute points to a directory.
2901 * Unjar, Unzip and Unwar will throw an exception if the Src attribute
2902   represents a directory.  Support for nested filesets is provided
2903   instead.
2905 * It is no longer possible to overwrite a property using tasks like
2906   <condition>, <exec>, <pathconvert>, or <tstamp>. In some exceptional
2907   cases it will generate a warning if you attempt to overwrite an
2908   existing property.
2910 * Taskwriters please note: Whenever tasks had any overloaded set* methods,
2911   Ant's introspection mechanism would select the last overloaded method
2912   provided to it by the Java Runtime.  A modification has now been made such
2913   that when the Java Runtime provides a method with a String as its argument,
2914   a check is made to see if there is another overloaded method that takes in
2915   some other type of argument.  If there is one such method, then the method
2916   that takes in String as an argument is not selected by the Introspector.
2918 * The pattern definition **/._* has been included into the Default
2919   Excludes list.
2921 * <propertyfile>'s <entry> element was modified to remove "never" as a value
2922   as its behavior was undocumented and flakey.
2924 * The -projecthelp flag now only prints out targets that include the
2925   'description' attribute, unless the -verbose or -debug flag is included
2926   on the Ant command line.
2928 * Ant's testcases now require JUnit 3.7 or above, as they now use the new
2929   assertTrue method instead of assert.
2931 * If the 'output' attribute of <ant> is set to a simple filename or a
2932   relative path, the file is created relative to ${basedir}, not ${user.dir}.
2934 * The default value for build.compiler is now javac1.x with x
2935   depending on the JDK that is running Ant instead of classic/modern.
2937 Fixed bugs:
2938 -----------
2940 * <available> could fail to find files or directories that happen to
2941   start with the name of the project's basedir but are not children of
2942   the basedir.
2944 * Nested <property>'s inside <ant> can now be overriden by subsequent
2945   <ant> and <antcall> tasks.
2947 * <xslt>'s outputtype attribute wouldn't do anything.
2949 * <linecontains> filterreader could swallow lines.
2951 * <sequential> used to configure the tasks (set their attributes)
2952   before the first task has been executed.  This means that properties
2953   that have been set by nested task seemed to be unset for the other
2954   tasks in the same <sequential> element.
2956 * <javac>'s sourcepath setting has been ignored by some compiler
2957   implementations.
2959 * <javadoc>'s packagelist attribute didn't work.
2961 * the plain mailer would always use port 25 in <mail>.
2963 * Ant's default logger could swallow empty lines.
2965 * ejbjar's iPlanet nested element now can process multiple descriptors.
2967 * IPlanetEjbc was looking in the wrong place for four iiop files.
2969 * <javac> would pass the -source switch to JDK 1.3's javac, even
2970   though it doesn't support it.
2972 * <zip> and friends would always update existing archive if you set
2973   the update attribute to true.
2975 * To support backward compatibility with older versions, <pathconvert>
2976   will once again set the property, even if the result is the empty
2977   string, unless the new 'setonempty' attribute is set to false|no|off
2978   (default is "true").
2980 * The manifest task would crash XmlLogger
2982 * A bug existed that prevented generated log files from being deleted as
2983   part of the build process itself.  This has now been fixed.
2985 * Fixed bug where <move> ignored <filterset>s.
2987 * Ant works properly with the combination of Java1.4/WindowsXP.
2989 * Fixed bug where <java> used to sometimes invoke class constructors twice.
2991 * Fixed bug with 4NT shell support.
2993 * Fixed bug where ant would not perform ftp without remotedir being
2994   specified even though this was not mandatory.
2996 * Fixed bug where ant would not copy system properties into new Project
2997   in ant/antcall tasks when inheritall="false" is set.
2999 * <propertyfile> would not close the original property file.
3001 * <ant> will no longer override a subbuild's basedir with inheritall="true".
3003 * Fixed problem with the built-in <junit> formatters which assumed
3004   that only one test could be running at the same time - this is not
3005   necessarily true, see junit.extensions.ActiveTestSuite.
3007 * <jar>'s whenEmpty attribute is useless as JARs are never empty, they
3008   contain at least a manifest file, therefore it will now print a
3009   warning and do nothing.
3011 * <typedef> hasn't been all that useful as it couldn't be used outside
3012   of targets (it can now) and nested "unknown" elements have always
3013   been considered to be tasks (changed as well).
3015 * <fixcrlf> would fail for files that contained lines longer than 8kB.
3017 * Some junit formatters incorrectly assumed that all testcases would
3018   inherit from junit.framework.TestCase.
3020 * <fixcrlf> dropped the first characters from Mac files.
3022 Other changes:
3023 --------------
3025 * <checksum> now uses a buffer (of configurable size).
3027 * The "Trying to override task definition" warning has been degraded
3028   to verbose level if the two task definitions only differ in the class
3029   loader instance that has loaded the definition.
3031 * Add a jvmargs to the ejbjar's weblogic element to allow additional
3032   arguments to be provided to the VM runnign ejbc. Document the
3033   jvmdebuglevel attribute which can be used to avoid warnings about
3034   interface classess being found on the classpath. Document the new
3035   <sysproperty> element which allows JVM properties to be defined.
3036   Added an outputdir attribute to allow the destination to be a
3037   directory into which the exploded jar is written.
3039 * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
3041 * added **/.svn and **/.svn/** to the default excludes.
3043 * Selector Elements now provide a way to create filesets based on
3044   sophisticated selection criteria.
3046 * Gzip and Bzip2 files can now be constructed in the fly when using
3047   the tar task without having to create the intermediate tar file on
3048   disk.  The Untar task can also untar GZip and BZip2 files on the fly
3049   without creating the intermediate tar file.
3051 * New optional type, <classfileset> added.
3053 * <ejbjar> now allows control over which additional classes and interfaces
3054   are added to the generated EJB jars. A new attribute "dependency" can be
3055   defined which controls what classes are added. The addition of classes now
3056   uses the Jakarta-BCEL library rather than reflection, meaning bean classes are
3057   no longer loaded into Ant's JVM. The default dependency analyzer is known as
3058   the ancestor analyzer. It provides the same behaviour as the 1.4.1 version of
3059   <ejbjar>. If the BCEL library is not present, a warning will be issued stating
3060   the ancestor analyzer is not available. In this case <ejbjar> will continue
3061   to function but will not add super classes to the jar.
3063 * <available> has a new attribute named ignoreSystemClasses.
3065 * New task <cvschangelog/> generates an XML report of changes that occur
3066   on CVS repository.
3068 * New filter readers: ClassConstants, ExpandProperties, HeadFilter,
3069   LineContains, LineContainsRegExp, PrefixLines, ReplaceTokens,
3070   StripJavaComments, StripLineBreaks, StripLineComments, TabsToSpaces,
3071   TailFilter.
3073 * <copy>, <loadfile>, <loadproperties>, <move> support FilterChains
3074   of FilterReaders.
3076 * New task <loadproperties> to load contents of file as Ant properties,
3077   with nested <filterchain> elements.
3079 * New task <loadfile> to load a whole file into a property.
3081 * New task <echoproperties> to list your current properties to the screen
3082   or a file.
3084 * New tasks <bzip2> and <bunzip2> to pack and unpack files using the
3085   BZip2 alogrithm.
3087 * New tasks <replaceregexp>, <checksum>, <translate>, <waitfor>,
3088   <manifest>, <vsscp>, <vssadd>, <vsscreate>, <splash>, <basename>, <dirname>,
3089   <concat>, <sourceoffsite>, <jarlib-available>, <jarlib-display>,
3090   <jarlib-manifest>, <jarlib-resolve>.
3092 * A new combined <mail> task, which replaces the old <mail> and
3093   <mimemail> tasks, has been added.  The <mimemail> task, and
3094   old SendEmail and MimeMail classes have been deprecated.
3096 * Mail task allows specification of port number.
3098 * Users can control what <zip> and <jar> must do when duplicate files
3099   are found.  A new element <zipgroupfileset> allows for multiple zip
3100   files to be merged into the archive.  In addition, <jar> also has
3101   another new attribute: filesetmanifest.  The existing manifest
3102   attribute of <jar> now also accepts the name of a jar added through
3103   a fileset.
3105 * gzip now checks that the zipfile is older than the source file
3106   before rebuilding the zipfile.
3108 * TarFileset takes in three new attributes - fullpath, prefix
3109   and preserveLeadingSlashes.
3111 * <move> attempts to rename the directory, if everything inside it is
3112   included, before performing file-by-file moves.  This attempt will
3113   be done only if filtering is off and if mappers are not used.  This
3114   is a performance improvement and there is no change otherwise in
3115   the funtionality of this task.
3117 * Exec task has extra attribute "resultproperty" to get the return code
3118   into a property.
3120 * Exec task prints a message when a timed-out process is killed.
3122 * Added optional attributes - name, arch and version to the <os> task.
3124 * Unjar, Untar, Unwar and Unzip now support patternsets to
3125   select files from an archive for extraction.  Filesets may be
3126   used to select archived files for unarchival.
3128 * Javac task allows debug levels to be specified.  Debug levels
3129   will have an effect only when the modern compiler or the
3130   classic compiler (version 1.2 and higher) is used and debugging
3131   is enabled.
3133 * Added support for specifying CVS_RSH in the <cvs/> task
3135 * The attributes zipfile, jarfile, warfile and earfile (from the Zip,
3136   Jar, War and Ear tasks) have been deprecated and superseded by a
3137   new attribute "destfile".
3139 * Added new conditions <isset>, <checksum>, <http>, <socket>, <contains>,
3140   <filesmatch>.
3142 * <taskdef> and <typedef> will now emit a warning if a task/type of
3143   the given name already exists.
3145 * A new revision of VAJ tasks: The most important new feature
3146   is the ability to execute VAJ tasks from the command line by
3147   exploiting the Remote Tool Access feature of VAJ.
3149 * Improved support for Novell NetWare.
3151 * Added an optional encoding attribute to <fixcrlf>.
3153 * <apply> has a new attribute relative that allows users to pass the
3154   filenames as relative instead of absolute paths on the command line.
3156 * References can now be copied into the child build by <ant> and
3157   <antcall> using nested <reference> elements or the new inheritRefs
3158   attribute.
3160 * <fail> now supports builds to fail based on conditions via if and
3161   unless attributes.
3163 * Ant now comes with two new BuildLogger implementations - one that
3164   can send emails containing a log of the build process (MailLogger),
3165   and one that colorizes the output based on message levels, using
3166   ANSI color code escape sequences (AnsiColorLogger).
3168 * A "package" mapper type has been added to allow package directory
3169   names replaced with the dotted form.
3171 * You can now specify environment variables in the <java> and <junit> tasks
3172   if the fork attribute has been set to true.
3174 * -propertyfile command-line option has been added to load an entire
3175   property file just as -D properties are declared (as user properties).
3176   -D properties take precedence over -propertyfile specified ones.
3178 * You can now set an ANT_ARGS environment variable to hold arguments you
3179   always want passed to the 'ant' command -- for example, if you always
3180   want to use a different logger or the -find flag.
3182 * <tstamp> now supports a new "prefix" attribute to prefix properties set.
3184 * You can now specify the -sourcepath for <javac> explicitly.
3186 * <javac> now supports a new "listfiles" attribute to list the source
3187   files it's handing off to the compiler.
3189 * The compiler implementation for <javac> can now be chosen on a task by
3190   task basis.  The new "compiler" attribute of <javac> can be used to override
3191   the value of the build.compiler property, if set.
3193 * <javac> has a new nested element, <compilerarg>, which allows you
3194   to specify additional args for the specific compiler you're using.
3196 * <javac>'s "source" attribute is now enabled for jikes as well.
3198 * <propertyfile>'s <entry> now has a 'unit' attribute to specify the
3199   increment/decrement unit on date operations.
3201 * <property> now supports a 'prefix' attribute when loading from a file
3202   or resource.
3204 * In Ant 1.4, a feature has been added to the <junit> task that would
3205   add ant.jar, optional.jar and junit.jar implicitly to the classpath -
3206   this feature can now be disabled by setting the new includeantruntime
3207   attribute to false.
3209 * <style> behaves differently from any other directory-based task, as it
3210   processes all files that it finds in included directories in
3211   addition to the files matched by your patterns.  There is now a new
3212   attribute, 'scanincludeddirectories', to suppress this behavior.
3214 * <javadoc> now supports a <tag> nested element to provide the -tag option
3215   to the standard Java 1.4 doclet. The element is ignored when not running
3216   on Java 1.4.
3218 * <ftp> can now chmod files on a remote server that supports
3219   "site chmod", as well as set the umask before transferring files, if
3220   the server supports "site umask".
3222 * New <serverdeploy> "optional" task.
3224 * <patternset> now supports nested patternsets.
3226 * Perforce tasks now support a "failonerror" attribute (defaults to "true").
3228 * Open Source application server JOnAS support:
3229     EJB hot deploy and deploy with <serverdeploy> and <ejbjar>
3231 * Added new DirSet (<dirset>) datatype.
3233 * <path> now supports nested <dirset> and <filelist> elements.
3235 * <pathconvert> now supports nested <dirset> and <filelist> elements.
3237 * <pathconvert>'s "dirsep" and "pathsep" attributes now accept
3238   multi-character values.
3240 * <copy> task now has a 'failonerror' attribute to allow keep-going
3241   behaviour when the file to be copied is not found (defaults to "true").
3243 * <uptodate> now has a 'srcfile' attribute to allow specifying a
3244   full-path filename.
3246 * <exec>, <sql> and <java> now support append attributes to allow
3247   appending the output to an existing file.
3249 * <java> now supports a timeout attribute analog to <exec> - it is
3250   highly recommended to only use it together with fork="true".
3252 * <javadoc> now supports a source attribute to enable javadoc to
3253   handle assertions present in JDK 1.4 source code.
3255 * <replace> supports a new replacefilterfile attribute that
3256   automatically turns all properties of a given file into
3257   replacefilters.
3259 * An alias of <xslt> has been added to refer to the <style> task.
3261 * The compiler implementation for <rmic> can now be chosen on a task by
3262   task basis.  The new "compiler" attribute of <rmic> can be used to override
3263   the value of the build.rmic property, if set.
3265 * <rmic> has a new nested element, <compilerarg>, which allows you
3266   to specify additional args for the specific compiler you're using.
3268 * org.apache.tools.ant.XmlLogger now is a BuildLogger, rather than just
3269   a BuildListener. It can operate in either mode successfully.
3271 * <junit> has a new attribute "showoutput".  If set to true, output
3272   generated by tests will be sent to Ant's logging system as well as
3273   to the formatters (instead of sending it to the formatters
3274   exclusively).
3276 * Ant has now a pluggable way to prompt users for input, which is used
3277   by the new <input> task.  IDE integrators can provide an
3278   implementation of the InputHandler interface to decouple Ant's input
3279   from the console.  An implementation that gets its input from a file
3280   for unattended builds is part of Ant's distribution.
3282   For more details see docs/manual/inputhandler.html.
3284 * <patch> has a new attribute that selects the directory in which to
3285   run the command.
3287 * <javadoc> now supports two new nested elements, <fileset> and <packageset>.
3290 Changes from Ant 1.4 to Ant 1.4.1
3291 ===========================================
3293 Fixed bugs:
3294 -----------
3296 * <ant>'s antfile attribute will now also be considered an absolute path on
3297   Windows systems, if it starts with a \ and no drive specifier.
3299 * The fullpath attribute of <zipfileset> has been ignored if you used
3300   the src attribute at the same time.
3302 * The manifest file is now always placed as the second entry (after /META-INF)
3303   in generated jars. This allows the manifest to be read by JarInputStreams
3305 * Fixed bug in depend task which would fail with a NullPointerException if no
3306   dependency cache was specified.
3308 * sql task now handles REM statements correctly so that lines starying with rem
3309   but which are not comments are actually processed.
3311 * XMLLogger now uses the task's name rather than the classname
3313 * <mapper>s will now work as expected if the to pattern expands to an
3314   absolute pathname.
3316 * <javac> didn't ignore memory settings in non-fork mode
3318 * <cab> didn't split the options attribute into several command line
3319   arguments correctly.
3321 Other changes:
3322 --------------
3324 * New source attribute for <javac> to enable assertion in JDK 1.4
3326 * XmlLogger and <antstructure> now add an encoding declaration to the
3327   XML files they generate.
3329 * <fileset> has a new attribute "casesensitive" to make it match
3330   filenames in a case insensitive way (if you set it to false) - by
3331   default filesets remain case sensitive.
3333 Changes from Ant 1.3 to Ant 1.4
3334 ===========================================
3336 Changes that could break older environments:
3337 --------------------------------------------
3338 * JUnitReport now uses the xalan redirect extension for multi-output.
3339   With Xalan 1.2.2 it forces the use of bsf.jar in the classpath.
3340   (Available in the xalan distribution). It is recommended to switch
3341   to Xalan 2.x that do not need it.
3343 * Zip.setWhenempty() has changed its signature.
3345 * <rmic> is now implemented using a factory. This makes extending
3346   rmic to use a new compiler a lot easier but may break custom
3347   versions of this task that rely on the old implementation.
3349 * several Zip methods have changed their signature as we now use a Zip
3350   package of our own that handles Unix permissions for directories.
3351   Furthermore <zip> will now use the platform's default character
3352   encoding for filenames - this is consistent with the command line
3353   ZIP tools, but causes problems if you try to open them from within
3354   Java and your filenames contain non US-ASCII characters. Use the new
3355   encoding attribute of the task and set it to UTF8 to get the old
3356   behavior.
3358 * The <pvcs> task has been moved to a package of its own.
3360 * JUnitResultFormater has two additional methods that must be
3361   implemented by custom formatters.
3363 * Ant will no longer use the canonical version of a path internally -
3364   this may yield different results on filesystems that support
3365   symbolic links.
3367 * The output generated by the xml formatter for <junit> has changed
3368   again, it doesn't format the numeric value in the time attribute anymore.
3370 * Pattern matching rules have changes slightly, the pattern foo*
3371   doesn't match files contained in a directory named foo - use foo/*
3372   instead.
3374 * <fixcrlf> will not remove trailing whitespace at the end of lines anymore.
3376 * The Classloader usage has been changed for the taskdef, property, available
3377   and sql tasks so that it delegates to the parent classloader. This may cause
3378   ClassNotFoundExceptions to be thrown if a system class attempts to load a
3379   class in the taskdef's classpath (typically factory objects).
3381 * Ant now allows multithreading of tasks and the containment of tasks within
3382   other tasks. This can break customer listeners which do not expect messages
3383   from a task before the previous task has finished.
3385 * Ant now installs its own ouput stream into System.out to route output to the
3386   task currently executing on the current thread. This also means that all
3387   output is now routed as Ant message events. Customer listeners and loggers
3388   should not call System.out at any time. This has always been true but such
3389   usage now will cause problems due to possible recursion.
3391 * Invalid manifest files will now cause build failures in the <jar> task.
3393 * Ant Introspection now looks for methods with method names starting with
3394   addConfigured. When called these methods are passed an argument after it has
3395   been configured from the build file. Custom tasks supporting nested elements
3396   starting with the name configured will no longer function.
3398 * The environment variable JAVACMD that can be used to specify the
3399   java executable to Ant's wrapper scripts must not contain additional
3400   command line parameters any longer - please use the environment
3401   variable ANT_OPTS for such parameters now.
3403 * Ant's wrapper scripts now quote the CLASSPATH environment variable, thus
3404   supporting classpaths which refer to directories containing spaces. This means
3405   that the CLASSPATH environment variable cannot have quotes. Any quotes should
3406   be removed. This will not affect the operation of the CLASSPATH environment
3407   variable in other contexts.
3409 * A delete task like
3410   <delete includeEmptyFilesets="true">
3411     <fileset dir="somedir" />
3412   </delete>
3413   will now remove "somedir" as well, unless there are still files left
3414   in it (matched by the default excludes).
3416 * The copy task will now fail if the file to be copied is not found.
3418 * Ant properties defined in properties files now behave the same way as
3419   properties defined in the build file. In particular the $ character needs
3420   to be escaped in property values by doubling it to $$. So, to define a
3421   property with the value $hello, you need to define it in a properties file
3422   as
3423     test.prop=$$hello
3424   This was not the case in Ant 1.3
3426 Other changes:
3427 --------------
3429 * New tasks: ear, p4counter, record, cvspass, vsscheckin, vsscheckout,
3430   typedef, sleep, mimemail, set of tasks for Continuus/Synergy, dependset,
3431   condition, maudit, mmetrics, jpcoverage, jpcovreport, jpcovmerge
3433 * Ant now uses JAXP 1.1
3435 * rmic now supports Kaffe's and Weblogic's version of rmic.
3437 * new magic property build.rmic to chose the rmic implementation
3439 * <tar> will now add empty directories as well
3441 * you can now specify a description for <p4change>
3443 * <touch> can now work on <fileset>s
3445 * <uptodate> now supports a value attribute
3447 * <fail> supports nested text
3449 * <fixcrlf> won't override files that are already in the correct
3450    format.
3452 * <sql> now supports REM comments as well as // and --
3454 * <jar> now has a nested <metainf> element following the same idea as
3455   <war>'s <webinf>.
3457 * <pvcs> can now handle multiple projects.
3459 * <available> now has a "type" attribute you can use in conjunction
3460   with the "file" attribute to specify whether the "file" you're
3461   looking for is a file or a directory.
3463 * New <junit> formatter named "brief"
3465 * <ejbjar> changes
3466   * Add support for Borland Application Server to the <ejbjar> task using
3467     a <borland> nested element.
3468   * Add support for iPlanet Application Server to the <ejbjar> task. Also
3469     includes some iPlanet utility tasks
3470   * Add support for JBoss Application Server to the <ejbjar> task.
3471   * Add a naming attribute to control the naming scheme that
3472     ejbjar uses to name the generated EJB jars.
3473   * Weblogic element now sets the compiler class for EJB 2.0 beans
3474   * <dtd> elements can be specified at the <ejbjar> level for building generic
3475     beans
3476   * <dtd> elements can now be URLs
3477   * Allow the manifest to be specified for the generated jars
3478   * The weblogic element now supprts an attribte noEJBC to skip the processing
3479     of the jar by ejbc. The ejbc step will then occur at deployment
3480   * weblogic will tell ejbc to use Jikes compiler if build.compiler is set to
3481     jikes. It can be restored to the default, javac, operation if desired.
3483 * Allow the <sql> Delimiter to be set in the so that Oracle stored procs may be
3484   entered
3486 * <execon> and <apply> can now optionally skip empty filesets.
3488 * <javadoc> has a new useexternalfile attribute that makes it use a
3489   temporary file for sourcefile and package names - helps to defeat
3490   command line length limitations.
3492 * Data types like <path> can now be defined inside of <target>s
3494 * you can now specify a classpath for <style> - the XSLZ processor
3495   will be loaded from this path
3497 * added a force attribute to <style> to support dependencies that the
3498   task cannot determine itself (dependency on parameters, not file
3499   modification times for example)
3501 * added vmlauncher attribute to exec tasks. This defaults to true. If
3502   it is set to false, the VM's ability to launch commands in bypassed
3503   and the OS shell, either directly or through the auxillary antRun
3504   scripts is used.
3506 * regexp mapper now supports the java.util.regex package of JDK 1.4.
3508 * New filesonly attribute for <zip> and friends to suppress directory
3509   entries.
3511 * New update attribute for <zip> and friends - update an existing
3512   archive instead of creating a new one.
3514 * <apply> and <execon> have been merged into a single task.
3516 * added vssver.scc to the default excludes
3518 * <available> has a new filepath attribute/nested element that allows
3519   you top search for a file in a given path.
3521 * <junit> can now optionally set a property on test failure.
3523 * <taskdef> can now define several tasks at once, reading the
3524   name/classname pairs from a property file or resource.
3526 * <unzip/unjar/unwar> and <untar> now have an overwrite attribute that
3527   defaults to true.  If set to false, files that are newer than the
3528   files in the archive will not be replaced.
3530 * <patternset> and <fileset> now support nested <in/excludesfile>
3531   elements - using these you can have more than one in/excludes file
3532   per <patternset>.
3534 * Three new supported compilers for javac: kjc for kopi, gcj for the
3535   gcc frontend and sj for Symantec's compiler.
3536   In addition extJavac or the new fork attribute can be
3537   used to run the JDK's javac in a JVM separate from Ant.
3539 * <fixrlf> can now with CR only line-ends and can use an arbitraty
3540   between 2 and 80.
3542 * The .NET tasks have been adapted to the beta2 release of the framework.
3544 * <move> will now try to rename() files before copying them byte by
3545   byte - only if filtering is of, of course.
3547 * <ant> and <antcall> tasks now support a new attribute inheritAll. When set to
3548   false, only user properties are passed through to the target Ant instance.
3549   This includes properties set on the command line and properties explicitly
3550   passed
3552 * <javadoc> now skips off line links if the package list cannot be found.
3554 * <wlrun> now allows the security policy file to exist outside the weblogic
3555   directory.
3557 * <java> task will set the Thread contextClassLoader under JDKs 1.2+ to the
3558   classloader for the class being executed.
3560 * Introduce the concept of a TaskContainer - a task or element which can contain
3561   Ant Tasks.
3563 * Add new tasks implementing the TaskContainer interface <parallel> and
3564   <sequential> which allow parallel execution of tasks to be specified.
3566 * <depend> task will now take into account dependencies on jar files and class
3567   files from a given classpath.
3569 * <jar> manifest entries may now be specified in the build file either
3570   completely or to be merged with a manifest file.
3572 * <tstamp> task custom formats now support locales.
3574 * Added a listner which will forward events to Log4J. The log4j configuration
3575   file should be in the directory from which Ant is run or passed as a system
3576   property using a JVM argument.
3578 * Introduced the concept of <filtersets> to allow for more control in which
3579   filters get applied in a <copy> or <move> operation.
3581 * Added nowarn attribute to javac and deprecated the Jikes-magic property
3582   build.compiler.warnings.
3584 * The <depend> task cache format has changed and all dependency information is
3585   now stored in a single file.
3587 Fixed bugs:
3588 -----------
3590 * Testcases have been made independent of current working directory.
3592 * Input ZIP-Files will be closed when using a <zipfileset>.
3594 * p4 tasks now don't fail if user, port or client have been omitted
3595   (and this is acceptable for the context of the command).
3597 * <javah>'s outputfile attribute will be resolved as relative to the
3598   projects basedir.
3600 * <antstructure> should create a valid DTD for propertyfile.operation.entry
3601   and omit tasks it fails to load.
3603 * won't try to pass a -bootclasspath flag to javac 1.1 anymore
3605 * <style>'s style attribute no handles absolute paths correctly.
3607 * <delete includeemptydirs="true"> now deletes more than just the leaf
3608   directories.
3610 * You can now specify a <fileset> for a directory that doesn't exist at
3611   declaration time but will created before the fileset gets used for the
3612   first time.
3614 * If the quiet attribute has been set, <delete> will handle <fileset>s
3615   with non-existing directories gracefully.
3617 * Output written by testcases will now be captured by the <junit> task
3618   and passed to the formatters.
3620 * Quote the -group parameter to Javadoc as per the specification
3622 * Initialise classes when loaded through the AntClassLoader - that is, run
3623   static initializers
3625 * Implement getResource() and getResources() in AntClassLoader
3627 * Create the <ejbjar> weblogic command line as a set of arguments rather than
3628   as a single line. Avoids problems with paths which contain spaces.
3630 * <ejbjar> now fails when the weblogic ejbc compiler reports an error.
3632 * Make the AntClassLoader load resources in the same order as it currently
3633   loads classes.
3635 * Handle classpaths with spaces
3637 * Make sure XSLT processors close their output files in <style>.
3639 * perform proper uptodate check in <rmic> when compiling for IIOP.
3641 * <jjtree>'s uptodate test works even if outputdirectory is not the
3642   parent dir of target
3644 * <copy> will remove target file (if it exists) before writing to it -
3645   this avoids problems with links on filesystems that support them.
3647 * <ftp> now properly recurses remote directories.
3649 * <ftp> closes remote connection when it's done.
3651 * <junit> tries to include all necessary classes for the task itself
3652   to the classpath when running in fork mode - doesn't work for JDK 1.1
3654 * <apply> and <execon> do now execute the command only once, if you
3655   specify the parallel attribute - instead of once per fileset.
3657 * directory based tasks and fileset could miss some included files in
3658   directories that have been excluded
3660 * <fixcrlf> failed for large files.
3662 * <move> removed files you tried to move to themselves.
3664 * <sql> task will not trty to print the result set unless the query succeeded.
3666 * Ant classloader will now ignore paths which are invalid relative to the
3667   project base
3669 * <ejbjar> weblogic elements check for jar file changes has been fixed.
3670   Previously some changes would not be included.
3672 * properties loaded from properties files are now resolved internally. This
3673   removes the spurious warnings about usage of properties which have not been
3674   set.
3676 * <jar> task and friends now process the JAR manifest to ensure it is valid.
3678 * The task finished event now includes any exception thrown by the task.
3680 * <java> task now supports a jvmVersion attribute so that if another JVM is
3681   being used, Ant can determine which options to use for features such as the
3682   VM memory limits
3685 Changes from Ant 1.2 to Ant 1.3
3686 ===========================================
3688 Changes that could break older environments:
3689 --------------------------------------------
3691 * Ant doesn't search for the buildfile anymore, unless you use the new
3692   -find argument.
3694 * <perforce> has been replaced by a number of new tasks.
3696 * <javac> is now implemented using a factory. This makes extending
3697   javac to use a new compiler a lot easier but may break custom
3698   versions of this task that rely on the old implementation.
3700 * The output generated by the xml formatter for <junit> has changed a
3701   little, it doesn't append " sec" in the time attribute anymore.
3703 Other changes:
3704 --------------
3706 * A GUI Frontend: Antidote. This is currently in development. At this
3707   time, this is not part of the Ant release, although the source is
3708   included if you are interested.
3710 * New tasks: stylebook, propertyfile, depend, antlr, telnet, csc,
3711   ilasm, apply, javah, several clearcase tasks, junitreport, sound
3713 * Added output attribute to <java>.
3715 * Added nested zipfileset element to <zip>
3717 * Changed <sql> so that printing is at the task level rather than
3718   the statement level.
3720 * javadoc task will pass -d flag to any doclet if the destDir attribute is
3721   given. If the doclet does not accept the -d flag then omit the destdir
3722   attribute.
3724 * <cab> can work on non-Windows platforms with the help of libcabinet.
3725   See http://trill.cis.fordham.edu/~barbacha/cabinet_library/.
3727 * <ftp> now supports passive mode.
3729 * New <mapper> data type that can be used to get influence on the
3730   target files for some tasks like <copy> or enable new types of tasks
3731   like <apply>.
3733 * <execon> provides more control over the command line now, the names
3734   of the source files are no longer required to be at the end of the
3735   command.
3737 * Style tasks will now support TraX compliant XSL processors if one is present
3738   in your classpath.
3740 * Added a failonerror to the javac task. If set to false, the build will
3741   continue even if there are compilation errors.
3743 * Added nested format elements to the tstamp task allowing additional time
3744   formats to be defined for arbitrary properties.
3746 * Added classpath attribute and nested classpath element to <property>
3747   to make the resource attribute more powerful.
3749 * ${} property expansion will now be performed on the patterns read
3750   from files specified as includesfile or excludesfile attributes.
3752 * The <tar> and <untar> tasks now support GNU format for handling paths
3753   which are greater than 100 characters in length. In addition the <tar>
3754   task now supports nested filesets through which the file permissions
3755   may be controlled.
3757 * wlrun, wlstop and ejbjar now support Weblogic 6.0
3759 * The MPasre task has been updated to work with MParse 2.0
3761 * The documentation has been significantly updated.
3764 Fixed bugs:
3765 -----------
3767 * <signjar> no longer uses deprecated methods.
3769 * javadoc's failonerror attribute works again
3771 * javadoc's additionalparam attribute will now be split into separate
3772   parameters (on spaces) to allow for more than one parameter.
3774 * Changed <sql> task so that printing result sets works on Oracle
3776 * Changes to ddcreator and ejbc helper to respect the descriptor hierarchy
3777   keppgenerated in ejbc can now be turned off
3779 * ejbjar now correctly ignores <ejb-ref> elements in the deployment descriptor.
3780   CMP files are included by parsing the weblogic deployment descriptor rather
3781   than relying on the naming convention used in ant 1.2
3783 * ejbjar includes super classes and super interfaces into the generated ejb
3784   jar files. The <support> nested element allows support classes to be
3785   included in the EJB jar. The toplink element should now correctly locate
3786   the toplink descriptor.
3788 * <vssget> now correctly deals with spaces in arguments
3790 * <jar> fails early if a given manifest file doesn't exist
3792 * <rmic> doesn't search for the _Skel file anymore when stubversion is
3793   set to 1.2.
3795 * <rmic> uses the the same classpath to verify a class can be rmic'd
3796   as it passes to the compiler.
3798 * org.apache.tools.mail.MailMessage (and therefore <mail>) can now
3799   handle SMTP servers sending multi line responses.
3801 * nested <classpath> elements of <taskdef> now work for <taskdef>s not
3802   nested into <target> as well.
3804 * <property> and <available> will search for the resource "foo" instead
3805   of "/org/apache/tools/ant/taskdefs/foo" when given a relative resource
3806   name foo.
3808 * Handle build files in directories whose name contained a "#" character
3810 * <junit> can now log to files whose name contains a comma as well.
3812 * The AntClassLoader now refers to the loader which loaded it, any
3813   requests it does not handle itself. Previously these went to the
3814   primordial loader.
3816 Changes from Ant 1.1 to Ant 1.2
3817 ===============================
3819 Changes that could break older environments:
3820 --------------------------------------------
3822 * Semantics of <property> has changed again in the hope to be more
3823   intuitive. ${} expansion now happens at runtime and <property> tags
3824   living inside of targets only take effect if they are visited at
3825   runtime.
3827   As a side effect of this change, task's attributes get set at runtime
3828   not at parser time as well, which might change the results of
3829   <script>s or other custom tasks that reference other tasks by their id
3830   attribute.
3832 * copying of support files in <javac> has been removed - as well as
3833   the filtering attribute.
3835 * the <expand> and <keysubst> tasks have been removed.
3837 * the ignore and items attributes of directory based tasks have been removed.
3839 * the command line switches _not_ starting with - have been removed.
3841 * Path and EnumeratedAttribute have been moved from
3842   org.apache.tools.ant to org.apache.tools.ant.types.
3844 * the class attributes of <available>, <java>, <rmic> and <taskdef>
3845   have been removed.
3847 * the src attribute of <chmod> has been removed.
3849 * <patch> and <javadoc> have lost some of their attributes.
3851 * <java> and <cvs> have lost some undocumented attributes.
3853 * the Unix antRun script would search for command.sh in the directory
3854   it changed to and invoke this instead of command if present. This
3855   behavior has been dropped.
3857 * <ejbjar> task syntax has been changed significantly
3859 * <exec> is no longer implemented by org.apache.tool.ant.taskdefs.Exec.
3860   Custom tasks that rely on Project.createTask("exec") to return an
3861   instance of this class are going to fail.
3863 * nested <include> and <exclude> elements expect the value of their
3864   name attribute to be a single pattern, they don't accept multiple
3865   patterns anymore. Split them into multiple elements of the same type.
3867 * <delete dir="somedir" /> will now delete the directory itself as
3868   well as all included files. If you just want to clean out the
3869   directory and keep the empty one, use a nested fileset.
3871 Other changes:
3872 --------------
3874 * New tasks: antstructure, cab, execon, fail, ftp, genkey, jlink,
3875   junit, sql, javacc, jjtree, starteam, war, unwar, uptodate,
3876   native2ascii, copy, move, mparse.
3878 * copydir, copyfile, deltree and rename are now deprecated. They
3879   should be replaced with the new copy, delete and move tasks.
3881 * <java> uses a ClassLoader of its own in no-fork mode if a classpath is
3882   specified.
3884 * <style> will create the necessary target directories and reprocess
3885   all files if the stylesheet changes.
3887 * New data types fileset and patternset - expected to get a broader use.
3888   They, as well as PATH like structures, can now be defined on a global
3889   level and later be referenced by their id attribute.
3891 * You can specify environment variables to <exec>.
3893 * <get> can check whether a remote file is actually newer than a local
3894   copy before it starts a download (HTTP only).
3896 * Added a -logger option to allow the class which performs logging to be
3897   specified on the command line.
3899 * Added a -emacs option to tell the logger to leave out taskname adornments
3900   on log output.
3902 * <chmod> works on all files in parallel and supports multiple filesets.
3904 * <replace> can now use tokens and/or values that cross line boundaries.
3906 * build.compiler supports now jvc as well.
3908 * project specific help can now be obtained with the -projecthelp option.
3910 * Added a -debug option to make -verbose less verbose (and more useful)
3912 * Ant will now search for a file named build.xml in the parent directory
3913   and above (towards the root of the filesystem) if you didn't specify
3914   -buildfile and there is no build.xml in the current directory.
3916 * <echo> can now write to a file and accepts nested text.
3918 Fixed bugs:
3919 -----------
3921 * <chmod> didn't work when used as a directory based task.
3923 * Path, Available, Property didn't resolve relative filenames with
3924   respect to the Project's basedir.
3926 * Project didn't interpret the basedir attribute correctly in all
3927   cases.
3929 * Nested <src> in <javac> caused NullPointerException.
3931 * Corrupt Zip- and Jar-files ar now deleted if the task fails.
3933 * many more fixes we've forgotten to document here ...
3935 * The packagelistloc attribute of <javadoc>'s <link> child will be
3936   resolved as a file (i.e. it is either absolute or relative to
3937   basedir).