source: local/greenstone3/linux-64bit/apache-ant-1.9.2/WHATSNEW@ 30131

Last change on this file since 30131 was 28082, checked in by davidb, 11 years ago

Change to newer version of ant

File size: 212.5 KB
Line 
1Changes from Ant 1.9.1 TO 1.9.2
2===================================
3
4Fixed bugs:
5-----------
6
7 * Parsing of zip64 extra fields has become more lenient in order to
8 be able to read archives created by DotNetZip and maybe other
9 archivers as well.
10
11 * TarInputStream should now properly read GNU longlink entries' names.
12 Bugzilla Report 55040.
13
14 * <java> and <exec> used to be too restrictive when evaluating
15 whether a given set of options is compatible with spawning the new
16 process.
17 Bugzilla Report 55112.
18
19Other changes:
20--------------
21
22 * <javadoc> will now post-process the generated in order to mitigate
23 the frame injection attack possible in javadocs generated by Oracle
24 JDKs prior to Java7 Update 25. The vulnerability is known as
25 CVE-2013-1571.
26 There is an option to turn off the post-processing but it is only
27 recommended you do so if all your builds use a JDK that's not
28 vulnerable.
29 Bugzilla Report 55132.
30
31Changes from Ant 1.9.0 TO Ant 1.9.1
32===================================
33
34Changes that could break older environments:
35-------------------------------------------
36
37 * Users who have their own ProjectHelper implementation will need to change it because the import and include tasks
38 will now default the targetPrefix to ProjectHelper.USE_PROJECT_NAME_AS_TARGET_PREFIX.
39 Users using the default ProjectHelper2 with ant need not worry about this change done to fix Bugzilla Report 54940.
40
41
42Fixed bugs:
43-----------
44
45 * Corrected XSLTC error in <junitreport>.
46 Bugzilla Report 54641.
47
48 * Provide more control over Zip64 extensions created by <zip> and
49 related tasks. In particular no Zip64 extensions will be used at
50 all by the <jar> task family by default - this is required for jars
51 to be readably by Java5.
52 Bugzilla Report 54762.
53
54 * Fixed loading of external dependencies in JUnit task.
55 Bugzilla Report 54835.
56
57 * Target rewriting for nested "include" only works when "as" is specified.
58 See also "Changes that could break older environments"
59 Bugzilla Report 54940.
60
61
62Other changes:
63--------------
64
65 * strict attribute added to <signjar>.
66 Bugzilla Report 54889.
67
68 * simplifying Execute.getEnvironmentVariables since we are only running on Java 1.5 or higher now
69
70 * Added conditional attributes.
71 Bugzilla Report 43362
72
73 * Recommending to upgrade jsch to 0.1.50, particularly if you are using Java 1.7.
74 jsch is the library behind the sshexec and scp Ant tasks.
75 Versions of jsch older than 0.1.50 fail randomly under Java 1.7 with an error message "verify: false"
76
77Changes from Ant 1.8.4 TO Ant 1.9.0
78===================================
79
80Changes that could break older environments:
81-------------------------------------------
82
83 * Ant now requires at least Java 1.5 to compile and to run
84
85 * FixCRLF used to treat the EOL value ASIS to convert to the system property
86 line.separator. Specified was that ASIS would leave the EOL characters alone,
87 the task now really leaves the EOL characters alone. This also implies that
88 EOL ASIS will not insert a newline even if fixlast is set to true.
89 Bugzilla report 53036
90
91 * The CommandLauncher hierarchy that used to be a set of inner
92 classes of Execute has been extracted to the
93 org.apache.tools.ant.taskdefs.launcher package.
94
95 * Any FileResource whose represented File has a parent also has a basedir.
96
97 * Removing the Perforce Ant tasks replaced by tasks supplied by Perforce Inc.
98
99 * Setting the default encoding of StringResource to UTF-8 instead of null
100
101 * Upgrade JUnit 4 to JUnit 4.11
102
103Fixed bugs:
104-----------
105
106 * Made VectorSet faster.
107 Bugzilla Report 53622.
108
109 * Incorrect URLs in Ant child POMs.
110 Bugzilla Report 53617.
111
112 * Subclasses of JUnitTask did not correctly find junit.jar.
113 Bugzilla Report 53571.
114
115 * External XML catalog resolver failed to use project basedir when given an
116 unmentioned relative path like the internal resolver does.
117 Bugzilla Report 52754.
118
119 * Fixed some potential stream leaks.
120 Bugzilla Reports 52738, 52740, 52742, 52743.
121
122 * Updated documentation to fix spelling errors / broken links.
123 Bugzilla Reports 53215, 53291, 53202
124
125 * Unable to override system properties. It was not possible not to override
126 system properties from the command line (or from a property file).
127 Bugzilla Report 51792
128
129 * <javac> by default fails when run on JDK 8.
130 Bugzilla Report 53347.
131
132 * ExtensionPoint doesn't work with nested import/include
133 Bugzilla Report 53405.
134
135 * <packagemapper> failed to strip the non-matched parts with
136 handledirsep="true".
137 Bugzilla Report 53399.
138
139 * <expandproperties> filter caused a NullPointerException when input
140 was empty.
141 Bugzilla Report 53626.
142
143 * <get> now supports HTTP redirects using status code 307.
144 Bugzilla Report 54374.
145
146 * ssh tasks prompt for kerberos username/password under Java 7
147 Bugzilla Report 53437.
148
149 * Zip task on <mappedresources> that excludes certain files by way of the mapper resulted in a NullPointerException
150 Bugzilla Report 54026
151
152 * The ant launcher script should properly detect JAVA_HOME on
153 MacOS X 10.7
154 Bugzilla Report 52632
155
156 * Depend task does not handle invokeDynamic constant pool entries - java.lang.ClassFormatError: Invalid Constant Pool entry Type 18
157 Bugzilla Report 54090
158
159 * Base64Converter not properly handling bytes with MSB set (not masking byte to int conversion)
160 Bugzilla Report 54460
161
162 * The size resource comparator would return wrong results if file
163 sizes differed by more than 2 GB.
164 Bugzilla Report 54623
165
166 * Unable to encode properly into UTF-8 when the system property file.encoding is
167 set to ANSI_X3.4-1968.
168 Bugzilla Report 54606
169
170 * JUnit4 tests marked @Ignore do not appear in XML output
171 Bugzilla Report 43969
172
173Other changes:
174--------------
175
176 * merged the ZIP package from Commons Compress, it can now read
177 archives using Zip64 extensions (files and archives bigger that 4GB
178 and with more that 64k entries).
179
180 * a new task <commandlauncher> can be used to configure the
181 CommandLauncher used by Ant when forking external programs or new
182 Java VMs.
183 Bugzilla Report 52706.
184
185 * merged the TAR package from Commons Compress, it can now read
186 archives using POSIX extension headers and STAR extensions.
187
188 * merged the BZIP2 package from Commons Compress, it can now
189 optionally read files that contain multiple streams properly.
190
191 * <bunzip2> will now properly expand files created by pbzip2 and
192 similar tools that create files with multiple bzip2 streams.
193
194 * <tar> now supports a new "posix" option for longfile-mode which
195 will make it create PAX extension headers for long file names. PAX
196 extension headers are supported by all modern implementations of
197 tar including GNU tar.
198 This option should now be used in preference to "warn" or "gnu" as
199 it is more portable. For backwards compatibility reasons "warn"
200 will still create "gnu" extensions rather than "posix" extensions.
201
202 * The ProjectHelper class now exposes a method to be used by third party
203 implementations to properly resolve the binding between target extensions
204 and extension points.
205 Bugzilla Report 53549.
206
207 * Make extension point bindable to imported prefixed targets
208 Bugzilla Report 53550.
209
210 * Add the possibility to register a custom command line argument processor.
211 See org.apache.tools.ant.ArgumentProcessor and manual/argumentprocessor.html
212
213 * add the possibility to suppress stdout in the sshexec task.
214 Bugzilla Report 50270.
215
216 * add an encoding attribute to the contains selector.
217 This will be useful to use the contains selector if the encoding of the VM is different from the encoding
218 of the files being selected.
219
220 * support for GNU Classpath.
221 Bugzilla report 54760.
222
223Changes from Ant 1.8.3 TO Ant 1.8.4
224===================================
225
226Fixed bugs:
227-----------
228
229 * Ported libbzip2's fallback sort algorithm to CBZip2OutputStream to
230 speed up compression in certain edge cases. Merge from Commons
231 Compress.
232
233 Using specially crafted inputs this can be used as a denial of
234 service attack.
235 See http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2012-2098
236
237Changes from Ant 1.8.2 TO Ant 1.8.3
238===================================
239
240Changes that could break older environments:
241-------------------------------------------
242
243 * The Enumeration returned by AntClassLoader#getResources used to
244 return null in nextElement after hasNextElement would return false.
245 It has been changed to throw a NoSuchElementException instead so
246 that it now adheres to the contract of java.util.Enumeration.
247 Bugzilla Report 51579.
248
249Fixed bugs:
250-----------
251
252 * Removed buggy duplicate JAR list in RPM mode.
253 Bugzilla Report 52556.
254
255 * Launcher fixed to pass the right class loader parent.
256 Bugzilla Report 48633.
257
258 * <junitreport> mishandled ${line.separator}.
259 Bugzilla Report 51049.
260
261 * <junitreport> did not work in embedded environments on JDK 7.
262 Nor did <xslt> when using Xalan redirects.
263 Bugzilla Report 51668, 52382.
264
265 * Encoding of unicode escape sequences by the property file task
266 Bugzilla Report 50515.
267
268 * The code that implicitly sets the -source switch if only -target
269 has been specified in <javac> was broken for Java 5 and 6.
270 Bugzilla Report 50578.
271
272 * MailLogger ignore the Maillogger.starttls.enable property.
273 Bugzilla Report 50668.
274
275 * Delete task example does not work
276 Bugzilla Report 50816.
277
278 * <splash>'s proxy handling has been delegated to <setproxy>
279 internally so the two tasks are consistent. <splash>'s way of not
280 setting a proxy caused problems with other Java libraries.
281 Bugzilla Report 50888.
282
283 * Include task breaks dependencies or extension-points for multiple
284 files.
285 Bugzilla Report 50866.
286
287 * Read on System.in hangs for forked java task.
288 Bugzilla Report 50960.
289
290 * FileResource specified using basedir/name attributes was non-functional.
291
292 * Resource collection implementation of mapped PropertySet returned
293 unusable resources.
294
295 * The hasmethod condition failed with a NullPointerException when
296 ignoresystemclasses is true and Ant tried to load a "restricted
297 class" - i.e. a class that the Java VM will only accept when loaded
298 via the bootclassloader (a java.* class).
299 It will now fail with a more useful error message.
300 Bugzilla Report 51035.
301
302 * Exec task may mix the stderr and stdout output while logging it
303 Bugzilla Report 50507.
304
305 * Missing space between "finished" and timestamp in task/target
306 finish message from ProfileLogger.
307 Bugzilla Report 51109.
308
309 * Redirecting the output of a java, exec or apply task could print in the
310 error output stream some "Pipe broken" errors.
311 Bugzilla Report 48789.
312
313 * ZipFile failed to clean up some resources which could lead to
314 OutOfMemoryException while unzipping large archives.
315 A similar problem in ZipArchiveOutputStream has been fixed as well.
316 Bugzilla Report 42696.
317
318 * quiet attribute added to the copy and move tasks, to be used together
319 with failonerror=false, so warnings won't get logged
320 Bugzilla Report 48789.
321
322 * System.in was closed and not readable anymore by the DefaultInputHandler
323 when Ant is used via its Java API.
324 Bugzilla Report 51161
325
326 * <sync> only supported a single non-fileset resource collection even
327 though the manual said it could be multiple.
328
329 * <sync> didn't work properly when working on resource collections.
330 Bugzilla Report 51462.
331
332 * <augment> cause a NullPointerException if it was used in a target
333 that was invoked by multiple targets from the command line.
334 Bugzilla Report 50894.
335
336 * The ZipFile class could read past the start of the file if the
337 given file is not a ZIP archive and it is smaller than the size of
338 a ZIP "end of central directory record".
339
340 * <javac> would create the empty package-info.class file in the wrong
341 directory if no destdir was specified. Note it may still pick the
342 wrong directory if you specify more than one source directory but
343 no destDir. It is highly recommended that you always explicitly
344 specify the destDir attribute.
345 Bugzilla Report 51947.
346
347 * packagemapper now honors the handleDirSep attribute.
348 Bugzilla Report 51086.
349
350 * the attributes of macrodef tasks had their values run through
351 property expansion twice. Still true by default, but can be disabled.
352 Bugzilla Report 42046.
353
354 * jvc doesn't like it if source file names in argument files are
355 quoted.
356 Bugzilla Report 31667.
357
358 * ZipFile didn't work properly for archives using unicode extra
359 fields rather than UTF-8 filenames and the EFS-Flag.
360
361 * Access to DirectoryScanner's default excludes wasn't synchronized.
362 Bugzilla Report 52188.
363
364 * When a Project instance was created by a custom tasks its
365 createTask method didn't work.
366 Bugzilla Report 50788.
367
368Other changes:
369--------------
370
371 * -f/-file/-buildfile accepts a directory containing build.xml.
372
373 * The <javacc>, <jjtree> and <jjdoc> now support a new maxmemory
374 attribute.
375 Bugzilla Report 50513.
376
377 * the documented inputstring attribute of sshexec has been
378 implemented and the actually existing attribute inputproperty
379 documented.
380 Bugzilla Report 50576.
381
382 * The concat task now permits the name of its exposed resource
383 by means of its 'resourcename' attribute.
384
385 * The expandproperties filter now accepts a nested propertyset
386 which, if specified, provides the properties for expansion.
387 Bugzilla Report 51044.
388
389 * <junit filtertrace="true"/> will no longer filter out the very
390 first line of the stacktrace containing the original exception
391 message even if it matches one of the filter expressions.
392
393 * Upgraded to Apache AntUnit 1.2
394
395 * Provide read access to Mkdir.dir. Bugzilla Report 51684.
396
397 * <delete> and <move> have a new attribute performGCOnFailedDelete
398 that may - when set to true - help resolve some problems with
399 deleting empty directories on NFS shares.
400 Bugzilla Report 45786.
401
402 * <loadfile> and <loadresource> used to log at level INFO to signal a
403 property hasn't been set when the resource was empty even if the
404 quiet attribute was set to true. They will now use VERBOSE
405 instead.
406 Bugzilla Report 52107.
407
408 * <javac> has a new attribute createMissingPackageInfoClass that can
409 be set to false to prevent Ant from creating empty dummy classes
410 used for up-to-date-ness checks.
411 Bugzilla Report 52096.
412
413 * URLResources#isExists has become less noisy.
414 Bugzilla Report 51829.
415
416 * The <retry> task has a new optional attribute retryDelay that can
417 be used to make the task sleep between retry attempts.
418 Bugzilla Report 52076.
419
420 * <signjar> has new attributes that control the signature and digest
421 algorithms.
422 Bugzilla Report 52344.
423
424 * Initial support for Java 8.
425
426 * <sshexec> can optionally create a pseudo terminal (like ssh -t)
427 Bugzilla Report 52554.
428
429Changes from Ant 1.8.1 TO Ant 1.8.2
430===================================
431
432Changes that could break older environments:
433-------------------------------------------
434
435 * Prior to Ant 1.8.0 the <copy> task and several other tasks would
436 overwrite read-only destination files. Starting with 1.8.0 they
437 would only do so under special circumstances. Ant 1.8.2 now
438 consistently won't replace a read-only file by default. The same is
439 true for a number of other tasks.
440 The <copy>, <move> and <echo> tasks now have a new force attribute
441 and <concat> has a new forceReadonly attribute that can be used to
442 make the task overwrite read-only destinations.
443 Bugzilla Report 49261.
444
445 * Removed ant-nodeps.jar; it is now merged into ant.jar.
446
447 * DOMElementWriter#encode used to employ special code before encoding
448 ampersands so that &#123; remained &#123; rather than being turned
449 into &amp;#123;. This is no longer the case, ampersands will now
450 be encoded unconditionally.
451 Also DOMElementWriter#encodeData will treat CDATA sections containing a
452 literal "]]>" sequence different now - it will split the CDATA
453 section between the second "]" and ">" and create two sections.
454 This affects <echoxml> task as well as the XML logger or JUnit
455 formatter where ampersands will now always get encoded.
456 In addition DOMElementWriter will now replace the characters \t, \r
457 and \n in attribute values by entity references.
458 Bugzilla Report 49404.
459
460 * The list elements returned by ProjectHelper#getExtensionStack are
461 now String arrays of length 3 rather than 2 in order to support the
462 onMissingExtensionPoint attribute.
463 Bugzilla Report 49473.
464
465 * When using <property file="..." prefix="..."/> properties defined
466 inside the same file will only get used in expansions if the ${}
467 reference uses the same prefix. This is different from Ant 1.8.1
468 but is the same behavior Ant 1.8.0 and earlier exhibited.
469 A new attribute prefixValues can be used to re-enable the behavior
470 of Ant 1.8.1.
471 Bugzilla Report 49373.
472
473 * The files and directories used by Git, Mercurial and Bazaar to
474 store their information are now excluded by the defaultexcludes.
475 Bugzilla Report 49624.
476
477 * The <junit> task no longer generates TestListener events - which
478 have been introduced in ant 1.7.0 - by default. The task has a new
479 attribute enableTestListenerEvents and a new "magic" property
480 ant.junit.enabletestlistenerevents has been added that can be used
481 to reinstate the old behavior.
482
483Fixed bugs:
484-----------
485
486 * hostinfo now prefers addresses with a hostname over addresses without
487 a hostname, provided the addresses have the same scope.
488 For local lookup, no IP address will be put in NAME / DOMAIN anymore.
489 For remote lookup, if a host name was provided and only an IP address is
490 found, the IP address will no longer overwrite the host name provided to the
491 task.
492 Bugzilla Report 49513
493
494 * mmap-based file copy problems under JDK 1.4 on Linux.
495 Bugzilla Report 49430.
496
497 * The Sun JVM tries to mmap the entire file during a copy.
498 For large files this is not feasible.
499 We now explicitly request to copy at most 16 MiB per request.
500 Bugzilla Report 49326.
501
502 * DemuxInputStream.read() should return unsigned values
503 Bugzilla Report 49279.
504
505 * The MIME mailer ignored the port parameter when using SSL.
506 Bugzilla Report 49267.
507
508 * <xslt> ignored the classpath when using the default TraX processor.
509 Bugzilla Report 49271.
510
511 * <checksum>'s totalproperty only worked reliably if the same file
512 name didn't occur inside more than one directory.
513 Bugzilla Report 36748.
514
515 * <ftp> could fail to download files from remote subdirectories under
516 certain circumstances.
517 Bugzilla Report 49296.
518
519 * <junit> will now produce better diagnostics when it fails to delete
520 a temporary file.
521 Bugzilla Report 49419.
522
523 * Ant would often scan directories even though there were known to
524 only hold excluded files when evaluating filesets. This never
525 resulted in wrong results but degraded performance of the scan
526 itself.
527 Bugzilla Report 49420.
528
529 * <javac> failed for long command lines on OS/2.
530 Bugzilla Report 49425.
531
532 * <junitreport> did not handle encodings well for stdout/stderr.
533 Bugzilla Report 49418.
534
535 * <junit> could issue a warning about multiple versions of Ant on the
536 CLASSPATH if two CLASSPATH entries differed in case on a
537 case-insensitive file system.
538 Bugzilla Report 49041.
539
540 * The <restrict> resource collection was checking every resource even if
541 we actually just want the first one, like in the example of use of
542 resourcelist in the documentation (getting the first available resource
543 from a mirror list).
544
545 * A race condition could lead to build failures if multiple <mkdir>
546 tasks were trying to create the same directory.
547 Bugzilla Report 49572.
548
549 * the toString() method of the Resources class - and thus any
550 ${toString:} expansion of a reference to a <resources> element -
551 didn't iterate over its nested elements if it hadn't done so prior
552 to the toString invocation already.
553 Bugzilla Report 49588.
554
555 * <apply> in parallel mode didn't work together with a nested
556 <redirector> if maxparallel was <= 0 (the default) or no source
557 files matched.
558 Bugzilla Report 49594.
559
560 * <jar filesetmanifest="merge"> didn't work for manifests added via
561 <zipfileset>s that used the prefix or fullpath attributes.
562 Bugzilla Report 49605.
563
564 * <tempfile createfile="true"> would cause an error unless the prefix
565 attribute has been specified.
566 Bugzilla Report 49755.
567
568 * If forked, after finished <java> was still reading the input stream
569 for a bunch of characters, then stealing them from a following <input>.
570 Bugzilla Report 49119.
571
572 * Ant could be leaking threads for each forked process (started by
573 <exec>, <apply>, <java> or similar tasks) that didn't receive input
574 from a resource or string explicitly.
575 Bugzilla Report 49587.
576
577 * Project#setDefault threw an exception when null was passed in as
578 argument, even though the Javadoc says null is a valid value.
579 Bugzilla Report 49803.
580
581 * runant.py would swallow the first argument if CLASSPATH wasn't set.
582 Bugzilla Report 49963.
583
584 * <taskdef> failed to load resources from jar files contained in a
585 directory that has a "!" in its name.
586 Bugzilla Report 50007.
587
588 * ant.bat exit strategy improvements and issues
589 make the exit codes work in environments where 4NT or MKS are installed
590 Bugzilla Report 41039.
591
592 * <signjar> would fail if used via its Java API and the File passed
593 into the setJar method was not "normalized" (i.e. contained ".."
594 segments).
595 Bugzilla Report 50081.
596
597 * <delete> ignored <fileset>'s errorOnMissingDir attribute
598 Bugzilla Report 50124.
599
600 * <symlink> failed to close files when reading a list of symbolic
601 links from a properties file.
602 Bugzilla Report 50136.
603
604 * <parallel> could allow tasks to start executing even if a task
605 scheduled to run before them timed out.
606 Bugzilla Report 49527.
607
608 * If a <junit> batch with multiple tests times out Ant logs a message
609 about a test named Batch-With-Multiple-Tests since 1.8.0 but the
610 logic that determined the Java package of this pseudo-test has been
611 wrong.
612 Bugzilla Report 45227.
613
614 * <propertyfile> didn't preserve the original linefeed style when
615 updating a file.
616 Bugzilla Report 50049.
617
618 * <zip>'s whenEmpty behavior never consulted the non-fileset
619 resources so the task could fail even though resources have been
620 provided using non-fileset resource collections.
621 Bugzilla Issue 50115.
622
623* ftp chmod could throw a NPE.
624 Bugzilla report 50217.
625
626* The project help (-p option in the command line) will now print
627 the dependencies of the targets in debug mode (-d on the command
628 line)
629
630Other changes:
631--------------
632
633 * <concat>'s force attribute has been deprecated in favor of a new
634 overwrite attribute that is consistent with <copy>'s attribute
635 names.
636
637 * You can now specify a list of methods to run in a JUnit test case.
638 Bugzilla Report 34748.
639
640 * properties in files read because of the -propertyfile command line
641 option will now get resolved against other properties that are
642 defined before the project starts executing (those from the same or
643 earlier -propertfiles or defined via the -D option).
644 Bugzilla Report 18732.
645
646 * <pathelement>s can now contain wildcards in order to use wildcard
647 CLASSPATH entries introduced with Java6.
648 The wildcards are not expanded or even evaluated by Ant and will be
649 used literally. The resulting path may be unusable as a CLASSPATH
650 for Java versions prior to Java6 and likely doesn't mean anything
651 when used in any other way than a CLASSPATH for a forked Java VM.
652 Bugzilla Report 46842.
653
654 * A new attribute allows targets to deal with nonexistent extension
655 points, i.e. they can extend an extension-point if it has been
656 defined or silently work as plain targets if it hasn't. This is
657 useful for targets that get included/imported in different
658 scenarios where a given extension-point may or may not exist.
659 Bugzilla Report 49473.
660
661 * Ant now logs a warning message if it fails to change the file
662 modification time in for example when using <touch> or preserving
663 timestamps in various tasks.
664 Bugzilla Report 49485.
665
666 * ProjectHelpers can now be installed dynamically via the <projecthelper>
667 Ant task.
668
669 * <import> is now able to switch to the proper ProjectHelper to parse
670 the imported resource. This means that several kinds of different build
671 files can import each other.
672
673 * <copy tofile=""> now also works for non-filesystem resources.
674 Bugzilla Report 49756.
675
676 * The <linecontainsregexp> filter now supports a casesensitive
677 attribute.
678
679 * The <containsregexp> selector now supports casesensitive, multiline
680 and singleline attributes.
681 Bugzilla Report 49764.
682
683 * A new <cutdirsmapper> can be used like wget's --cut-dirs option to
684 strip leading directories from file names.
685
686 * <javah> now supports the GNU project's gcjh compiler.
687 Bugzilla Report 50149.
688
689 * <checksum> supports additional views of a file's path as elements
690 for a custom pattern.
691 Bugzilla Report 50114.
692
693 * JUnit XMLResultAggregator logs the stack trace of caught IO exceptions
694 in verbose runs.
695 Bugzilla Report 48836.
696
697 * StringUtils.parseHumanSizes() should turn parse failures into
698 BuildExceptions.
699 Bugzilla Report 48835.
700
701 * New task <bindtargets> to make a list of targets bound to some
702 specified extension point.
703
704 * Initial support for OpenJDK7 has been added.
705
706 * Ant now uses java.net.CookieStore rather than
707 java.util.ServiceLocator to detect whether the environment is a
708 Java 1.6 system. This means releases of gcj/gij at the time of
709 this release of Ant are detected as Java 1.5 and not 1.6.
710 Bugzilla Report 50256.
711
712 * It is now possible to write a compiler adapter for <javac> that
713 compiles sources with extensions other than .java (but that still
714 compile to .class files).
715 Bugzilla Report 48829.
716
717 * The performance of VectorSet#add(Object) has been improved which
718 should also benefit any operation that scans directories in Ant.
719 Bugzilla Report 50200.
720
721Changes from Ant 1.8.0 TO Ant 1.8.1
722===================================
723
724Changes that could break older environments:
725-------------------------------------------
726
727 * ant-trax.jar is no longer produced since TrAX is included in JDK 1.4+.
728
729 * Ant no longer ships with Apache Xerces-J or the XML APIs but relies
730 on the Java runtime to provide a parser and matching API versions.
731
732 * The stylebook ant task and the ant-stylebook.jar are removed.
733
734Fixed bugs:
735-----------
736
737 * Tasks that iterate over task or type definitions, references or
738 targets now iterate over copies instead of the live maps to avoid
739 ConcurrentModificationExceptions if another thread changes the
740 maps.
741 Bugzilla Report 48310.
742
743 * The filesmatch condition threw a NullPointerException when
744 comparing text files and the second file contained fewer lines than
745 the first one.
746 Bugzilla Report 48715.
747
748 * Regression: The <ear> task would allow multiple
749 META-INF/application.xml files to be added.
750 Bugzilla Report 6836.
751
752 * VectorSet#remove(Object) would fail if the size of the vector
753 equaled its capacity.
754
755 * Regression : ant -diagnostics was returning with exit code 1
756 Bugzilla Report 48782
757
758 * Fix for exec task sometimes inserts extraneous newlines
759 Bugzilla Report 48746
760
761 * SymlinkTest#testSymbolicLinkUtilsMethods failing on MacOS
762 Bugzilla Report 48785.
763
764 * If <concat>'s first resourcecollection child is a <resources>,
765 any subsequently added child resourcecollection joins the first.
766 Bugzilla Report 48816.
767
768 * <get> with an invalid URL could trigger an NPE in some JVMs.
769 Bugzilla Report 48833
770
771 * Broken Pipe issue under Ubuntu Linux
772 Bugzilla Report 48789
773
774 * Properties wrongly read from file or not update during read
775 Bugzilla Report 48768
776
777 * AntClassLoader in Ant 1.8.0 has been considerably slower than in
778 1.7.1
779 Bugzilla Report 48853
780
781 * ANT_CMD_LINE_ARGS are rippling through lower level Ant usage
782 Bugzilla Report 48876
783
784 * email : IO error sending mail with plain mimetype
785 Bugzilla Report 48932
786
787 * the complete-ant-cmd.pl script failed to create a proper cache of
788 target if "ant -p" failed.
789 Bugzilla Report 48980
790
791 * <rmic>'s sourcebase attribute was broken.
792 Bugzilla Report 48970
793
794 * <copy>'s failonerror didn't work as expected when copying a single
795 element resource collection to a file.
796 Bugzilla Report 49070
797
798 * <get> no longer followed redirects if the redirect URL was relative
799 and not an absolute URL.
800 Bugzilla Report 48972
801
802 * fixed a performance degradation in the code that expands property
803 references.
804 Bugzilla Reports 48961 and 49079
805
806 * <jar filesetmanifest="merge"> was broken on Windows.
807 Bugzilla Report 49090
808
809 * <symlink> delete failed if the link attribute was a relative path
810 to a link inside the current directory without a leading ".".
811 Bugzilla Report 49137
812
813 * <telnet> and <rexec> failed to find the expected strings when
814 waiting for responses and thus always failed.
815 Bugzilla Report 49173
816
817Other changes:
818--------------
819
820 * Project provides new get methods that return copies instead of the
821 live maps of task and type definitions, references and targets.
822
823 * Ant is now more lenient with ZIP extra fields and will be able to
824 read archives that it failed to read in earlier versions.
825 Bugzilla Report 48781.
826
827 * The <zip> family of tasks has been sped up for bigger archives.
828 Bugzilla Report 48755.
829
830 * Add removeKeepExtension option to NetRexxC task.
831 Bugzilla Report 48788.
832
833 * Add prefix attribute to loadproperties task.
834
835 * Add resource attribute to length task.
836
837 * PropertyResource will effectively proxy another Resource if ${name}
838 evaluates to a Resource object.
839
840 * Added forcestring attribute to equals condition to force evaluation
841 of Object args as strings; previously only API-level usage of the
842 equals condition allowed Object args, but Ant 1.8.x+ property
843 evaluation may yield values of any type.
844
845 * BuildFileTest.assertPropertyUnset() fails with a slightly more
846 meaningful error message
847 Bugzilla Report 48834
848
849 * <junit> will now throw an exception if a test name is empty. This
850 used to manifest itself in unrelated errors like
851 Bugzilla Report 43586.
852
853 * A change that made <exec> more reliable on Windows (Bugzilla Report
854 5003) strongly impacts the performance for commands that execute
855 quickly, like attrib. Basically no single execution of a command
856 could take less than a second on Windows.
857 A few timeouts have been tweaked to allow these commands to finish
858 more quickly but still they will take longer than they did with Ant
859 1.7.1.
860 Bugzilla Report 48734.
861
862 * Added SimpleBigProjectLogger, intermediate between NoBannerLogger and
863 BigProjectLogger.
864
865 * <mappedresources> supports new attributes enablemultiplemappings
866 and cache.
867
868 * Added the augment task to manipulate existing references via Ant's basic
869 introspection mechanisms.
870
871Changes from Ant 1.8.0RC1 TO Ant 1.8.0
872======================================
873
874Changes that could break older environments:
875-------------------------------------------
876
877 * the appendtolines filter has been renamed to suffixlines.
878
879Fixed bugs:
880-----------
881
882 * stack traces were not reported at all by <junit/>
883 when filtertrace="on", which is the default.
884
885 * ant.bat can now also process the -noclasspath switch when it is
886 the first switch on a command line.
887 Bugzilla Report 48186.
888
889 * <fixcrlf> now tries to delete the created temporary files earlier.
890 Bugzilla Report 48506.
891
892 * the implementation of <zip> had been changed in a way that broke
893 the jarjar links task and protentially other third-party subclasses
894 as well.
895 Bugzilla Report 48541.
896
897 * <scp> task didn't report build file location when a remote operation failed
898 Bugzilla Report 48578.
899
900 * <propertyfile> would add the same comment and a date line each time
901 it updated an existing property file.
902 Bugzilla Report 48558.
903
904 * <sound> didn't work properly in recent Java VMs.
905 Bugzilla Report 48637.
906
907Other changes:
908--------------
909
910Changes from Ant 1.7.1 TO Ant 1.8.0RC1
911======================================
912
913Changes that could break older environments:
914-------------------------------------------
915
916 * if and unless attributes (on <target> as well as various tasks and other
917 elements) have long permitted ${property} interpolation. Now, if the result
918 evaluates to "true" or "false" (or "yes", "no", "on", "off"), that boolean
919 value will be used; otherwise the traditional behavior of treating the value
920 as a property name (defined ~ true, undefined ~ false) is used. Existing
921 scripts could be broken if they perversely defined a property named "false"
922 and expected if="false" to be true, or used if="true" expecting this to be
923 triggered only if a property named "true" were defined.
924
925 * Ant now requires Java 1.4 or later.
926
927 * Improved handling of InterruptException (lets suppose someone/thing
928 is trying to kill the thread when we receive an
929 InterruptException), when an InterruptException is received, we do
930 not wait anymore in a while loop till the end time has been
931 reached.
932 Bugzilla Report 42924.
933
934 * Refactor PropertyHelper and introspection APIs to make extension
935 more granular and support setting task/type attribute values to
936 objects decoded by custom PropertyEvaluator delegates. Also add
937 <propertyhelper> task for registering delegates and/or replacing
938 the registered PropertyHelper instance.
939 Bugzilla Report 42736.
940
941 * Added a restricted form of typedef called <componentdef>. This
942 allows definition of elements that can only be within tasks or
943 types. This method is now used to define conditions, selectors,
944 comparators and filterreaders. This means that tasks may now have
945 nested conditions just by implementing the Condition interface,
946 rather than extending ConditionBase. It also means that the use of
947 namespaces for some of the selectors introduced in Ant 1.7.0 is no
948 longer necessary. Implementing this means that the DynamicElement
949 work-around introduced in Ant 1.7.0 has been removed.
950 Bugzilla Report 40511.
951
952 * In the <touch> task when a <mapper> is used, the millis and
953 datetime attributes now override the time of the source resource if
954 provisioned.
955 Bugzilla Report 43235.
956
957 * Remove fall-back mechanism for references that are not resolved
958 during normal runtime execution.
959
960 * FileUtils.createTempFile now actually creates the file.
961 The TempFile task still does not create the file by default, can be
962 instructed to do so however using a new parameter.
963 Bugzilla Report 33969.
964
965 * A lock in Project ensured that a BuildListener's messageLogged
966 method was only ever executed by a single thread at a time, while
967 all other methods could be invoked by multiple threads
968 simultaniously (while within <parallel>, for example). This lock
969 is no longer in place, messageLogged should be made thread-safe
970 now.
971
972 * <sql>'s onError="stop" no longer fails the build if an error
973 occurs, this is the main difference between stop and error and
974 matches what the documentation implied.
975 Bugzilla Report 24668.
976
977 * Ant's configuration introspection mechanisms have been modified to prefer
978 Resource and FileProvider attributes to plain java.io.File attributes;
979 however the configuration-from-String behavior remains equivalent, rendering
980 a FileResource.
981
982 * CBZip2InputStream will now throw an IOException if
983 passed in a null or empty InputStream to read from.
984 Bugzilla Reports 32200.
985
986 * <unzip> will now fail when trying to extract certain broken
987 archives that would have been silently ignored in earlier version.
988 Bugzilla Report 35000.
989
990 * Ant's <zip> family of tasks tries to preserve the existing Unix
991 permissions when updating archives or copying entries from one
992 archive to another.
993 Since not all archiving tools support storing Unix permissions in
994 the same way that is used by Ant, sometimes the permissions read by
995 Ant seem to be 0, which means nobody is allowed to do anything to
996 the file or directory.
997 If Ant now encounters a permission set of 0 it will assume that
998 this is not the intended value and instead apply its own default
999 values. Ant used to create entries with 0 permissions itself.
1000 The <zip> family of tasks has a new attribute preserve0permissions
1001 that can be set to restore the old behavior.
1002 Bugzilla Report 42122.
1003
1004 * If a batch containing multiple JUnit tests running inside a forked
1005 Java VM caused the VM to crash (or caused a timeout), the
1006 formatters would receive an error message for the last test in the
1007 batch.
1008 Ant will now pass in a test with the name "Batch-With-Multiple-Tests"
1009 instead - this is supposed to show more clearly that the last test
1010 may not have started at all.
1011 Bugzilla Report 45227.
1012
1013 * If the number of minutes a build takes is bigger then 1000 Ant will
1014 no longer print a thousands separator in the "elapsed time"
1015 message. It used to be the thousands separator of the current
1016 locale.
1017 Bugzilla Report 44659.
1018
1019 * <symlink action="delete"> used to fail if the link was broken (i.e.
1020 pointing to a file or directory that no longer existed). It will now
1021 silently try to remove the link.
1022 Bugzilla Report 41285.
1023
1024 * <delete file="..."> used to log a warning and not delete broken
1025 symbolic links. <delete dir="..."/> didn't even log a warning.
1026 The task will now try to delete them in both cases.
1027 Bugzilla Report 41285.
1028
1029 * if the dir attribute of a <fileset> points to a symbolic link and
1030 followsymlinks is set to false, the fileset will no longer be
1031 scanned and always seem empty.
1032 Bugzilla Report 45741.
1033
1034 * the .NET tasks that have been deprecated since Ant 1.7.0 have been
1035 removed, please use the stand-alone Antlib you can find at
1036 http://ant.apache.org/antlibs/dotnet/index.html
1037 instead.
1038
1039 * the logic of closing streams connected to forked processes (read
1040 the input and output of <exec> and friends) has been changed to
1041 deal with cases where child processes of the forked processes live
1042 longer than their parents and keep Ant from exiting.
1043 It is unlikely but possible that the changed logic breaks stream
1044 handling on certain Java VMs.
1045 Bugzilla issue 5003.
1046
1047 * <checksum>'s totalproperty was platform dependent because it relied
1048 on java.io.File#compareTo. It has now been made platform
1049 independent, which means that totalPropery values obtained on
1050 Windows (and other systems where the sort order of File is not case
1051 sensitive) can be different from the values obtained with earlier
1052 versions of Ant.
1053 Bugzilla Report 36748.
1054
1055 * globmapper didn't work properly if the "to" or "from" patterns
1056 didn't contain a "*". In particular it implicitly added a * to the
1057 end of the pattern(s). This is no longer the case. If you relied
1058 on this behavior you will now need to explicitly specify the
1059 trailing "*".
1060 Bugzilla Report 46506.
1061
1062 * <copy> silently ignored missing resources even with
1063 failOnError="true". If your build tries to copy non-existant
1064 resources and you relied on this behavior you must now explicitly
1065 set failOnError to false.
1066 Bugzilla Report 47362.
1067
1068 * Ant now prefers the java.runtime.version system property over
1069 java.vm.version for the Created-By Manifest attribute.
1070 Bugzilla Report 47632.
1071
1072 * The <image> task now supports a nested mapper. In order to
1073 implement this, the Java API of the task had to change so any
1074 custom subclass overriding the processFile method will need to
1075 adapt (by overriding the new two-arg processFile method).
1076 Bugzilla Report 23243.
1077
1078 * A new property syntax can be used to set attributes from
1079 references: ${ant.ref:some-reference}
1080
1081 In most cases this will yield the exact same result as
1082 ${toString:some-reference} - only when an attribute setter method
1083 accepts an object type other than string and the project's
1084 reference is an Object of matching type the new syntax will pass in
1085 that object.
1086
1087 If your build file already contains properties whose name starts
1088 with "ant.ref:" there is a potential for collision. If your
1089 property has been set, normal property expansion will take
1090 precedence over the new syntax. If the property has not been set
1091 and a reference with the postfix of your property name exists
1092 (i.e. in a very unlikely event) then the new syntax would yield a
1093 different result (an expanded property) than Ant 1.7.1 did.
1094
1095 * A ProjectHelper implementation can now provide the default build file
1096 name it is expecting, and can specify if they can support a specific build
1097 file. So Ant is now capable of supporting several ProjectHelper
1098 implementations, deciding on which to use depending of the input build file.
1099
1100 * Mapper-aware selectors (depends, different, present) now accept typedef'd
1101 FileNameMappers.
1102
1103Fixed bugs:
1104-----------
1105
1106 * The default logger was failing to print complete stack traces for
1107 exceptions other than BuildException when inside <ant> or
1108 <antcall>, thus omitting often important diagnostic
1109 information.
1110 Bugzilla 43398 (continued).
1111
1112 * Better handling of package-info.class.
1113 Bugzilla Report 43114.
1114
1115 * RPM task needed an inserted space between the define and the value.
1116 Bugzilla Report 46659.
1117
1118 * Got rid of deadlock between in, out and err in the Redirector.
1119 Bugzilla Report 44544.
1120
1121 * Caused by AssertionError no longer filtered.
1122 Bugzilla Report 45631.
1123
1124 * <zip> would sometimes recreate JARs unnecessarily.
1125 Bugzilla Report 45902.
1126
1127 * <symlink> task couldn't overwrite existing symlinks that pointed to
1128 nonexistent files
1129 Bugzilla Report 38199.
1130
1131 * <symlink> task couldn't overwrite files that were in the way of the symlink.
1132 Bugzilla Report 43426.
1133
1134 * <symlink> task failonerror="false" does not stop build from failing
1135 when 'ln' command returns non-zero.
1136 Bugzilla Report 43624
1137
1138 * <touch> task couldn't differentiate between "no resources
1139 specified" and "no resources matched."
1140 Bugzilla Report 43799.
1141
1142 * ManifestClassPath failed when a relative path would traverse the
1143 file system root.
1144 Bugzilla Report 44499.
1145
1146 * <globmapper> had an indexoutofbounds when the prefix and postfix
1147 overlapped.
1148 Bugzilla Report 44731.
1149
1150 * <typedef> and <taskdef> failed to accept file names with #
1151 characters in them.
1152 Bugzilla Report 45190
1153
1154 * A deadlock could occur if a BuildListener tried to access an Ant property
1155 within messageLogged while a different thread also accessed one.
1156 Bugzilla Report 45194
1157
1158 * Handle null result of system getProperty() in CommandlineJava.
1159 Similar to Bugzilla Report 42334.
1160
1161 * Length task did not process nonexistent Resources even though these might
1162 conceivably still carry file length information.
1163 Bugzilla Report 45271.
1164
1165 * <javac>'s includeJavaRuntime="false" should work for gcj now. Note
1166 that you may need to set includeAntRuntime to false in order to
1167 have full control.
1168 Bugzilla Report 34638.
1169
1170 * <sql> would fail if the executed statment didn't return a result
1171 set with some JDBC driver that dissalow Statement.getResultSet to
1172 be called in such a situation.
1173 Bugzilla Report 36265
1174
1175 * if the executed statement in <sql> returned a result set and an
1176 update count, the count would be lost.
1177
1178 * if an executed statement in <sql> mixes update count and result set
1179 parts, some result sets wouldn't get printed.
1180 Bugzilla Report 32168.
1181
1182 * XmlLogger could lose messages if <parallel> is used.
1183 Bugzilla Report 25734.
1184
1185 * <scp> creates remoteToDir if it doesn't exist.
1186 Bugzilla Report 42781
1187
1188 * CBZip2OutputStream threw an exception if it was closed prior to
1189 writing anything.
1190 Bugzilla Reports 32200, 45836
1191
1192 * The IPlanetDeploymentTool didn't use the configured DTD locations.
1193 Bugzilla Report 31876.
1194
1195 * The ant shell script printed a warning under Cygwin if JAVA_HOME
1196 was not set.
1197 Bugzilla Report 45245.
1198
1199 * <filterset> sometimes incorrectly flagged infinite recursions of
1200 filter tokens
1201 Bugzilla Report 44226.
1202
1203 * failures were treated as errors in forked JUnit tests when JUnit 4
1204 was used.
1205 Bugzilla Report 43892.
1206
1207 * <jar> and <manifest> disallowed manifest attributes whose name
1208 contained the character '8'.
1209 Bugzilla Report 45675.
1210
1211 * BigProjectLogger would set the project's basedir to the current
1212 working directory.
1213 Bugzilla Report 45607.
1214
1215 * only <formatter>s that logged to a file were notified if forked VM
1216 crashed or a timeout occured in <junit>.
1217 Bugzilla Report 37312.
1218
1219 * ant -v -version would print the version information twice.
1220 Bugzilla Report 45695.
1221
1222 * when nested into builds that have been invoked by <ant> tasks
1223 <subant> might set the wrong basedir on the called projects.
1224 Bugzilla Report 30569.
1225
1226 * If the message of the failed assertion of a forked JUnit test
1227 contained line feeds some excess output ended up in Ant's log.
1228 Bugzilla Report 45411.
1229
1230 * <symlink action="delete"> failed to delete a link that pointed to
1231 a parent directory.
1232 Bugzilla Report 45743.
1233
1234 * <symlink action="delete"> failed if ant lacked permission to rename
1235 the link's target.
1236 Bugzilla Report 41525.
1237
1238 * when checking whether a jar is signed, <signjar> ignored the
1239 sigfile attribute.
1240 Bugzilla Report 44805.
1241
1242 * When using JavaMail all <mail> tasks used the same mail host
1243 regardless of their configuration.
1244 Bugzilla Report 37970.
1245
1246 * <signjar> and <issigned> didn't handle aliases with characters other
1247 than numbers, letters, hyphen or underscore properly.
1248 Bugzilla Report 45820.
1249
1250 * <filterset> could miss multi-character begin tokens in some cases.
1251 Bugzilla Report 45094.
1252
1253 * <depend> didn't close JARs that were part of the classpath.
1254 Bugzilla Report 45955.
1255
1256 * in some cases <depend> would delete class files even if it didn't
1257 find the corresponding source files.
1258 Bugzilla Report 45916.
1259
1260 * <javadoc> failed if the nested <bottom> or <head> contained line
1261 breaks.
1262 Bugzilla Report 43342.
1263
1264 * encoding="auto" has been broken in <mail> since Ant 1.7.0 and only
1265 worked if JavaMail was available.
1266 Bugzilla Report 42389.
1267
1268 * MailLogger could cause a NullPointerException.
1269 Bugzilla Report 44009.
1270
1271 * <junit> didn't recognize failed assertions as failures if they
1272 caused subclasses of AssertionError to be thrown (like
1273 org.junit.ComparisonFailure that is thrown when assertEquals
1274 fails).
1275 Bugzilla Report 45028.
1276
1277 * the Unix "ant" wrapper script failed to protect wildcards in
1278 command line arguments in some cases.
1279 Bugzilla Report 31601.
1280
1281 * <cvstagdiff> crippled file names and could miss some entries if
1282 multiple modules have been specified.
1283 Bugzilla Report 35301.
1284
1285 * Tasks with a "public void add(SomeType)" method failed to work as
1286 TaskContainers at the same time.
1287 Bugzilla Report 41647.
1288
1289 * Tasks that implementes DynamicElemen or DynamicElementNS failed to
1290 work as TaskContainers at the same time.
1291 Bugzilla Report 41647.
1292
1293 * combining SSL and authentication in <mail> and MailLogger failed in
1294 some setups.
1295 Bugzilla Report 46063.
1296
1297 * if an error occurs while logging the buildFinished event, the
1298 original error is now logged to System.err.
1299 Bugzilla Report 25086.
1300
1301 * <copy> failed with a NullPointerException when copying a resource
1302 without a name. It will now fail with a meaningful error message.
1303 Bugzilla Report 39960.
1304
1305 * <xslt> now uses the configured classpath to load the factory (when
1306 using TraX) before falling back to Ant's own classpath.
1307 Bugzilla Report 46172.
1308
1309 * <dependset> complained about files being modified in the future if
1310 they had been just very recently (within Ant's assumed granularity
1311 of the file system).
1312 Bugzilla Report 43665.
1313
1314 * <sshexec> didn't store the ouput in outputproperty if the remote
1315 command failed.
1316 Bugzilla Report 46340.
1317
1318 * DirectoryScanner's slow-scanning algorithm that is used when you
1319 ask for excluded or not-included files and/or directories could
1320 miss some files and directories in the presence of recursive
1321 exclude patterns.
1322
1323 * <sort> resource collection kept only one of entries deemed equal by
1324 the chosen Comparator.
1325 Bugzilla Report 46527.
1326
1327 * the ZipFile class used by <unzip> and others could leave the
1328 archive open (making it undeletable on Windows as long as the java
1329 VM was running) for files with an unexpected internal structure.
1330 Bugzilla Report 46559.
1331
1332 * The zip package now supports the extra fields invented by InfoZIP
1333 in order to store Unicode file names and comments.
1334
1335 * The zip package detects the encoding bit set by more modern
1336 archivers when they write UTF-8 filenames and optionally sets it
1337 when writing zips or jars.
1338 Bugzilla Report 45548
1339
1340 * <sync> could run into a NullPointerException when faced with broken
1341 symbolic links.
1342 Bugzilla Report 46747.
1343
1344 * The ant shell script should now support MSYS/MinGW as well.
1345 Bugzilla Report 46936.
1346
1347 * <signjar> has a new force attribute that allows re-signing of jars
1348 that are already signed.
1349 Bugzilla Report 46891.
1350
1351 * <sshexec> now again honors failonerror in the face of connection
1352 errors.
1353 Bugzilla Report 46829.
1354
1355 * The <replacetokens> filter threw an exception if the stream to
1356 filter ended with a begin token.
1357 Bugzilla Report 47306.
1358
1359 * <scriptmapper>, <scriptfilter> and <scriptcondition> didn't support
1360 the setbeans attribute.
1361 Bugzilla Report 47336.
1362
1363 * <loadproperties>' encoding attribute didn't work.
1364 Bugzilla Report 47382.
1365
1366 * Ant created tar archives could contain random bytes at the end
1367 which confused some untar implementations.
1368 Bugzilla Report 47421.
1369
1370 * various places where unchecked PrintWriters could hide exceptions
1371 have been revisited to now check the error status or not use a
1372 PrintWriter at all.
1373 Bugzilla Report 43537.
1374
1375 * filesetmanifest="mergewithoutmain" in <jar> didn't treat inline
1376 manifests as expected.
1377 Bugzilla Report 29731.
1378
1379 * <record> didn't work properly with nested builds.
1380 Bugzilla Report 41368.
1381
1382 * <jar> with filesetmanifest different from skip didn't work if the
1383 update attribute has been set to true.
1384 Bugzilla Report 30751.
1385
1386 * The default stylesheets for <junitreport> failed to properly escape
1387 XML content in exception stack traces.
1388 Bugzilla Report 39492.
1389
1390 * AntClassLoader didn't set the proper CodeSource for loaded classes.
1391 Bugzilla Report 20174.
1392
1393 * AntClassLoader.getResourceAsStream would return streams to
1394 resources it didn't return with getResource and to classes it
1395 failed to load.
1396 Bugzilla Report 44103.
1397
1398 * Logging exceptions without a message would cause a
1399 NullPointerException.
1400 Bugzilla Report 47623.
1401
1402 * WeblogicDeploymentTool could fail on platforms with a file
1403 separator other than "/".
1404 Bugzilla Report 35649.
1405
1406 * The update attribute of the modified selector was ignored.
1407 Bugzilla Report 32597.
1408
1409 * <manifest> and <jar> can now merge Class-Path attributes from
1410 multiple sources and optionally flatten them into a single
1411 attribute.
1412 The default behaviour still is to keep multiple Class-Path
1413 attributes if they have been specified and to only include the
1414 attributes of the last merged manifest.
1415 Bugzilla Report 39655.
1416
1417 * <delete> didn't work correctly with a <modified> selector because
1418 it was scanning the same filesets more than once.
1419 Bugzilla Report 43574.
1420
1421 * when using custom filterreaders with the <filterreader classname="">
1422 syntax Ant could leak memory.
1423 The problem didn't occur when using <typedef> or <componentdef> to
1424 define the filterreader which is the recommended approach.
1425 Bugzilla Report 45439.
1426
1427 * Ant didn't set the proper "magic" value for tar entries containing
1428 long file names in GNU longfile mode.
1429 Bugzilla Report 47653.
1430
1431 * The tar task failed to recognize that the archive had to be
1432 (re-)created in some cases where the sources are filesystem based
1433 resources but not filesets.
1434 Bugzilla Report 48035.
1435
1436 * <sshexec>'s outputproperty was prefixed by the executed command
1437 when the command attribute has been used, breaking backwards
1438 compatibility to Ant 1.7.0.
1439 Bugzilla Report 48040.
1440
1441 * different task instances of the same <scriptdef>ed tasks could
1442 overwrite each others attributes/nested elements.
1443 Bugzilla Report 41602.
1444
1445 * The Hashvalue algortihm implementation of the modified task could
1446 fail to read the file(s) completely.
1447 Bugzilla Report 48313.
1448
1449Other changes:
1450--------------
1451
1452 * The get task now also follows redirects from http to https
1453 Bugzilla Report 47433
1454
1455 * A HostInfo task was added performing information on hosts, including info on
1456 the host ant is running on.
1457 Bugzilla Reports 45861 and 31164.
1458
1459 * There is now a FileProvider interface for resources that act as a source
1460 of filenames. This should be used by tasks that require resources
1461 to provide filenames, rather than require that all resources
1462 are instances or subclasses of FileResource.
1463 Bugzilla Report 43348
1464
1465 * There is now a URLProvider interface for resources that act as a
1466 source of URLs. This should be used by tasks that require resources
1467 to provide URLs, rather than require that all resources are
1468 instances or subclasses of URLResource.
1469
1470 * Fixcrlf now gives better error messages on bad directory attributes.
1471 Bugzilla Report 43936
1472
1473 * a new property ant.project.default-target holds the value of the
1474 current <project>'s default attribute.
1475
1476 * a new property ant.project.invoked-targets holds a comma separated
1477 list of the targets that have been specified on the command line
1478 (the IDE, an <ant> task ...) when invoking the current project.
1479
1480 * The <type> resource selector has had an "any" type added for better
1481 configurability.
1482
1483 * Ant should detect the OS as both a Mac and a Unix system when
1484 running on OpenJDK.
1485 Bugzilla Report 44889.
1486
1487 * new protected getConnection and getStatement methods allow
1488 subclasses of SQLExec more control - or access to the cached
1489 instances when overriding other methods like runStatements.
1490 Bugzilla Report 27178.
1491
1492 * <sql> has a new failOnConnectionError attribute that can be used to
1493 keep a build going even if the task failed to connect to the
1494 database.
1495 Bugzilla Report 36712.
1496
1497 * A new attribute strictDelimiterMatching can be used to ignore case
1498 or whitespace differences when <sql> searches for delimiters.
1499 This is useful if you execute a SQL script that has contains "GO"
1500 and "go" as delimiters.
1501 Bugzilla Report 26459.
1502
1503 * A new showWarnings attribute of <sql> allows warnings to be logged.
1504 Bugzilla Report 41836.
1505
1506 * A new treatWarningsAsErrors attribute of <sql> can be used to fail
1507 a build if a warning occurs.
1508 Bugzilla Report 41836.
1509
1510 * Ant now supports scoped properties (see Local task).
1511 Bugzilla Report 23942.
1512
1513 * <sql>'s CSV output can be controlled via the new attributes
1514 csvColumnSeparator and csvQuoteCharacter.
1515 Bugzilla Report 35627.
1516
1517 * <ftp>'s logging has been improved.
1518 Bugzilla Reports 30932, 31743.
1519
1520 * It is now possible to disable <ftp>'s remote verification.
1521 Bugzilla Report 35471.
1522
1523 * <sshexec> now supports input in a way similar to <exec>
1524 Bugzilla Report 39197.
1525
1526 * <scp> can now preserve the file modification time when downloading
1527 files.
1528 Bugzilla Report 33939.
1529
1530 * the new task sshsession can run multiple tasks in the presence of
1531 an SSH session providing (local and remote) tunnels.
1532 Bugzilla Report 43083.
1533
1534 * ZipOutputStream has been sped up for certain usage scenarios that
1535 are not used by Ant's family of zip tasks.
1536 Bugzilla Report 45396.
1537
1538 * <echo> supports an "output" Resource attribute as an alternative to "file".
1539
1540 * <sql> "output" attribute now supports any Resource in addition to a file.
1541
1542 * <scp> no longer requires a passphrase when using key based
1543 authentication.
1544 Bugzilla Report 33718.
1545
1546 * a new failOnEmptyArchive attribute on <unzip> and <untar> can now
1547 make the task fail the build if it tries to extract an empty
1548 archive.
1549
1550 * <unzip> and <untar> have a new attribute stripAbsolutePathSpec.
1551 When set to true, Ant will remove any leading path separator from
1552 the archived entry's name before extracting it (making the name a
1553 relative file name).
1554 Bugzilla Report 28911.
1555
1556 * <unzip> will now detect that it was asked to extract a file that is
1557 not an archive earlier if the file is big.
1558 Bugzilla Report 45463.
1559
1560 * New file and resource selectors <readable/> and <writable/> have
1561 been added that select file which the current process can read or
1562 write.
1563 Bugzilla Report 45081.
1564
1565 * The filename file selector has a new attribute regex that allows
1566 files to be selected by matching their names against a regular
1567 expression.
1568 Bugzilla Report 45284
1569
1570 * The name resource selector has a new attribute regex that allows
1571 resources to be selected by matching their names against a regular
1572 expression.
1573 Bugzilla Report 45284
1574
1575 * Enhanced performance of Project.fireMessageLoggedEvent and DirectoryScanner
1576 Bugzilla Reports 45651 and 45665
1577
1578 * The package list location for offline links can now be specified as
1579 an URL.
1580 Bugzilla Report 28881
1581
1582 * <echoxml> now supports XML namespaces.
1583 Bugzilla Report 36804.
1584
1585 * A new listener for <junit> has been added that tries to invoke the
1586 tearDown method of a TestCase if that TestCase was run in a forked
1587 VM and the VM crashed or a timeout occured. See the <junit> task's
1588 manual page for details.
1589 Bugzilla Report 37241.
1590
1591 * The Jar task now supports the addition of a jar index file in update mode.
1592 Previously the absence of the index was not enough to trigger the rebuild;
1593 some other update was necessary.
1594 Bugzilla report 45098.
1595
1596 * <ant> has a new attribute "useNativeBasedir" that makes the child
1597 build use the same basedir it would have used if invoked from the
1598 command line. No matter what other attributes/properties have been
1599 set.
1600 Bugzilla Report 45711.
1601
1602 * <patch> has a new optional failOnError attribute.
1603 Bugzilla Report 44772.
1604
1605 * Antlib descriptors will now be parsed by the configured
1606 ProjectHelper if the implementation overrides the new
1607 canParseAntlibDescriptor and parseAntlibDescriptor methods. If the
1608 configured helper doesn't override the methods, a new instance of
1609 ProjectHelper2 will be used just like in Ant 1.7.1.
1610 Bugzilla Report 42208.
1611
1612 * It is now possible to explicitly set the executable used by
1613 <signjar>.
1614 Bugzilla Report 39189.
1615
1616 * <compositemapper>'s order of results is now predictable.
1617 Bugzilla Report 44873
1618
1619 * a new <firstmatchmapper> has been added, which works similar to
1620 <compositemapper> but only returns the results of the first nested
1621 mapper that matches.
1622 Bugzilla Report 44873
1623
1624 * <get> has a new maxtime attribute that terminates downloads that
1625 are taking too long.
1626 Bugzilla Report 45181.
1627
1628 * <ftp> now supports selectors for remote directories as well.
1629 Bugzilla Report 44726.
1630
1631 * In some cases Ant fails to rename files if the source or target
1632 file has just recently been closed on Windows. It will now try to
1633 delete the offending file once again after giving the Java VM time
1634 to really close the file.
1635 Bugzilla Report 45960.
1636
1637 * two new properties can be used to set the MIME-Type and charset
1638 used by MailLogger.
1639 Bugzilla Report 27211.
1640
1641 * a new attribute of <mail> allows the task to succeed if it can
1642 reach at least one given recipient.
1643 Bugzilla Report 36446.
1644
1645 * two new properties allow MailLogger to send a fixed text instead of
1646 the log file.
1647 Bugzilla Report 38029.
1648
1649 * <cvsversion> is supposed to support CVSNT now.
1650 Bugzilla Report 31409.
1651
1652 * <cvs>' port attribute should now work for all clients that use the
1653 environment variable CVS_PSERVER_PORT instead of the "official"
1654 CVS_CLIENT_PORT.
1655 Bugzilla Report 30124.
1656
1657 * <cvsversion> now works for local repositories as well.
1658
1659 * <cvstagdiff> has an option to ignore removed files now.
1660 Bugzilla Report 26257.
1661
1662 * <cvs> and friends now support modules with spaces in their names
1663 via nested <module> elements.
1664
1665 * A new attribute "ignoreEmpty" controls how <concat> deals when
1666 there are no resources to concatenate. If it is set to false, the
1667 destination file will be created regardless, which reinstates the
1668 behavior of Ant 1.7.0.
1669 Bugzilla Report 46010.
1670
1671 * If the new remote attribute is set to true, <cvschangelog> can now
1672 work against a remote repository without any working copy.
1673 Bugzilla Report 27419.
1674
1675 * start and end tags can now be used instead of dates in
1676 <cvschangelog>.
1677 Bugzilla Report 27419.
1678
1679 * MailLogger and <mail> can now optionally enable support for
1680 STARTTLS.
1681 Bugzilla Report 46063.
1682
1683 * <import> has new attributes "as" and "prefixSeparator" that can be
1684 used to control the prefix prepended to the imported targets'
1685 names.
1686
1687 * a new task <include> provides an alternative to <import> that
1688 should be preferred when you don't want to override any targets.
1689
1690 * delete has a new attribute removeNotFollowedSymlink. If set to
1691 true, symbolic links not followed (because followSymlinks was false
1692 or the number of symlinks was too big) will be removed.
1693 Bugzilla Report 36658.
1694
1695 * the os and osfamily attributes of <chown>, <chgrp>, <chmod> and
1696 <attrib> can now be used to run the commands on operating systems
1697 other than their "native" environment, i.e. non-Unix or non-Windows
1698 operating systems respectively.
1699 Bugzilla Report 7624.
1700
1701 * a new resource collection <mappedresources> generalizes the prefix
1702 and fullpath attributes of <zipfileset> to arbitrary mappers that
1703 can be applied to arbitrary resource collections.
1704 Bugzilla Report 4240.
1705
1706 * <tarfileset> and <zipfileset> have a new attribute
1707 errorOnMissingArchive that allows "optional" filesets that don't
1708 break the build if the archive doesn't exist.
1709 Bugzilla Report 46091.
1710
1711 * <javadoc> has new attributes that correspond to the
1712 -docfilessubdirs and -excludedocfilessubdir command line arguments.
1713 Bugzilla Report 34455.
1714
1715 * <xslt> now fails early if a specified stylesheet doesn't exist.
1716 Bugzilla Report 34525.
1717
1718 * <xslt> now has an option to supress transformer warnings. This
1719 option only has an effect for processors that support this feature;
1720 the "trax" processor included with Ant does support it.
1721 Bugzilla Report 18897.
1722
1723 * <xslt> has two new attributes failOnError and
1724 failOnTransformationError that can be used to not make the build
1725 process proceed if an error occurs.
1726 Bugzilla Report 36260.
1727
1728 * <xslt> has a new attribute failOnNoResources that can be used to
1729 make the build fail/continue if the collection of resources to
1730 transform is empty.
1731 Bugzilla Report 46274.
1732
1733 * It is now possible to define system properties that should be set
1734 during xslt's transformation. This can be used to enable XInclude
1735 processing in Xerces, for example.
1736 Bugzilla Report 36653.
1737
1738 * a new resource collection <archives> can be used to specify
1739 collections of ZIP and TAR archives as sources. It extracts them on
1740 the fly. This is a generalization of the <zipgroupfileset> found
1741 as nested element of <zip> and friends.
1742 Bugzilla Report 46257.
1743
1744 * <dependset> has a new verbose attribute that makes the task list
1745 all deleted targets and give a hint as to why it deleted them.
1746 Bugzilla Report 13681.
1747
1748 * <replaceregexp> now supports arbitrary filesystem based resource
1749 collections.
1750 Bugzilla Report 46341.
1751
1752 * <replace> now supports arbitrary filesystem based resource
1753 collections.
1754 Bugzilla Report 24062.
1755
1756 * token and value of <replace>'s nested <replacefilter> can now also
1757 be specified as nested elements to allow multiline content more
1758 easily.
1759 Bugzilla Report 39568.
1760
1761 * <replace> and <replaceregexp> can now optionally preserve the file
1762 timestamp even if the file is modified.
1763 Bugzilla Report 39002.
1764
1765 * The <replace> child-elements <replacetoken> and <replacevalue> have
1766 a new attribute that controls whether properties in nested text get
1767 expanded.
1768 Bugzilla Report 11585.
1769
1770 * <replace> has a new attribute failOnNoReplacements that makes the
1771 build fail if the task didn't do anything.
1772 Bugzilla Report 21064.
1773
1774 * <sync>'s <preserveInTarget> has a new attribute that controls
1775 whether empty directories should be kept.
1776 Bugzilla Report 43159.
1777
1778 * ant -diagnostics now checks that it can read as much from the
1779 temporary directory as it has written. This may help detecting a
1780 full filesystem.
1781 Bugzilla Report 32676.
1782
1783 * <pathconvert> has a new preserveduplicates attribute--historically
1784 these were eliminated in the interest of behaving in the manner
1785 of a "path."
1786
1787 * <javac>'s source and target attributes are no longer ignored when
1788 using gcj.
1789 Bugzilla Issue 46617.
1790
1791 * ant -diagnostics now outputs information about the default XSLT
1792 processor.
1793 Bugzilla Issue 46612.
1794
1795 * the ZIP library will now ignore ZIP extra fields that don't specify
1796 a size.
1797 Bugzilla Report 42940.
1798
1799 * CBZip2OutputStream now has a finish method separate from close.
1800 Bugzilla Report 42713.
1801
1802 * the <zip> and <unzip> family of tasks has new options to deal with
1803 file name and comment encoding. Please see the zip tasks'
1804 documentation for details.
1805
1806 * <input ...><handler type="secure" /></input> now uses previously
1807 undocumented SecureInputHandler shipped with Ant 1.7.1.
1808
1809 * Command line arguments for <exec> and similar tasks can now have
1810 optional prefix and suffix attributes.
1811 Bugzilla Report 47365
1812
1813 * <apply>'s srcfile and targetfile child elements can now have
1814 optional prefix and suffix attributes.
1815 Bugzilla Report 45625
1816
1817 * <jar> has a new attribute to enable indexing of META-INF
1818 directories which is disabled for backwards compatibility reasons.
1819 Bugzilla Report 47457
1820
1821 * <apt>'s executable attribute can be used to specify a different
1822 executable.
1823 Bugzilla Report 46230.
1824
1825 * <rmic>'s new executable attribute can be used to specify a
1826 different executable.
1827 Bugzilla Report 42132.
1828
1829 * <javac>, <rmic>, <javah> and <native2ascii> now provide a nested
1830 element to specify a classpath that will be used when loading the
1831 task's (compiler) adapter class.
1832 Bugzilla Report 11143.
1833
1834 * <javac>, <rmic>, <javah> and <native2ascii> now provide a nested
1835 element to specify the task's (compiler) adapter as an instance of
1836 a class that has been defined via typedef/componentdef. This
1837 allows more control over the classpath and allows adapters to be
1838 defined in Antlibs easily.
1839
1840 * A new subclass org.apache.tools.ant.loader.AntClassLoader5 of
1841 AntClassLoader has been added which overrides getResources
1842 which became non-final in ClassLoader with Java5+ so
1843 this method now behaves as expected.
1844 The new subclass will be used by Ant internally if it is available
1845 and Ant is running on Java5 or more recent.
1846 Bugzilla Report 46752.
1847
1848 * a new attributes can chose a different request method than GET for
1849 the http condition.
1850 Bugzilla Report 30244
1851
1852 * <splash> now supports a configurable display text and a regular
1853 expression based way to determine progress based on logged messages.
1854 Bugzilla Report 39957.
1855
1856 * the number of retries on error in <get> is now configurable. <get>
1857 can be told to not download files that already exist locally.
1858 Bugzilla Report 40058.
1859
1860 * Ant now builds against commons-net 2.0 as well.
1861 Bugzilla Report 47669.
1862
1863 * A new nested element connectionProperty of <sql> allows setting of
1864 arbitrary JDBC connection properties.
1865 Bugzilla Report 33452.
1866
1867 * A new islastmodified condition can check the last modified date of
1868 resources.
1869
1870 * <rmic> has a new destDir attribute that allows generated files to
1871 be written to a different location than the original classes.
1872 Bugzilla Report 20699.
1873
1874 * <rmic> has a new listfiles attribute similar to the existing one of
1875 <javac>.
1876 Bugzilla Report 24359.
1877
1878 * It is now possible to suppress the "FAILED" lines sent to Ant's
1879 logging system via <junit>'s new logFailedTests attribute.
1880 Bugzilla Report 35073.
1881
1882 * <propertyfile> now can delete entries.
1883
1884 * The <resources> resource collection can now optionally cache its
1885 contents.
1886
1887 * A new <resourceexists> condition can check whether resources exists.
1888
1889 * <sql> has two new attributes errorproperty and warningproperty that
1890 can be set if an error/warning occurs.
1891 Bugzilla Report 38807.
1892
1893 * <sql> has a new attribute rowcountproperty that can be used to set
1894 a property to the number of rows affected by a task execution.
1895 Bugzilla Report 40923.
1896
1897 * when Ant copies files without filtering, it will now use NIO
1898 channels.
1899 Bugzilla Report 30094.
1900
1901 * <get> has a new attribute that can be used to disable caching on
1902 HTTP connections at the HttpUrlConnection level.
1903 Bugzilla Report 41891.
1904
1905 * <tar> and <zip> (and tasks derived from <zip>) will now create the
1906 parent directory of the destination archive if it doesn't exist.
1907 Bugzilla Report 45377.
1908
1909 * A new filterreader <sortfilter> that sorts input lines has been
1910 added.
1911 Bugzilla Report 40504.
1912
1913 * A new token filter <uniqfilter> that suppresses tokens that match
1914 their ancestor token has been added.
1915
1916 * <rootfileset>s nested into <classfileset>s can now use a dir
1917 attribute different from the <classfileset>.
1918 Bugzilla Report 37763.
1919
1920 * <path> can now optionally cache its contents.
1921
1922 * <property> can now specify values as nested text.
1923 Bugzilla Report 32917.
1924
1925 * a new parentFirst attribute on <javaresource> allows resources to
1926 be loaded from the specified classpath rather than the system
1927 classloader.
1928 Bugzilla Report 41369.
1929
1930 * <property location="from" basedir="to" relative="true"/> can now
1931 calculate relative paths.
1932
1933 * The <name> selector supports a new handleDirSep attribute that
1934 makes it ignore differences between / and \ separators.
1935 Bugzilla Report 47858.
1936
1937 * <get> now supports resource collections (as long as the resources
1938 contained provide URLs) and can get multiple resources in a single
1939 task.
1940
1941 * <import> can now import non-File resources if they provide an URL
1942 - as the <url> and <javaresource> resources do.
1943 Bugzilla Report 29251
1944
1945 * <import> can now import multiple resources specified as resource
1946 collections.
1947 Bugzilla Report 22269.
1948
1949 * a new <resourcelist> type is similar to <filelist> but can read the
1950 list of resources from non-file resources and may return resources
1951 that are not files.
1952
1953 * a new filterreader appendtolines complements prefixlines.
1954
1955 * a new top level element extension-point allows build files to be
1956 extended with custom targets more easily.
1957
1958Changes from Ant 1.7.0 TO Ant 1.7.1
1959=============================================
1960
1961Changes that could break older environments:
1962-------------------------------------------
1963
1964* String resources only have properties single expanded. If you relied on
1965 <string> resources being expanded more than once, it no longer happens.
1966 Bugzilla report 42277.
1967
1968* A String resource's encoding attribute was only taken into account when
1969 set from the resource's OutputStream; the InputStream provided the String's
1970 binary content according to the platform's default encoding. Behavior has
1971 been modified to encode outgoing (InputStream) content as well as encoding
1972 incoming (OutputStream) content.
1973
1974* <java> with fork now returns gives -1 instead of 0 as result when failonerror
1975 is false and some exception (including timeout) occurs. Br 42377.
1976
1977* ant-type attribute has been marked as deprecated and a warning has been
1978 issued if it is encountered in the build file.
1979
1980Fixed bugs:
1981-----------
1982
1983* The default logger was failing to print complete stack traces for exceptions
1984 other than BuildException, thus omitting often important diagnostic
1985 information. Bugzilla 43398.
1986
1987* Error in FTP task
1988 Bugzilla report 41724
1989
1990* Regression: Locator fails with URI encoding problem when spaces in path
1991 Bugzilla report 42222
1992
1993* Regression in Locator: running Ant off a network share does not work:
1994 message "URI has authority component" appears
1995 Bugzilla report 42275
1996
1997* Improvements in AntClassLoader Speed.
1998 Bugzilla report 42259
1999
2000* Error in handling of some permissions, most notably the AllPermission on
2001 jdk 1.5
2002 Bugzilla report 41776
2003
2004* Replace task summary output incorrect.
2005 Bugzilla report 41544
2006
2007* Dependset crashes ant when timestamp on files change during Dependset
2008 execution.
2009 Bugzilla report 41284
2010
2011* Bug in org.apache.tools.ant.types.resources.comparators.Date
2012 Bugzilla report 41411
2013
2014* <junit> in Ant 1.7.0 could throw NPE if no <classpath> was defined.
2015 Bugzilla report 41422.
2016
2017* In Ant 1.7.0, <fileset> in <javadoc> does not by default include only
2018 **/*.java as the documentation claims and earlier revisions did.
2019 Bugzilla report 41264.
2020
2021* SPI support in jar was broken.
2022 Bugzilla report 41201.
2023
2024* jsch-0.1.30 causes SCP task to hang
2025 Bugzilla report 41090.
2026
2027* Target from imported file listed twice in projecthelp.
2028 Bugzilla report 41226.
2029
2030* <sql> task double-expands properties if expandproperties is true,
2031 and expands properties if expandproperties is false.
2032 Bugzilla report 41204.
2033
2034* Rolling back Bugzilla 32927 (set a default description for a javadoc tag
2035 if not set) as it caused a BC problem.
2036 Bugzilla report 41268.
2037
2038* <apt> forks properly and so memory settings are picked up.
2039 Bug report 41280.
2040
2041* Regression: NPE was thrown when using <pathconvert> against a
2042 (third-party instantiated) fileset with null Project reference.
2043
2044* Strip out all -J arguments to non forking rmic adapters, specifically
2045 the Sun and Weblogic compilers.
2046 Bug report 41349
2047
2048* Synchonization issues in PropertyHelper. Bugzilla 41353.
2049
2050* <concat binary="true" append="true"> did not append. Bugzilla 41399.
2051
2052* -autoproxy turns Java1.5+ automatic proxy support on. Bugzilla 41904
2053
2054* Handle null result of system getProperty(). Bugzilla 42334.
2055
2056* Regression: concat fixlastline="true" should not have applied to
2057 nested text, but did in Ant 1.7.0. Bugzilla 42369.
2058
2059* Regression: ant.version was not passed down in <ant>, <subant>.
2060 This worked in Ant 1.6.5, but not in 1.7.0.
2061 ant.core.lib (added in 1.7.0) was also not being propagated.
2062 Bugzilla bug 42263
2063
2064* Regression: bzip2 task created corrupted output files for some inputs.
2065 Bugzilla bug 41596.
2066
2067* Regression: <available> with <filepath> did not work.
2068 Bugzilla 42735.
2069
2070* ant script, cd may output to stdout.
2071 Bugzilla 42739.
2072
2073* Modified selector doesn't update the cache if only one file has changed.
2074 Bugzilla 42802.
2075
2076* Regression: Path subclasses that overrode list() stopped working in
2077 resourceCollection contexts in Ant 1.7.0. Bugzilla 42967.
2078
2079* <property> supports loading from xml based property definition.
2080 Bugzilla 42946
2081
2082* <junit> supports collecting and rerunning failed test cases
2083 (textXXX methods). Bugzilla 42984.
2084
2085* War task failed with "No WEB-INF/web.xml file was added" when called
2086 a second time. Bugzilla 43121.
2087
2088* FilterMapper could throw an NPE.
2089 Bugzilla 43292.
2090
2091* Regession nested macrodefs with elements could cause StackOverFlow.
2092 Bugzilla 43324.
2093
2094* Some changes to <junit> broke third party tasks that extend it (like
2095 Apache Cactus' Ant task). The changes have been modified so that
2096 subclases should now work again - without any changes to the
2097 subclass.
2098
2099Other changes:
2100--------------
2101
2102* Various small optimizations speed up common tasks such as <javac> on large
2103 filesets, reducing both I/O and CPU usage.
2104
2105* Profiling logger has been added with basic profiling capabilities.
2106
2107* <script> now has basic support for JavaFX scripts
2108
2109* SSH task can now take a command parameter containing the commands to execute.
2110 This allows you to connect to a server and execute a number of commands
2111 without constantly reconnecting for each command.
2112
2113* Upgraded XML API to XML commons version 1.3.04.
2114
2115* Upgraded to Xerces 2.9.0
2116
2117* <script> can now work with bsf.jar and js.jar in its <classpath>.
2118
2119* add errorProperty and updatedProperty to <javac>
2120 Bugzilla 35637 and 28941.
2121
2122* add classpathref attribute to <whichresource>
2123 Bugzilla 41158.
2124
2125* reduce logging noise of <apply skipemptyfilesets="true">
2126 Bugzilla 29154
2127
2128* Show Previous Revision in the tagdiff.xsl stylesheet
2129 Bugzilla 29143
2130
2131* Allow <mapper refid> to refer directly to a FileNameMapper instance.
2132
2133* If you try and use a type in a namespace (or an antlib), and the type is not
2134 recognized but there are other definitions in that namespace, Ant lists what
2135 the known definitions are. This helps you find spelling errors.
2136
2137* Add a <last> resource collection, corresponding to <first>.
2138
2139* Add new <truncate> task.
2140
2141* <junitreport> xsl stylesheets allow setting the title used in <title> and <h1> tags by
2142 using <report><param> element. Bugzilla 41742.
2143
2144* Add IgnoreDependenciesExecutor for weird cases when the user wants to run
2145 only the targets explicitly specified.
2146
2147* Patternset allows nested inverted patternsets using <invert>.
2148
2149* <manifest> checks for validity of attribute names.
2150
2151* JUnitVersionHelper.getTestCaseClassName is now public. Bugzilla 42231
2152
2153* <string> resource supports nested text. Bugzilla bug 42276
2154
2155* <scriptdef> now sources scripts from nested resources/resource collections. This lets you
2156 define scripts in JARs, remote URLs, or any other supported resource. Bugzilla report 41597.
2157
2158* <concat> is now usable as a single-element ResourceCollection.
2159
2160* It is now possible to provide the value of a <striplinecomments> filter's
2161 <comment> nested element as nested text instead of using the 'value'
2162 attribute.
2163
2164* A new logger, BigProjectLogger, lists the project name with every target
2165
2166* Default text added to macrodef. Bugzilla report 42301.
2167
2168* "rawblobs" attribute added to SQL task.
2169
2170* Add new retry task container.
2171
2172* <jar> has a new strict attribute that checks if the jar complies with
2173 the jar packaging version specification.
2174
2175* <javac> has a new attribute - includeDestClasses.
2176 Bugzilla 40776.
2177
2178* <fileset> has a new attribute - errorOnMissingDir.
2179 Bugzilla 11270.
2180
2181* <javac> handles package-info.java files, there were repeatedly compiled.
2182 Bugzilla 43114.
2183
2184* SecureInputHandler added to use Java 6 System.console().readPassword()
2185 when available.
2186
2187Changes from Ant 1.6.5 to Ant 1.7.0
2188===================================
2189
2190Changes that could break older environments:
2191-------------------------------------------
2192
2193* Initial support for JDK 6 (JSR 223) scripting.
2194 <*script*> tasks will now use javax.scripting if BSF is
2195 not available, or if explicitly requested by using
2196 a "manager" attribute.
2197
2198* Removed launcher classes from nodeps jar.
2199
2200* <classconstants> filter reader uses ISO-8859-1 encoding to read
2201 the java class file. Bugzilla report 33604.
2202
2203* Defer reference process. Bugzilla 36955, 34458, 37688.
2204 This may break build files in which a reference was set in a target which was
2205 never executed. Historically, Ant would set the reference early on, during parse
2206 time, so the datatype would be defined. Now it requires the reference to have
2207 been in a bit of the build file which was actually executed. If you get
2208 an error about an undefined reference, locate the reference and move it somewhere
2209 where it is used, or fix the depends attribute of the target in question to
2210 depend on the target which defines the reference/datatype.
2211 As a result of testing on real live build scripts, a fall-back mechanism
2212 was put it place to allow references that are out-of-band to be resolved. If
2213 this happens a big warning message is logged. This fall-back mechanism will
2214 be removed in Ant 1.8.0.
2215
2216* <script> and <scriptdef> now set the current thread context.
2217
2218* Unrestrict the dbvendor names in the websphere element of the ejbjar task.
2219 Bugzilla Report 40475.
2220
2221* <env> nested element in <java>, <exec> and others is now case-insensitive
2222 for windows OS. Bugzilla Report 28874.
2223
2224* Removed support for xalan1 completely. Users of Xalan1 for Ant builds will
2225 have to stay at ant 1.6.5 or upgrade to xalan2.
2226
2227* Use org.apache.log4j.Logger instead of org.apache.log4j.Category.
2228 Category has been deprecated for ~2 years and has been removed from
2229 the log4j code. Logger was introduced in log4j 1.2 so users of
2230 log4j 1.1 and log4j 1.0 need to upgrade to a newer version of log4j.
2231 Bugzilla Report 31951.
2232
2233* build.sysclasspath now also affects the bootclasspath handling of
2234 spawned Java VMs. If you set build.sysclasspath to anything other
2235 than "ignore" (or leave it unset, since "ignore" is the default when
2236 it comes to bootclasspath handling), then the bootclasspath of the
2237 VM running Ant will be added to the bootclasspath you've specified.
2238
2239* The <java fork="false"> now as per default installs a security manager
2240 using the default permissions. This is now independent of the
2241 failonerror attribute. Bugzilla report 33361.
2242
2243* <signjar> now notices when the jar and signedjar are equal, and switches
2244 to the same dependency logic as when signedjar is omitted. This may break
2245 something that depended upon signing in this situation. However, since
2246 invoking the JDK jarsigner program with -signedjar set to the source jar
2247 actually crashes the JVM on our (Java1.5) systems, we don't think any
2248 build files which actually worked will be affected by the change.
2249
2250* <signjar> used to ignore a nested fileset when a jar was also provided as an
2251 attribute, printing a warning message; now it signs files in the fileset.
2252
2253* An improved method of handling timestamp granularity differences between
2254 client and server was added to the <ftp> task. FTP servers typically
2255 have HH:mm timestamps whereas local filesystems have HH:mm:ss timestamps.
2256 Previously, this required tweaking with the timediffmillis attribute
2257 which also was used to handle timezone differences. Now, there is a new
2258 timestampgranularity attribute. The default value for get operations is 0
2259 since the user has the more powerful preservelastmodified attribute to work
2260 with. Since this is not available on put operations the default value
2261 adds a minute to the server timestamp in order to account for this,
2262 Scripts which previously used timediffmillis to do this compensation may
2263 need to be rewritten. timediffmillis has now been deprecated.
2264
2265* Support for the XSL:P XML parser has been removed.
2266 Bugzilla Report 23455.
2267
2268* Visual Age for Java optional tasks removed as the required library is no
2269 longer available.
2270
2271* Testlet (test) optional task removed as the required library is no
2272 longer available.
2273
2274* IContract optional task removed as the required library is no
2275 longer available.
2276
2277* Metamata (maudit, mmetrics, and mparse tasks) removed as the required
2278 library is no longer available.
2279
2280* Sitraka (jpcoverage, jpcovmerge, jpcovreport) tasks suppressed as the
2281 required library is no longer available.
2282
2283* <fixcrlf> used \r (Mac) line endings on OS X, whose proper line separator
2284 is \n (Unix). Bugzilla report 39585.
2285
2286* <scp> now optionally supports the sftp protocol, you may need a
2287 newer jsch.jar. Bugzilla Report 39373.
2288
2289* Ant launcher program prints errors to stderr, and exits with a 2 exit code
2290 value if, for any reason, it cannot actually start Ant proper. This will only
2291 affect programs/scripts that called the launcher and which did not want to
2292 receive an error if Ant itself would not start
2293
2294* All .NET tasks are now deprecated in favor of the new .NET Antlib:
2295 http://ant.apache.org/antlibs/dotnet/index.html
2296
2297Fixed bugs:
2298-----------
2299* Directory deletion did not work properly.
2300 Bugzilla 40972.
2301
2302* docletpath attribute of javadoc was ignored.
2303 Bugzilla 40900.
2304
2305* Fixed incorrect recursion in DOMUtil.listChildNodes().
2306 Bugzilla 40918.
2307
2308* CompressedResource.compareTo() did not
2309 take comparison with another CompressedResource into account.
2310 Bugzilla 40949.
2311
2312* Avoid possible NPE in Jar.java.
2313 Bugzilla 40847.
2314
2315* regression in attribute prefix (+ others) for refid in zipfileset and tarfileset.
2316 Bugzilla 41004, 30498.
2317
2318* dependset failed if the basedir of a target fileset did not exist.
2319 Bugzilla 40916.
2320
2321* Recursive filtering encountered NullPointerExceptions under certain
2322 circumstances. Bugzilla 41086.
2323
2324* XmlProperty overrides previously set property value when handling duplicate
2325 elements. Bugzilla 41080.
2326
2327* Having many tasks causes OOM. Bugzilla 41049.
2328
2329* Regression: <path> was evaluating nested content only once, so that it could
2330 not e.g. pick up files that didn't exist the first time through.
2331 Bugzilla 41151.
2332
2333* OOM caused by IH holding on to classes and thus their classloaders.
2334 Bugzilla 28283 and 33061.
2335
2336* <delete> doesnt delete when defaultexcludes="false" and no includes is set
2337 fixed. Bugzilla 40313.
2338
2339* Behavior change of DirectoryScanner/AbstractFileset when conditional include
2340 patterns are used. Bugzilla 40722.
2341
2342* <javac> fails with NPE when compiling with eclipse ecj 3.1.x.
2343 Bugzilla 40839.
2344
2345* JUnitTestRunner had a NPE when unable to create parser, the exception
2346 containing the error did not get reported. Bugzilla 36733.
2347
2348* <checksum> with file and todir option failed. Bugzilla report 37386.
2349
2350* <path location="loc"> was broken (Regression from beta1).
2351 Bugzilla report 40547.
2352
2353* Nested fileset in <cab> did not work. Bugzilla report 39439.
2354
2355* The ant wrapper script should now correctly locate the java
2356 executable in more recent IBM JDKs for AIX as well.
2357
2358* URLResource did not close jar files, and also did not disconnect HTTPConnection (s).
2359
2360* Error calling junitreport. Bugzilla 40595.
2361
2362* <junittask/> created junitvmwatcher*.properties files but did not close and delete them.
2363
2364* <xmlproperty> did not create properties for empty leaf elements.
2365 Bugzilla report 26286.
2366
2367* UnknownElement.maybeConfigure always configured.
2368 Bugzilla report 40641.
2369
2370* No check for refid when prefix attribute is set in zipfileset.
2371 Bugzilla report 30498.
2372
2373* Fix for junit4 issue introduced since beta2.
2374 Bugzilla report 40682.
2375
2376* Error in duplicate project name with <import> and <antcall>.
2377 Bugzilla report 39920.
2378
2379* junit4 did not work with fork=no and junit4 in $ANT_HOME/lib.
2380 Bugzilla report 40697.
2381
2382* PathConvert on Windows should process forward and back slashes equivalently.
2383 Bugzilla report 32884.
2384
2385* ant.bat now looks in %USERPROFILE% and %HOMEDRIVE%%HOMEPATH% in addition to
2386 %HOME% for pre/post batch files. Bugzilla report 39298.
2387
2388* The inheritance hierarchy of the legacy <path> type was changed; code built
2389 against Ant 1.7 would therefore no longer execute on older versions of Ant.
2390 Since <path> is historically heavily used this was undesirable, and since it
2391 is also avoidable, the change to <path>'s taxonomy was reverted.
2392
2393* <zip filesonly="true"> included empty directories. Bugzilla report 40258.
2394
2395* Invalid hash code of Target causes XmlLogger to fail.
2396 Bugzilla report 40207.
2397
2398* Macro element did not include top level Text. Bugzilla report 36803.
2399
2400* AntClassLoader did not isolate resources when isolate was set. Bugzilla report 38747.
2401
2402* Diagnostics broken when using java 1.4. Bugzilla report 40395.
2403
2404* Exception reporting in <copy> was broken. Bugzilla report 40300.
2405
2406* Handling of corrupt tar files, TarInputStream.read() never returns EOF.
2407 Bugzilla report 39924.
2408
2409* Some bugs in ReaderInputStream. Bugzilla report 39635.
2410
2411* <antlr> did not recognise whether the target is up-to-date for html option.
2412 Bugzilla report 38451.
2413
2414* Documented minimal version of jsch now 0.1.29.
2415 Bugzilla report 40333.
2416
2417* <available> searched parent directories for files.
2418 Bugzilla report 37148.
2419
2420* The build could be halted if a file path contained more ".." components than
2421 the actual depth of the preceding path. Now such paths are left
2422 alone (meaning they will likely be treated as nonexistent
2423 files). Bugzilla Report 40281.
2424
2425* Converting a <dirset> to a string was broken. Bugzilla Report 39683.
2426
2427* Manifests have improved line length handling, taking care of encoding.
2428 Bug reports 37548 / 34425.
2429
2430* <manifest> now closes the inputstream explicitly. Bug report 39628.
2431
2432* <rpm> now also correctly searches the first element of the path.
2433 Bug report 39345.
2434
2435* ant.bat now handles classpath set to "". Bug report 38914.
2436
2437* <junit> now supports JUnit 4. Bugzilla Report 38811.
2438
2439* <junit> can now work with junit.jar in its <classpath>. Bugzilla
2440 Report 38799.
2441
2442* Some potential NullPointerExceptions, Bugzilla Reports 37765 and 38056.
2443
2444* Problem when adding multiple filter files, Bugzilla Report 37341.
2445
2446* Problem referencing jars specified by Class-Path attribute in manifest
2447 of a ant task jar file, when this ant task jar file is located in
2448 a directory with space, Bugzilla Report 37085.
2449
2450* Backward incompatible change in ZipFileSet, Bugzilla Report 35824.
2451
2452* Wrong replacement of file separator chars prevens junitbatchtest
2453 from running correctly on files from a zipfileset. Bugzilla Report 35499.
2454
2455* Calling close twice on ReaderInputStream gave a nullpointer exception.
2456 Bugzilla Report 35544.
2457
2458* Memory leak from IntrospectionHelper.getHelper(Class) in embedded
2459 environments. Bugzilla Report 30162.
2460
2461* Translate task does not remove tokens when a key is not found.
2462 It logs a verbose message. Bugzilla Report 13936.
2463
2464* Incorrect task name with invalid "javac" task after a "presetdef".
2465 Bugzilla reports 31389 and 29499.
2466
2467* <manifest> was not printing warnings about invalid manifest elements.
2468 Bugzilla report 32190.
2469
2470* <replace> got out of memory on large files (part of report 32566).
2471 <replace> can now handle files as long as there is enough disk space
2472 available.
2473
2474* Commandline.describeCommand() methods would attempt to describe
2475 arguments even when none, other than the executable name, were present.
2476
2477* Create signjar's helper ExecTask instance directly rather than by
2478 typedef discovery mechanisms. Bugzilla report 33433.
2479
2480* FileUtils.resolveFile() promised to return absolute files but
2481 did not always do so.
2482
2483* <ftp> failed to retrieve a file when the path towards the file contained
2484 an element starting with . Bugzilla report 33770.
2485
2486* "<rmic> always compiles on Java1.5" bugzilla report=33862. Fixed default
2487 stub version to always be "compat", even on Java1.5+.
2488
2489* The .NET compilation tasks failed if filenames given as references
2490 contained spaces. Bugzilla Report 27170.
2491
2492* SQL task would try access result sets of statements that didn't
2493 return any, causing problems with Informix IDS 9.2 and IBM DB2 8.1
2494 FixPak 6 (or later). Bugzilla Reports 27162 and 29954.
2495
2496* Task.init() was called twice for most tasks. Bugzilla Report 34411.
2497
2498* JavaTest testcases sometimes fail on windows. Bugzilla Report 34502.
2499
2500* Targets with identical name work in imported project. Bugzilla Report 34566.
2501
2502* DemuxOutputStream now uses a WeakHashMap to store the thread-stream mapping,
2503 to avoid holding on to thread references after they terminate.
2504
2505* <xmlvalidate> and <schemavalidate> create a new parser for every file in a
2506 fileset, and so validate multiple files properly. Bugzilla Report 32791.
2507
2508* <tar> / <untar> now accepts files upto 8GB, <tar> gives an error if larger
2509 files are to be included. This is the POSIX size limit.
2510
2511* <junitreport> removed line-breaks from stack-traces. Bugzilla
2512 Report 34963.
2513
2514* Off-by-one error in environment setup for execution under OpenVMS fixed.
2515
2516* Bugzilla report 36171: -noclasspath crashes ant if no system
2517 classpath is set.
2518
2519* <pvcs> used wrong switch for retrieving revisions by label.
2520 Bugzilla Report 36359.
2521
2522* <sshexec> closed System.out, disabling output on second and subsequent
2523 invocations. Bugzilla report 36302.
2524
2525* <cvschangelog> was crashing with CVS versions >= 1.12.x due to change in
2526 the date format. Bugzilla report 30962.
2527
2528* The same IntrospectionHelper instance was continuously added as a listener
2529 to project. Bugzilla report 37184.
2530
2531* FileUtils.toURI() was not encoding non-ASCII characters to ASCII,
2532 causing impossibility to process XML entities referenced by XML
2533 documents in non ASCII paths. Bugzilla report 37348.
2534
2535* > 1 ssh invocations to a given host would fail. Bugzilla report 36207.
2536
2537* EmailTask was eating SMTP error messages. Bugzilla report 37547.
2538
2539* PropertySet API setMapper(...) didn't properly set up the Mapper.
2540 Bugzilla report 37760.
2541
2542* Proper return code for ant.bat. Bugzilla report 13655.
2543
2544* Project not set on ChainReaderHelpers used by the Redirector.
2545 Bugzilla report 37958.
2546
2547* Copy task would fail on locked (or otherwise uncopyable) files even if
2548 failonerror set to false. Bugzilla report 38175.
2549
2550* <junit> task did not print all the Test names when using forkmode='once'.
2551 Bugzilla report 37426.
2552
2553* <available> could leak resources, Bugzilla Report 38260.
2554
2555* Redirector called Thread.sleep in a synchronized block. Bugzilla
2556 report 37767.
2557
2558* CCUnlock's objselect attribute could exhibit unpredictable behavior;
2559 standardized improperly included objselect and objsel property accessors to
2560 delegate to the inherited objSelect property accessor. Bugzilla report 37766.
2561
2562* <unzip> and <untar> now correctly merge multiple nested patternsets.
2563 Bugzilla Report 38973.
2564
2565* On case-insensitive filesystems, a <move> to change filename case
2566 erroneously deleted the "destination" file before attempting to rename
2567 the source file. Bugzilla 37701.
2568
2569* <scp> can now handle uris with @s other than the final one denoting the
2570 domain. Bugzilla 38082.
2571
2572* If the class invoked by the <java> task threw a ClassNotFoundException,
2573 this was misinterpreted as the specified class itself not being found.
2574
2575* <echoproperties> setPrefix javadoc claimed null or empty prefix would be
2576 ignored; instead an error was thrown. Bugzilla report 39954.
2577
2578* <get> would fetch files that were up to date, because it used > in a
2579 remote/local timestamp comparison, not >=. Bugzilla 35607.
2580
2581* <xslt> passes the current file (name + directory) to the
2582 stylesheet/transformation. xsl-parameter name is configurable.
2583 Bugzilla report 21042.
2584
2585* The <zip> API allowed creation of directories in file-only archives; a
2586 habitual offender was the subclassed <jar>, which included META-INF/ in
2587 the destination file regardless of whether filesonly was set to true.
2588
2589* <rmic> has a new adapter, xnew, to use the -XNew back end on java1.5+.
2590 By forking rmic, this works on java1.6+. Bugzilla report 38732.
2591
2592* Copy of UnknownElement in macroinstance was not recursive.
2593 Bugzilla report 40238.
2594
2595* Mixing of add and addConfigured methods in Mapper/ChainedMapper
2596 causes incorrect chaining. Bugzilla report 40228.
2597
2598Other changes:
2599--------------
2600
2601* Warn user when a reference in the form "${refid}" cannot be resolved as this
2602 is a sign they probably meant "refid" (misuse of property expansion syntax).
2603
2604* Add dtd to javadoc for junit.
2605 Bugzilla 40754.
2606
2607* Add quiet attribute to loadfile/resource.
2608 Bugzilla 38249.
2609
2610* Make Locator#fromURI also append the drive letter when running under Windows
2611 with JDK 1.3 or 1.2.
2612
2613* Do not uppercase the drive letters systematically in FileUtils#normalize.
2614
2615* Java 5 enumerations may now be used as values in XML attributes in place of
2616 EnumeratedAttribute. Bugzilla 41058.
2617
2618* Create a pom file for ant-testutil and add ant-testutil.jar to the ant
2619 distribution. Bugzilla 40980.
2620
2621* Roll back automatic proxy enabling on Java 1.5. It broke things like
2622 Oracle JDBC drivers, and Ant itself on IBM's JVM on AIX, and didnt
2623 seem to work to well the rest of the time.
2624 To enable the feature, use the -autoproxy command line option.
2625
2626* Upgraded XML API and parser to Xerces 2.8.1
2627
2628* A code review of some threaded logic has tightened up the synchronization
2629 of Watchdog, ExecuteWatchdog and ExecuteJava, which could reduce the occurence
2630 of race conditions here, especially on Java1.5+.
2631
2632* Allow broken reference build files. The defer reference processing would
2633 break too many files - so allow them with a warning.
2634
2635* Removed dependency on sun.misc.UUEncoder for UUMailer.
2636
2637* Added regex attribute to the echoproperties task.
2638 Bugzilla 40019.
2639
2640* <war> task now allows you to omit the web.xml file. as this is optional
2641 in the servlet 2.5 and Java EE 5 APIs. set needxmlfile="false" to
2642 avoid a missing web.xml file from halting the build.
2643
2644* Diagnostics catches and logs security exceptions when accessing system properties.
2645
2646* <javadoc> useexternalfile now applies to all command line arguments
2647 of javadoc. Bugzilla report 40852.
2648
2649* javadoc/tag@description is now set to the name if description is
2650 not specified. Bugzill report 32927.
2651
2652* Some performance improvements, including Bugzilla report 25778.
2653
2654* Add <matches> condition. Bugzilla report 28883.
2655
2656* Extending JAR-Task for SPI. Bugzilla report 31520.
2657
2658* Added <tokens> resource collection for convenient creation of string
2659 resources from other resources' content. Inspired by Bugzilla 40504.
2660
2661* Added <compare> resource selector to select resources based on the
2662 results of their comparison to other resources.
2663
2664* Added outputtoformatters attribute to <junit> to allow suppression
2665 of noisey tests. Bugzilla report 12817.
2666
2667* Log level of message 'Overriding previous definition of reference to'
2668 set to Verbose. Bugzilla report 17240.
2669
2670* Added setbeans attribute to <script> to allow <script>'s to be
2671 run without referencing all references.
2672 Bugzilla report 37688.
2673
2674* Added classpath attribute and nested element to <script> to allow
2675 the language jars to be specified in the build script.
2676 Bugzilla report 29676.
2677
2678* Trim the driver attribute on the <sql> task. Bugzilla report 21228.
2679
2680* Allow (jar) files as well as directories to be given to jdepend.
2681 Bugzilla report 28865.
2682
2683* Convert SplashTask to use NOT sun internal classes.
2684 Bugzilla report 35619.
2685
2686* Made PatternSet#hasPatterns public to allow custom filesets access.
2687 Bugzilla report 36772.
2688
2689* Added searchparents attribute to <available>. Bugzilla report 39549.
2690
2691* Tasks that don't extend Ant's Task class will now get the build file
2692 location reflected into a method of the signature void setLocation(Location)
2693 - if such a method exists.
2694
2695* Remove needless synchronization in DirectoryScanner.
2696 Bugzilla report 40237.
2697
2698* Improved recursion detection for lines with multiple matches of same token
2699 on a single line. Bugzilla report 38456.
2700
2701* Task will now log correctly even if no project is set.
2702 Bugzilla report 38458.
2703
2704* Use alternative names for the command line arguments in javac. Bugzilla
2705 Report 37546.
2706
2707* The Reference class now has a project field that will get
2708 used (if set) in preference to the passed in project, when
2709 dereferencing the reference. Bugzilla Report 25777.
2710
2711* On DOS and Netware, filenames beginning with a drive letter
2712 and followed by a colon but with no directory separator following
2713 the colon are no longer (incorrectly) accepted as absolute pathnames
2714 by FileUtils.normalize() and FileUtils.isAbsolutePath(). Netware
2715 volumes can still be specified without an intervening separator.
2716 UNC pathnames on Windows must include a server and share name, i.e.
2717 "\\a\b" to be considered valid absolute paths.
2718
2719* A bug in SQLExec would prevent the execution of trailing,
2720 non-semicolon-delimited statements. Bugzilla Report 37764.
2721
2722* InputHandler implementations may now call InputRequest.getDefaultValue()
2723 if they wish. The default handler uses this also. Bugzilla report 28621.
2724
2725* Took in bugzilla report 39320, "Simple code cleanups"
2726
2727* Improve compatibility with GNU Classpath and java versions prior to
2728 1.5. Bugzilla 39027.
2729
2730* ${ant.core.lib} may now be used to refer to the library containing the
2731 Ant classes, for instance useful when compiling tasks.
2732
2733* Minor performance improvements Bugzilla report 37777
2734
2735* New task <manifestclasspath> converts a path into a property
2736 suitable as the value for a manifest's Class-Path attribute.
2737
2738* Fixed references to obsoleted CVS web site. Bugzilla Report 36854.
2739
2740* Log fine-grained events at verbose level from JUnit. Bugzilla report 31885.
2741
2742* <WsdlToDotnet> and <style> are now deprecated in favor of <wsdltodotnet> and
2743 <xslt>, respectively. Bugzilla report 25832.
2744
2745* <echoproperties> now (alphanumerically) sorts the property list
2746 before echoing. Bugzilla report 18976.
2747
2748* A new base class DispatchTask has been added to facilitate elegant
2749 creation of tasks with multiple actions.
2750
2751* Major revision of <wsdltodotnet>. Supports mono wsdl and the microsoft
2752 wsdl run on mono, as well as most of the .NET WSE2.0 options. Extra
2753 schemas (files or urls) can be named in the <schema> element.
2754 Compilers can be selected using the compiler attribute, which defaults
2755 to "microsoft" on windows, and "mono" on everything else.
2756
2757* It is now possible to specify the pattern created/parsed by <checksum>.
2758 Bugzilla Report 16539.
2759
2760* Added a new "failall" value for the onerror attribute of <typedef>.
2761 Bugzilla report 31685.
2762
2763* unzip/unwar/unjar/untar now supports a nested mapper, which lets you unzip
2764 in useful ways.
2765
2766* Junit task -- display suite first.
2767 Bugzilla report 31962.
2768
2769* Added isSigned condition and signedselector selector
2770 Bugzilla report 32126.
2771
2772* Added preserveLastModified attribute to signjar task.
2773 Bugzilla report 30987.
2774
2775* Added <scriptcondition> condition, for inline scripted conditions
2776
2777* Added <xor> condition for exclusive-or combining of nested conditions.
2778
2779* Added <scriptselector> selector for scripted file selection
2780
2781* ant -diagnostics lists contents of ${user.home}/.ant/lib , and
2782 checks that the java.io.tmpdir directory exists and is writeable.
2783
2784* mail task accepts nested header element. Bugzilla report 24713.
2785
2786* zip/jar/war/ear supports level attribute for deflate compression level.
2787 Bugzilla report 25513.
2788
2789* Added loginputstring attribute to the redirector type.
2790
2791* Tighten security by sending storepass and keypass to signjar
2792 via the input stream of the forked process.
2793
2794* New task <schemavalidate> extends <xmlvalidate> with extra support
2795 for XML Schema (XSD) files.
2796
2797* <fixcrlf> supports a file attribute for easy fixup of a single file.
2798
2799* New condition <parsersupports> which can look for XML parser feature or
2800 property support in the parser Ant is using.
2801
2802* fixcrlf can be used in a filterchain.
2803
2804* <sync> has a new nested element <preserveInTarget> that can be used
2805 to protect extra-content in the target directory. Bugzilla Report
2806 21832.
2807
2808* <signjar> now supports:
2809 -nested filesets at the same time as the jar attribute
2810 -a destDir attribute with the appropriate dependency logic, which
2811 can be used with the jar attribute or nested filesets
2812 -a mapper to permit filename remapping on signing
2813 -tsaurl and tsacert attributes for timestamped JAR signing
2814 -nested <sysproperty> elements, which can be used for proxy setup
2815 and the like
2816
2817* The linecontains and linecontainsregexp filterreaders now support a
2818 negate attribute to select lines -not- containing specified text.
2819 Bugzilla Report 34374.
2820
2821* <os> condition adds "winnt" as a family which can be tested. This is
2822 all windows platforms other than the Win9x line or Windows CE.
2823
2824* <exec> (and hence, <apply> and any other derived classes) have an OsFamily
2825 attribute, which can restrict execution to a single OS family.
2826
2827* Added "backtrace" attribute to macrodef. Bugzilla report 27219.
2828
2829* Ant main provides some diagnostics if it ever sees a -cp or -lib option,
2830 as this is indicative of a script mismatch. Bugzilla report 34860
2831
2832* <junitreport> prints a special message if supplied an empty XML File. This
2833 can be caused by the test JVM exiting during a test, either via a
2834 System.exit() call or a JVM crash.
2835
2836* Project name is now used for *all* targets so one can write consistent import
2837 build files. Bugzilla report 28444.
2838
2839* New condition <typefound> that can be used to probe for the declaration
2840 and implementation of a task, type, preset, macro, scriptdef, whatever.
2841 As it tests for the implementation, it can be used to check for optional
2842 tasks being available.
2843
2844* Check for 1.5.* Ant main class. (weblogic.jar in classpath reports)
2845
2846* New condition <isfailure> that tests the return-code of an executable. This
2847 contains platform-specific logic and is better than comparing the result with
2848 "0".
2849
2850* Added initial support for Resource Collections, including the
2851 resourcecount task.
2852
2853* property attribute of pathconvert is now optional. If omitted the
2854 result will be written to the log.
2855
2856* New mapper, <scriptmapper>, supports scripted mapping of source files/strings
2857 to destination strings.
2858
2859* Add the echoxml task. This will echo nested XML to a file, with
2860 the normal <?xml ?> processor instruction. UTF-8 encoding only; no-namespace
2861 support.
2862
2863* Try to make subprojects of custom Project subclasses instances of the
2864 same type. Bugzilla report 17901.
2865
2866* <ssh> and <scp> support keyboard-interactive authentication now.
2867
2868* <javadoc> now supports -breakiterator for custom doclets if Ant is
2869 running on JSE 5.0 or higher. Bugzilla Report: 34580.
2870
2871* New logger, TimestampedLogger, that prints the wall time that a build
2872 finished/failed. Use with
2873 -logger org.apache.tools.ant.listener.TimestampedLogger
2874
2875* <junitreport> now generates pages alltests-errors.html and
2876 alltests-fails.html, that list only the errors and failures, respectively.
2877 Bugzilla Report: 36226
2878
2879* New task <makeurl> that can turn a file reference into an absolute file://
2880 url; and nested filesets/paths into a (space, comma, whatever) separated
2881 list of URLs. Useful for RMI classpath setup, amongst other things.
2882
2883* <xslt> now accepts nested FileNameMappers e.g. <globmapper>.
2884 Bugzilla report 37604.
2885
2886* New task <loadresource> that accompanies <loadfile> for non file resources.
2887
2888* <echo> now supports an encoding when saving to a file.
2889
2890* New GreedyInputHandler added.
2891
2892* Add textfile attribute to the <filesmatch> condition. When true, the text
2893 contents of the two files are compared, ignoring line ending differences.
2894
2895* New <resourcesmatch> condition.
2896
2897* Added the onmissingfiltersfile attribute to filterset. Bugzilla report 19845.
2898
2899* Added the inline handler element to the input task.
2900
2901* <sql> supports property expansion if you set the expandProperties
2902 attribute. By default it does not expand properties, something we
2903 dare not change for fear of breaking complex SQL operations in
2904 existing files.
2905
2906* <javadoc>'s packagenames attribute is now optional and defaults to "*".
2907
2908* <javac>'s source and target attributes as well as <javadoc>'s source
2909 attribute will read default values from the properties
2910 ant.build.javac.source and ant.build.javac.target.
2911
2912* Handling of ' ', '#' in CLASSPATH and '#' in -lib (cannot use ' '
2913 in -lib on UNIX at the moment). Bugzilla Report 39295.
2914
2915* <scp> now optionally supports the sftp protocol. Bugzilla Report 39373.
2916
2917* Resources can now be used to indicate the location of the stylesheet to use
2918 in <xslt>. Bugzilla Report 39407.
2919
2920* New <antversion> condition. Bugzilla report 32804.
2921
2922* ReplaceTokens should allow properties files. Bugzilla report 39688.
2923
2924* FTP Account could not be specified in ant FTP task. Bugzilla report 39720.
2925
2926* Minor performance updates. Bugzilla report 39565.
2927
2928* New deleteonexit attribute for the <tempfile> task. Bugzilla report 39842.
2929 Remember that the exit of the JVM can be a long time coming,
2930 especially under an IDE. Don't rely on this being called.
2931
2932* <scriptdef>-created scripts have support for nested text. All text
2933 passed to a scripted task can be accessed via self.text.
2934
2935* <fixcrlf> now supports an outputencoding attribute. Bugzilla report 39697.
2936
2937* <junitreport> now supports nested XSL parameters. Bugzilla report 39708.
2938
2939* <javacc> has a jdkversion attribute to pass the desired JDK version
2940 down to javacc. Bugzilla report 38715.
2941
2942* <cvs> prints passfile info at -verbose level instead of -info. Bugzilla
2943 report 35268
2944
2945* When <javac> can't find the compiler class, it prints out java.home for
2946 immediate diagnostics
2947
2948* Ant launcher now supports a -main attribute so that you can specify
2949 an extension class to the built in org.apache.tools.ant.Main
2950 class. This class must implement the interface AntMain
2951
2952Changes from Ant 1.6.4 to Ant 1.6.5
2953===================================
2954
2955Changes that could break older environments:
2956--------------------------------------------
2957
2958Fixed bugs:
2959-----------
2960
2961* <move> was unable to replace existing files or write into
2962 existing directories. Bugzilla report 34962.
2963
2964* <macrodef> with redefined default values was incorrect. (Fix for
2965 31215 had a bug). Bugzilla report 35109.
2966
2967* <javadoc> will convert backslashes to forwardslashes when generating file
2968 list by useexternalfile. Bugzilla report 27814.
2969
2970Changes from Ant 1.6.3 to Ant 1.6.4
2971===================================
2972
2973Changes that could break older environments:
2974--------------------------------------------
2975* <ftp> task has had a number of changes. Uptodate calculation previously
2976 did not call a file uptodate if the source timestamp and the destination
2977 timestamp were equal. Bugzilla report 34941. Any script that attempted
2978 to compensate for this by using the timediffmillis attribute might need
2979 to be tweaked.
2980
2981
2982Fixed bugs:
2983-----------
2984
2985* Sun javah failed with java.lang.NoClassDefFoundError.
2986 Bugzilla report 34681.
2987
2988* DirectoryScanner.slowScan() was broken. Bugzilla report 34722.
2989
2990* DirectoryScanner.scan() could throw a NullPointerException on
2991 case-insensitive filesystems (read Windows or MacOS X).
2992
2993* Get w/authentication failed with ArrayOutOfBoundsExceptions.
2994 Bugzilla report 34734.
2995
2996* Granularity attribute for <sync> task was undocumented.
2997 Bugzilla report 34871.
2998
2999* <unzip> and <untar> could leave file handles open on invalid
3000 archives. Bugzilla report 34893.
3001
3002* propertyset threw NPE with nested, mapped propertysets.
3003
3004Other changes:
3005--------------
3006
3007* AntXMLContext.setCurrentTargets() is now public. Bugzilla report 34680.
3008
3009Changes from Ant 1.6.2 to Ant 1.6.3
3010===================================
3011
3012Changes that could break older environments:
3013--------------------------------------------
3014
3015* The subant task used the canonical version of a file path. This
3016 has been changed to use the absolute path. Bugzilla 30438.
3017
3018* Tar now writes two EOF blocks rather than one.
3019 Bugzilla report 28776
3020
3021* The Reference object now has a project field which it uses in preference
3022 to the project passed in. This allows composite references to be
3023 handled to nested projects.
3024 Bugzilla report 25777
3025
3026* <junit> with filtertrace="true" will now also swallow lines for the
3027 sun.reflect package. If you need to see them in your stack trace,
3028 you must set filtertrace to false.
3029 Bugzilla Report 22758
3030
3031* The jikes compiler adapter now supports -bootclasspath, -extdirs and
3032 -sourcepath and also uses the same logic for debug flags as javac.
3033 This means, the jikes compiler adapter now requires Jikes 1.15 or later.
3034 Bugzilla Reports 25868, 26404 and 32609.
3035
3036* The gcj compiler adapter used to include the Java runtime classes
3037 even if includeJavaRuntime was set to false, unless the
3038 bootclasspath has been specified as well. It will now always adhere
3039 to includeJavaRuntime, you may need to set it to true explicitly now
3040 if you relied on the old behavior.
3041
3042Other changes:
3043--------------
3044
3045* <javadoc> can now take an attribute 'executable'. Bugzilla report 30606.
3046
3047* New attribute ignorecontents for <different> selector
3048
3049* Javadoc fixes for Location, Project, and RuntimeConfigurable
3050 Bugzilla 30160.
3051
3052* Enable to choose the regexp implementation without system property.
3053 Bugzilla Report 15390.
3054
3055* Expose objects and methods in IntrospectionHelper. Bugzilla Report 30794.
3056
3057* Allow file attribute of <move> to rename a directory.
3058 Bugzilla Report 22863.
3059
3060* Add xmlcatalog nested element to XmlProperty. Bugzilla report 27053.
3061
3062* New attribute alwayslog for <redirector> type.
3063
3064* Added <target> nested elements to <ant> and <antcall> to allow
3065 specification of multiple sub-build targets, which are executed
3066 with a single dependency analysis.
3067
3068* Refactored Target invocation into org.apache.tools.ant.Executor
3069 implementations. Bugzilla Reports 21421, 29248.
3070
3071* <rmic> now also supports Kaffe's rmic version shipping with Kaffe
3072 1.1.2 and above.
3073
3074* added casesensitive attribute to <globmapper> and <regexpmapper>
3075 Bugzilla report 16686
3076
3077* added handledirsep attribute to <globmapper> and <regexpmapper>
3078 Bugzilla report 32487
3079
3080* added a new mapper <filtermapper>
3081
3082* When a BuildListener tried to access System.err or System.out, Ant
3083 would have thrown an exception - this has been changed. Ant now
3084 silently ignores the message. BuildListeners still should avoid
3085 accessing either stream.
3086
3087* Added a comment attribute to the zip task.
3088 Bugzilla report 22793.
3089
3090* Overloaded FileUtils.createNewFile with a boolean mkdirs attribute
3091 to create nonexistent parent directories.
3092
3093* <apply> has a new "force" attribute that, when true, disables
3094 checking of target files.
3095
3096* Made the dest attribute of the apply task optional; mapped target
3097 filenames will be interpreted as absolute pathnames when dest is omitted.
3098
3099* Changed default tempdir for <javac> from user.dir to java.io.tmpdir.
3100
3101* Added searchpath attribute to <exec> for searching path variable(s)
3102 when resolveexecutable = true.
3103
3104* Added revision and userid attributes to <pvcs> documentation.
3105
3106* Added support to the touch task for a mkdirs attribute to create
3107 nonexistent parent directories before touching new files.
3108
3109* Added support to the touch task for a pattern attribute to allow
3110 alternate datetime formats.
3111
3112* Added support to the touch task to map touched files using a nested
3113 mapper element.
3114
3115* Added support to the touch task for a verbose attribute to suppress
3116 logging of new file creation.
3117
3118* bad link in docs to the enhancement page in bugzilla.
3119 Bugzilla report 33252.
3120
3121* Added length task to get strings' and files' lengths.
3122
3123* <native2ascii> and <javah> now also support Kaffe's versions.
3124
3125* Recursive token expansion in a filterset can now be disabled by
3126 setting its recurse attribute to false.
3127
3128* Pathconvert no longer requires that one of (targetos|pathsep|dirsep)
3129 be set; platform defaults are used when this is the case.
3130
3131* Added preservelastmodified attribute to fixcrlf task. Bugzilla 25770.
3132
3133* Added isfileselected condition.
3134
3135* Added verbose="true|false" attribute to <subant>. When verbose is enabled,
3136 the directory name is logged on entry and exit of the sub-build.
3137 Bugzilla 33787.
3138
3139* Added -nouserlib option to allow running ant without automatically loading
3140 up ${user.home}/.lib/ant. This is useful when compiling ant, and antlibs.
3141 Modified the build.sh and build.bat to use the option.
3142
3143* Added -noclasspath option to allow running ant WITHOUT using CLASSPATH env
3144 variable. Modified ant.bat to do this so that %CLASSPATH% is not looked at.
3145
3146* Add else attribute to the condition task, which specifies an
3147 optional alternate value to set the property to if the nested
3148 condition evaluates to false. Bugzilla report 33074.
3149
3150* Ant generated jar files should now be detected as jar files by
3151 Solaris. Bugzilla Report 32649.
3152
3153* <rexec> with a single command should now work with unusal login
3154 dialogs without special read/write pairs. Bugzilla Report 26632.
3155
3156* <csc>'s extraoptions can now contain multiple arguments.
3157 Bugzilla Report 23599.
3158
3159* <macrodef> with default values set by properties would be
3160 seen as new definitions when called twice with different properties.
3161 This was confusing so the definitions are now treated as similar.
3162 Bugzilla Report 31215.
3163
3164* <javadoc> has a new attribute "includenosourcepackages" that can be
3165 used to document packages that don't hold source files but a
3166 package.html file. Bugzilla Report 25339.
3167
3168* <rpm> has new attributes failonerror and quiet.
3169
3170* Added two tutorials
3171 - beginner: introduction into Ant
3172 - task developers: using path, fileset etc
3173
3174* a number of new attributes that allow the user to handle non-standard
3175 server listing formats and time zone differences have been added in
3176 the <ftp> task.
3177
3178
3179Fixed bugs:
3180-----------
3181
3182* Do not pass on ThreadDeath when halting <java fork="false">. Bugzilla
3183 32941.
3184
3185* Killing a thread running <java fork="true"> (e.g. from an IDE) would
3186 not stop the forked process. Bugzilla 31928.
3187
3188* Programs run with <java fork="true"> can now accept standard input
3189 from the Ant console. (Programs run with <java fork="false"> could
3190 already do so.) Bugzilla 24918.
3191
3192* AbstractCvsTask prematurely closed its outputStream and errorStream.
3193 Bugzilla 30097.
3194
3195* Impossible to use implicit classpath for <taskdef>
3196 when Ant core loader != Java application loader and
3197 Path.systemClassPath taken from ${java.class.path} Bugzilla 30161.
3198
3199* MacroInstance did not clean up nested elements correctly in the execute
3200 method, causing multiple use of the same macro instance with nested
3201 elements to fail.
3202
3203* checksum fileext property doc wrong. Bugzilla 30787.
3204
3205* FTP task, getTimeDiff method was returning wrong value. Bugzilla 30595.
3206
3207* make sure that Zip and its derivates call the createEmptyZip method when
3208 there are no resources to zip/jar/...
3209
3210* Zip task was not zipping when only empty directories were found.
3211 Bugzilla 30365.
3212
3213* Jar task was not including manifest files when duplicate="preserve" was
3214 chosen. Bugzilla 32802.
3215
3216* ant.bat was missing runAntNoClasspath label for goto.
3217 Bugzilla 34510.
3218
3219* Classpath was treated in the same way as -lib options. Bugzilla 28046.
3220
3221* Manual page for cvsversion contained incorrect attributes and did not
3222 say since 1.6.1. Bugzilla 31408.
3223
3224* Typo in definition of <cvsversion> task causing it not to be defined.
3225 Bugzilla 31403.
3226
3227* Execution of top level tasks in imported files get delayed by targets.
3228 Bugzilla report 31487.
3229
3230* ExecTask executes checkConfiguration() even though os does not match.
3231 Bugzilla report 31805.
3232
3233* Concat task instance could not be run twice.
3234 Bugzilla report 31814.
3235
3236* NPE using XmlLogger and antlib.
3237 Bugzilla report 31840.
3238
3239* Properties.propertyNames() should be used instead of .keys().
3240 Bugzilla report 27261.
3241
3242* Target location is not set for default target.
3243 Bugzilla report 32267.
3244
3245* Incorrect classloader parent in junittask when using with
3246 ant-junit.jar and junit.jar not in the project classloader. Bugzilla
3247 report 28474.
3248
3249* getResources() on the classloader returned by ClasspathUtils would
3250 see each resource twice - if the resource is in the project
3251 classpath and if the classloader is requested with a null path.
3252
3253* XMLValidate used URL#getFile rather than the ant method FileUtils#fromURI
3254 Bugzilla report 32508
3255
3256* fixed Regexp-Mapper docs which gave outdated instructions (optional.jar)
3257 Bugzilla report 28584
3258
3259* <scp> using <fileset> didn't work with OpenSSH 3.9 and later.
3260 Bugzilla report 31939
3261
3262* <setproxy> failed to set user/password on some JDKs.
3263 Bugzilla report 32667
3264
3265* untar would go into infinite loop for some invalid tar files.
3266 Bugzilla report 29877
3267
3268* forked <javac> won't pass -source to a JDK 1.1 or 1.2 javac anymore.
3269 Bugzilla report 32948
3270
3271* propertyset references did not handle nested propertyset references.
3272
3273* oata.types.Description.getDescription(Project) would throw a
3274 NullPointerException when the "ant.targets" reference was unset.
3275
3276* Wrapper scripts did not detect WINNT value of dynamic OS environment
3277 variable when logged into workstations using Novell authentication.
3278 Bugzilla Report 30366.
3279
3280* DependScanner.getResource() always returned nonexistent resources,
3281 even when the resource actually existed. Bugzilla Report 30558.
3282
3283* <apply> was broken with classfilesets. Bugzilla Report 30567.
3284
3285* <available> returned false positives when checking a file
3286 passed in with the current basedir leading twice:
3287 e.g. ${basedir}${file.separator}${basedir}${file.separator}foo .
3288
3289* The first file open that took place when using input files with the
3290 <exec>, <apply>, or <java> tasks was always logged to System.out
3291 instead of to the managing Task.
3292
3293* <telnet> and <rexec> would try to disconnect from servers they never
3294 connetced to, potentially leading to exceptions in commons-net.
3295 Bugzilla Report 33618.
3296
3297* <zip> would drop files matched by defaultexcludes during updates.
3298 Bugzilla Report 33412.
3299
3300* <zip> couldn't store files with size between 2GB and 4GB (the
3301 upper limit set by the ZIP format itself). Bugzilla Report 33310.
3302
3303* NPE when when <presetdef> tries to configure a task that
3304 cannot be instantiated. Bugzilla Report 33689.
3305
3306* <javac debug="false"> created an invalid command line when running
3307 the Symantec Java compiler.
3308
3309* Get with usetimestamp did not work on Java 1.2.
3310
3311* Get with usetimestamp did not work when local timestamp roughly >= now.
3312
3313* The framed JUnit report now handles multiple reports for the same
3314 testcase properly. Bugzilla Report 32745.
3315
3316* <cab> didn't work for files with spaces in their names on Windows.
3317 Bugzilla Report 17182.
3318
3319* The VAJ tasks could fail if the project name contained characters
3320 that need to get URL encoded. Bugzilla Report 23322.
3321
3322* TarInputStream#read() wasn't implemented correctly. Bugzilla Report
3323 34097.
3324
3325* <xslt> failed to process file-hierarchies of more than one level if
3326 scanincludeddirectories was true. Bugzilla Report 24866.
3327
3328* forkmode="perBatch" or "once" would ignore extension attributes that
3329 had been specified for <formatter>s. Bugzilla Report 32973.
3330
3331* The refid attribute of the I/O redirector was not functional.
3332
3333Changes from Ant 1.6.1 to Ant 1.6.2
3334===================================
3335
3336Changes that could break older environments:
3337--------------------------------------------
3338
3339* The import task used the canonical version of a file path. This
3340 has been changed to use the absolute path. Bugzilla 28505.
3341
3342* ant-xalan2.jar has been removed since the only class contained in it
3343 didn't depend on Xalan-J 2 at all. Its sole dependency has always
3344 been TraX and so it has been merged into ant-trax.jar.
3345
3346* All exceptions thrown by tasks are now wrapped in a buildexception
3347 giving the location in the buildfile of the task.
3348
3349* Nested elements for namespaced tasks and types may belong to the
3350 Ant default namespace as well as the task's or type's namespace.
3351
3352* <junitreport> will very likely no longer work with Xalan-J 1.
3353
3354 Note that Xalan-J 1 has been deprecated for a very long time and we
3355 highly recommend that you upgrade.
3356
3357 If you really need to continue using Xalan-J 1, please copy the
3358 junit-frames-xalan1.xsl from the distribution's etc directory as
3359 junit-frames.xsl into a new directory and use the task's styledir
3360 attribute to point to. This is the last version of the XSLT
3361 stylesheet that is expected to be compatible with Xalan-J 1.
3362
3363Fixed bugs:
3364-----------
3365
3366* eliminate memory leak in AntClassLoader. Bugzilla Report 8689.
3367
3368* subant haltonfailure=false did not catch all failures. Bugzilla Report 27007.
3369
3370* macrodef @@ escaping was broken. Bugzilla Report 27069.
3371
3372* MacroDef did not allow attributes named 'description'. Bugzilla Report 27175.
3373
3374* Throw build exception if name attribute missing from patternset#NameEntry.
3375 Bugzilla Report 25982.
3376
3377* Throw build exception if target repeated in build file, but allow targets
3378 to be repeated in imported files.
3379
3380* <apply> didn't compare timestamps of source and targetfiles when
3381 using a nested <filelist>. Bugzilla Report 26985.
3382
3383* tagdiff.xml was broken in ant 1.6.1. Bugzilla Report 27057.
3384
3385* if the basedir contained .. or . dirs, and the build file name contained
3386 .. or ., the basedir was set incorrectly. Bugzilla Report 26765.
3387
3388* regression from ant 1.5, exec task outputted two redundant trailing newlines.
3389 Bugzilla Report 27546.
3390
3391* NPE when running commons listener. Bugzilla Report 27373.
3392
3393* <java> swallowed the stack trace of exceptions thrown by the
3394 executed program if run in the same VM.
3395
3396* -projecthelp swallowed (configuration) errors silently.
3397 Bugzilla report 27732.
3398
3399* filterset used by filtertask doesn't respect loglevel. Bugzilla Report 27568.
3400
3401* wrong compare used in ProjectComponent for logging. Bugzilla Report 28070.
3402
3403* failOnAny attribute for <parallel> was broken. Bugzilla Report 28122.
3404
3405* If <javac> uses gcj and any of the nested <compilerarg>s implies
3406 compilation to native code (like -o or --main), Ant will not pass
3407 the -C switch to gcj. This means you can now compile to native code
3408 with gcj which has been impossible in Ant < 1.6.2.
3409
3410* <import optional="false"> and <import optional="true">
3411 behaved identically.
3412
3413* <xslt> now sets the context classloader if you've specified a nested
3414 <classpath>. Bugzilla Report 24802.
3415
3416* <zip> and friends would delete the original file when trying to update
3417 a read-only archive. Bugzilla Report 28419.
3418
3419* <junit> and <assertions> are working together. Bugzilla report 27218
3420
3421* AntClassLoader#getResource could return invalid URLs. Bugzilla
3422 Report 28060.
3423
3424* Ant failed to locate tools.jar if the jre directory name wasn't all
3425 lowercase. Bugzilla Report 25798.
3426
3427* Redirector exhibited inconsistent behavior with regard to split
3428 output. When sent to file only, files would be created in all
3429 cases; when split file-property, files were only created if
3430 writes were performed.
3431
3432* fixed case handling of scriptdef attributes and elements.
3433
3434* UNC pathnames did not work for ANT_HOME or -lib locations on Windows.
3435 Bugzilla report 27922.
3436
3437* replacestring tokenfilter only replaced the first occurrence.
3438
3439* AntLikeTasksAtTopLevelTest failed on cygwin.
3440
3441* I/O-intensive processes hung when executed via <exec spawn="true">.
3442 Bugzilla reports 23893/26852.
3443
3444* JDependTask did not close an output file. Bugzilla Report 28557.
3445
3446* Using <macrodef> could break XmlLogger. Bugzilla Report 28993.
3447
3448* <genkey> no longer requires keytool to be in your PATH. Bugzilla
3449 Report 29382.
3450
3451* <symlink> could create cyclic links. Bugzilla Report 25181.
3452
3453* <zip whenempty="skip"> didn't work in a common situation. Bugzilla
3454 Report 22865.
3455
3456* <scp> now properly handles remote files and directories with spaces
3457 in their names. Bugzilla Report 26097.
3458
3459* <scp> now has (local|remote)tofile attributes to rename files on the
3460 fly. Bugzilla Report 26758.
3461
3462* <telnet> and <rexec> didn't close the session. Bugzilla Report 25935.
3463
3464* <subant> and XmlLogger didn't play nicley together.
3465
3466Other changes:
3467--------------
3468* doc fix concerning the dependencies of the ftp task
3469 Bugzilla Report 29334.
3470
3471* <xmlvalidate> has now a property nested element,
3472 allowing to set string properties for the parser
3473 Bugzilla Report 23395.
3474
3475* Docs fixes for xmlvalidate.html, javadoc.html, starteam.
3476 Bugzilla Reports 27092, 27284, 27554.
3477
3478* <pathconvert> now accepts nested <mapper>s. Bugzilla Report 26364.
3479
3480* Shipped XML parser is now Xerces-J 2.6.2.
3481
3482* Added nested file element to filelist.
3483
3484* spelling fixes, occurred. Bugzilla Report 27282.
3485
3486* add uid and gid to tarfileset. Bugzilla Report 19120.
3487
3488* <scp> has a verbose attribute to get some feedback during the
3489 transfer and new [local|remote][File|Todir] alternatives to file and
3490 todir that explicitly state the direction of the transfer.
3491
3492* The OS/2 wrapper scripts have been adapted to use the new launcher.
3493 Bugzilla Report 28226.
3494
3495* <sshexec> now also captures stderr output. Bugzilla Report 28349.
3496
3497* <xslt> now supports a nested <mapper>. Bugzilla Report 11249.
3498
3499* <touch> has filelist support.
3500
3501* <nice> task lets you set the priority of the current thread; non-forking
3502 <java> code will inherit this priority in their main thread.
3503
3504* New attribute "negate" on <propertyset> to invert selection criteria.
3505
3506* Target now supports a Location member. Bugzilla Report 28599.
3507
3508* New "pattern" attribute for <date> selector.
3509
3510* <junit> has a new forkmode attribute that controls the number of
3511 Java VMs that get created when forking tests. This allows you to
3512 run all tests in a single forked JVM reducing the overhead of VM
3513 creation a lot. Bugzilla Report 24697.
3514
3515* <jar> can now optionally create an index for jars different than the
3516 one it currently builds as well. See the new <indexjars> element
3517 for details. Bugzilla Report 14255.
3518
3519* Permit building under JDK 1.5. Bugzilla Report 28996.
3520
3521* minor Javadoc changes. Bugzilla Report 28998.
3522
3523* Misc. corrections in SignJar.java. Bugzilla Report 28999.
3524
3525* Remove redundant <hr> from javah.html. Bugzilla Report 28995.
3526
3527* Ignore built distributions. Bugzilla Report 28997.
3528
3529* A new roundup attribute on <zip> and related task can be used to
3530 control whether the file modification times inside the archive will
3531 be rounded up or down (since zips only store modification times with
3532 a granularity of two seconds). The default remains to round up.
3533 Bugzilla Report 17934.
3534
3535* A binary option has been added to <concat>. Bugzilla Report 26312.
3536
3537* Added DynamicConfiguratorNS, an namespace aware version of
3538 DynamicConfigurator. Bugzilla Report 28436.
3539
3540* Add implicit nested element to <macrodef>. Bugzilla Report 25633.
3541
3542* Add deleteonexit attribute to <delete>.
3543
3544* Added Target.getIf/Unless(). Bugzilla Report 29320.
3545
3546* <fail> has a status attribute that can be used to pass an exit
3547 status back to the command line.
3548
3549* <fail> accepts a nested <condition>.
3550
3551* <loadproperties> supports loading from a resource.
3552 Bugzilla Report 28340.
3553
3554* Nested file mappers and a container mapper implementation have been
3555 introduced. Additionally, the <mapper> element now accepts "defined"
3556 nested FileNameMapper implementations directly, allowing a usage
3557 comparable to those of <condition>, <filter>, and <selector>.
3558
3559* New <redirector> type introduced to provide extreme I/O flexibility.
3560 Initial support for <exec>, <apply>, and <java> tasks.
3561
3562* <apply> has a new ignoremissing attribute (default true for BC)
3563 which will allow nonexistent files specified via <filelist>s to
3564 be passed to the executable. Bugzilla Report 29585.
3565
3566* <junitreport> now also works with Xalan XSLTC and/or JDK 1.5.
3567 Bugzilla Report 27541.
3568
3569* <jspc> doesn't work properly with Tomcat 5.x. We've implemented a
3570 work-around but don't intend to support future changes in Tomcat
3571 5.x. Please use the jspc task that ships with Tomcat instead of
3572 Ant's.
3573
3574Changes from Ant 1.6.0 to Ant 1.6.1
3575=============================================
3576
3577Changes that could break older environments:
3578--------------------------------------------
3579
3580* License is now Apache License 2.0
3581 see http://www.apache.org/licenses/ for more information
3582
3583Fixed bugs:
3584-----------
3585* Remove a recursive template call in the junit xsls that could trigger a stack
3586 overflow. It now uses Xalan extensions to call a Java class directly.
3587 Bugzilla Report 19301
3588
3589* Fix spurious infinite loop detection for filters (introduced in ant 1.6.0).
3590 Bugzilla Report 23154.
3591
3592* Fix handling of default ant namespace for nested elements.
3593
3594* Fix jboss element of ejb task (introduced in ant 1.6.0).
3595
3596* <whichresource> failed to load classes correctly.
3597
3598* Ant could fail to start with a NullPointerException if
3599 ANT_HOME/lib/ant-launcher.jar was part of the system CLASSPATH.
3600
3601* presetdef'ed types did not work with the ant-type attribute
3602
3603* fixed case handling of macrodef attributes and elements. Bugzilla
3604 Reports 25687 and 26225.
3605
3606* <java> ignored the append attribute, Bugzilla Report 26137.
3607
3608* The gcj compiler adapter for <javac> failed if the destination
3609 directory didn't exist. Bugzilla Report 25856.
3610
3611* Ant now fails with a more useful message if a new process will be
3612 forked in a directory and that directory doesn't exist.
3613
3614* <splash> used to break the build on non-GUI environments. Bugzilla
3615 report 11482.
3616
3617* Ant 1.6.0 cannot run build scripts in directories with non-ASCII names.
3618 Bugzilla Report 26642.
3619
3620Other changes:
3621--------------
3622* Shipped XML parser is now Xerces-J 2.6.1
3623
3624* Translate task logs a debug message specifying the number of files
3625 that it processed. Bugzilla Report 13938.
3626
3627* <fixcrlf> has a new attribute - fixlast. Bugzilla Report 23262.
3628
3629* <p4submit> has 2 new attributes, needsresolveproperty and changeproperty.
3630 Bugzilla Report 25711.
3631
3632* add description attributes to macrodef attributes and elements.
3633 Bugzilla Report 24711.
3634
3635* Extending ClearCase Tasks :
3636 - Added an extra option to 'failonerr' to each ClearCase task/command.
3637 - Extended the functionality of cccheckout. It can check (notco) to see if
3638 the desired element is already checked out to the current view. Thus it
3639 won't attempt to check it out again.
3640 - Added three new ClearCase commands: ccmkattr, ccmkdir, ccmkelem
3641 Bugzilla Report 26253.
3642
3643* added nested text support to <macrodef>
3644
3645* added initial support for Java 1.5. Java 1.5 is now correctly
3646 detected by Ant and treated just like Java 1.4. You can now specify
3647 source="1.5" in the <javac> task.
3648
3649* created new task <cvsversion>
3650
3651* added support for branch logging via the tag attribute in <cvschangelog>
3652 Bugzilla Report 13510.
3653
3654* added support the groovy language in the script and scriptdef tasks
3655
3656Changes from Ant 1.5.4 to Ant 1.6.0
3657===================================
3658
3659Changes that could break older environments:
3660--------------------------------------------
3661
3662* This version of Ant can not be built with JDK 1.1 and requires at
3663 least Java 1.2 at runtime as well. Compiling for a 1.1 target is
3664 still supported.
3665
3666* Targets cannot have the empty string as their name any longer.
3667
3668* ant.jar's manifest does no longer include a Class-Path entry, so it
3669 is no longer possible to run Ant via "java -jar ant.jar" without
3670 manually altering the CLASSPATH. Instead of that a file
3671 ant-bootstrap.jar is included in the etc directory of the binary
3672 distribution, copy this to the lib directory and use
3673 "java -jar ant-bootstrap.jar" instead if you want to run Ant without
3674 the wrapper script (not recommended).
3675
3676* The <script> task now requires Apache BSF instead of the older IBM
3677 version. See <http://jakarta.apache.org/bsf/>
3678
3679* <xmlproperty> will no longer fail if the file to be loaded doesn't exist.
3680
3681* XML namespaces are now enabled in the XML parser, meaning XML namespace
3682 declarations no longer cause errors. However task names containing colons
3683 will cause errors unless there is a corresponding namespace uri.
3684
3685* The <ftp> and <telnet> tasks now require Jakarta Commons Net instead
3686 of the older ORO Netcomponents version. See
3687 <http://jakarta.apache.org/commons/net/index.html>.
3688
3689* <input> will no longer prompt the user and wait for input if the
3690 addproperty attribute is set to a property that has already been
3691 defined in the project. If you rely on the task waiting for input,
3692 don't use the addproperty attribute.
3693
3694* The Class-Path attribute in manifests will no longer merge the
3695 entries of all manifests found, but will be treated like all other
3696 manifest attributes - the most recent attribute(s) will be used.
3697
3698* New Launch mechanism implemented. This moves some functionality from
3699 the batch files / shell scripts into Java. This removes environment
3700 limitations, for command issues, directory depth issues on Windows. Also
3701 allows a per-user library location to be used if the main Ant install
3702 is locked down.
3703
3704* The Entry nested element of PropertyFile will not any more have its value
3705 attribute (actually increment) overwritten with the new value of the entry
3706 after execution.
3707
3708* Output stored from a <java> or <exec> task is now exactly as generated. No
3709 conversion to platform end-of-line characters is performed.
3710
3711* <translate> will now preserve line endings.
3712
3713* <ftp> followsymlinks="false" in nested fileset definitions is explicitly
3714 required in order to exclude remote symbolic links (when doing a get, chmod,
3715 delete, rmdir).
3716
3717* The values of the Copy#fileCopyMap variable has changed from String to
3718 String[]. (In java 1.5 terms it was Hashtable<String, String> and
3719 is now Hashtable<String, String[]>). This will affect third party code
3720 that extend Copy and override Copy#doFileOperations.
3721
3722* <loadproperties> didn't expand properties while <property file="..."/>
3723 does, so they were not equivalent. This has been fixed, which means
3724 that propetries may get expanded twice if you use an
3725 <expandproperties> filterreader. Bugzilla Report 17782.
3726
3727* User defined tasks and typedefs are now handled internally in the
3728 same way as predefined tasks and typedefs. Also tasks and typedefs
3729 are resolved at a later stage. This causes some
3730 differences especially for user defined task containers.
3731
3732* <checksum> log message "Calculating checksum ..." has been degraded
3733 from INFO to VERBOSE.
3734
3735Fixed bugs:
3736-----------
3737* Filter readers were not handling line endings properly. Bugzilla
3738 Report 18476.
3739
3740* Filtersets were also not handling line endings properly.
3741
3742* Expand tasks did not behave as expected with PatternSets.
3743
3744* <property environment=... /> now works on OS/400.
3745
3746* <cab> could hang listcab on large <fileset>s.
3747
3748* The starteam stcheckout, stcheckin tasks now correctly compute
3749 status of files against whatever local tree they are run against
3750 and, optionally, will not process a file if it is current.
3751 Previously you had to process everything unless you ran against the
3752 default folder which wasn't the normal use-case for ant-starteam.
3753 The stlist task now similarly displays that status correctly making
3754 it a more generally useful tool.
3755
3756* entity includes would cause exceptions if path names included spaces.
3757
3758* addConfiguredXXX would not work for TaskAdapter wrapped tasks
3759
3760* Fix <ilasm> outputfile testing so that the output file does not need
3761 to exist beforehand.
3762
3763* Ant will now exit with a return code of 1 if it encounters problems
3764 with the command line arguments.
3765
3766* ClassLoader creation changes to use a factory method in Project. A new
3767 class AntClassLoader2 implemented for 1.2+ specific features including
3768 Package information and addition of classes specified in the Class-Path
3769 element of a Jar's manifest.
3770
3771* It is now possible in <exec> to resolve the executable to a project
3772 basedir or execution dir relative executable. The resolveExecutable
3773 must be used to pick up such executables.
3774
3775* splash screen wouldn't disappear when build was finished.
3776
3777* <exec> output and error streams can now be redirected independently
3778 to either a property or a file (or both)
3779
3780* TarEntry's File-arg constructor would fail with a
3781 StringIndexOutOfBoundsException on all OSes where os.name is shorter
3782 than seven characters. Bugzilla Report 18105.
3783
3784* <copy> and <move>'s failonerror didn't apply to filesets pointing to
3785 non-existant directories. Bugzilla Report 18414.
3786
3787* The <stripjavacomments> filter sometimes removed parts of string
3788 constants. Bugzilla Report 17441.
3789
3790* <antlr> will now recompile your grammar if the supergrammar has
3791 changed. Bugzilla Report 12691.
3792
3793* <property env> will now work on Unices with /bin/env instead of
3794 /usr/bin/env. Bugzilla Report 17642.
3795
3796* <jar index="on"> could include multiple index lists. Bugzilla 10262.
3797
3798* The index created by <jar> didn't conform to the spec as it didn't
3799 include the top-level entries. Bugzilla Report 16972.
3800
3801* <tar> and <zip> didn't honor the defaultexcludes attribute for the
3802 implicit fileset. Bugzilla Report 18637.
3803
3804* The <replacetokens> filter would throw an exception if the token's
3805 value was an empty string. Bugzilla Report 18625.
3806
3807* Perforce tasks relying on output from the server such as <p4change>
3808 and <p4label> were hanging. Bugzilla Reports 18129 and 18956.
3809
3810* Improve exception and logging behavior of Perforce tasks.
3811 Bugzilla report 18154.
3812
3813* build.sh install had a problem on cygwin (with REALANTHOME).
3814 Bugzilla Report 17257
3815
3816* <replaceregexp> didn't work for multi-byte encodings if byline was false.
3817 Bugzilla Report 19187.
3818
3819* <replaceregexp> was altering unnecessarily the timestamp of the directories
3820 containing the files to process
3821 Bugzilla Report 22541.
3822
3823* file names that include spaces need to be quoted inside the @argfile
3824 argument using forked <javac> and (all JDKS). Bugzilla Report 10499.
3825 NB : a first correction was only introducing quotes for JDK 1.4
3826 It has been changed to quote for all external compilers when paths
3827 contain spaces.
3828 Also the backslashes need to be converted to forward slashes
3829 Bugzilla Report 17683.
3830
3831* Setting filesonly to true in <zip> and related tasks would cause the
3832 archives to be always recreated. Bugzilla Report 19449.
3833
3834* file names that include spaces need to be quoted inside the @argfile
3835 argument using <javadoc> and JDK 1.4. Bugzilla Report 16871.
3836
3837* <junit> didn't work with custom formatters that were only available
3838 on the user specified classpath when a timeout occurred. Bugzilla
3839 Report 19953.
3840
3841* <different> selector : make ignoreFileTimes effectively default to true
3842 and fix a bug in the comparison of timestamps. Bugzilla Report 20205.
3843
3844* <different> selector can now be nested directly under a fileset
3845 Bugzilla Report 20220.
3846
3847* <cvstagdiff> had a problem with "dd-MM-yy hh:mm:ss" formats
3848 Bugzilla Report 15995.
3849
3850* <cvstagdiff> cvsroot and package attributes added to the root
3851 element tagdiff of the xml output
3852 Bugzilla Report 16081.
3853
3854* <cvstagdiff> had a problem with aliased modules and with requests for
3855 multiple modules. Bugzilla Reports 21373 and 22877.
3856
3857* <cvstagdiff> could not parse properly the revision number of new files with
3858 CVS 1.11.9 or higher. Bugzilla Report 24406.
3859
3860* <fixcrlf> make fixcrlf create its temporary files in the default directory
3861 of FileUtils#createTempFile instead of the destination dir of fixcrlf.
3862 Bugzilla Report 20870.
3863
3864* <ejbjar> implementation for Borland.
3865 Prevent the task from being blocked by error messages coming from java2iiop.
3866 Bugzilla Report 19385.
3867
3868* <unzip>'s and <untar>'s nested patternsets didn't work as documented
3869 when the pattern ended in a slash or backslash. Bugzilla Report 20969.
3870
3871* <fixcrlf> will now create the parent directories for the destination
3872 files if necessary. Bugzilla Report 20840.
3873
3874* <xmlproperty> now handles CDATA sections. BugZilla Report 17195
3875
3876* <translate> now translate tokens that are placed close together.
3877 Bugzilla Report 17297
3878
3879* Nested websphere element for ejbjar does not support spaces in file name.
3880 Bugzilla Report 21298
3881
3882* Don't multiply Class-Path attributes when updating jars. Bugzilla
3883 Report 21170.
3884
3885* Do not overwrite the value (increment) attribute of PropertyFile nested
3886 Entry element. Bugzilla Report 21505.
3887
3888* Prevent sysproperties with no key or no value from being added in <junit>.
3889 Bugzilla Report 21684.
3890
3891* Allow references to be properly inherited via antcall
3892 Bugzilla Report 21724.
3893
3894* ftp chmod failed when the remote system was UNIX and local system Windows
3895 Bugzilla Report 21865.
3896
3897* ftp put with chmod failed when the remote system was UNIX and local system
3898 Windows. Bugzilla Report 23143.
3899
3900* ftp did not set the ascii mode explicity, causing problems with ftp servers
3901 having binary as default
3902
3903* ftp was not able to download files when they were pointed to by symbolic
3904 links. Bugzilla Report 14063.
3905
3906* ftp is able to download also directories pointed to by symbolic links.
3907
3908* replace would change \r\n into \r\r\n under Windows.
3909
3910* junitreport with frames did not display a link for classes without a package
3911 or in the top package.
3912 Bugzilla Report 21915.
3913
3914* Project.toBoolean(String) now handles null as argument and does not throw a
3915 NullPointerException any more.
3916
3917* The socket condition will now close the socket created to test.
3918 Bugzilla Report 23040.
3919
3920* <junit includeantruntime="true" fork="true"> replaced the CLASSPATH instead
3921 of adding to it. Bugzilla Report 14971.
3922
3923* <splash> could fail on JVMs that use null to indicate the system classloader.
3924 Bugzilla Report 23320.
3925
3926* <xmlcatalog>s only worked when defined inside of tasks. Bugzilla
3927 Report 20965.
3928
3929* <csc> and siblings (<vbc> <jsharpc>) handle large filesets by
3930automatic use of response files. Bugzilla report #19630
3931
3932Other changes:
3933--------------
3934
3935* Shipped XML parser is now Xerces 2.6.0
3936
3937* All tasks can be used outside of <target>s. Note that some tasks
3938 will not work at all outside of targets as they would cause infinite
3939 loops (<antcall> as well as <ant> and <subant> if they invoke the
3940 current build file).
3941
3942* Six new Clearcase tasks added.
3943
3944* A new filter reader namely tokenfilter has been added. Bugzilla
3945 Report 18312.
3946
3947* A new attribute named skip is added to the TailFilter and
3948 HeadFilter filter readers.
3949
3950* The filesetmanifest attribute of <jar> has been reenabled.
3951
3952* The start and end tokens for <translate> may now be longer than a
3953 single character.
3954
3955* <setproxy> lets you set the username and password for proxies that
3956 want authentication
3957
3958* <loadproperties> has a new encoding attribute.
3959
3960* <echoproperties> can now create XML output.
3961
3962* <echoproperties> has a new srcfile attribute that can make it read
3963 properties files and output them instead of Ant's properties.
3964
3965* <filterset> will now resolve filters recursively.
3966
3967* <input> has a new attribute that allows you to specify a default value.
3968
3969* Added <image> task (requires JAI).
3970
3971* <image> task has now proportions attribute in the <scale/> nested element
3972 instead of keepproportions (bringing in more functionality)
3973
3974* New condition <isreference>
3975
3976* <ftp> now has a preservelastmodified attribute to preserve the
3977 timestamp of a downloaded file.
3978
3979* new rmdir action for <ftp> that removes directories from a fileset.
3980
3981* <ftp> has attributes timediffauto and timediffmillis to use together
3982 with the newer attribute to tell ant to take into account a time difference
3983 between client and remote side.
3984 Bugzilla Report 19358.
3985
3986* <ftp> has been optimized to go directly to the include patterns.
3987 This reduces scanning time under UNIX when followsymlinks="true"
3988 and casesensitive="true" (the default)
3989 Bugzilla Report 20103.
3990
3991* The SOS and VSS tasks will no longer unconditionally prepend a $ to
3992 vsspath or projectpath.
3993
3994* OS/400 now gets detected by the os condition.
3995
3996* <arg> has a new attribute pathref that can be used to reference
3997 previously defined paths.
3998
3999* <xmlproperty> has been improved, you can now expand ${properties},
4000 define ids or paths and use Ant's location magic for filename resolutions
4001 in the XML file.
4002
4003* <xmlcatalog> will now support external catalogs according to the
4004 OASIS "Open Catalog" standard - if resolver.jar (newer than version
4005 1.0) from Apache's xml-commons is in your CLASSPATH.
4006
4007* Starteam tasks now have support for revision labels and build labels.
4008 Checkouts now have the option of using repository timestamps, instead
4009 of current.
4010
4011* new task <symlink> that creates and maintains symbolic links.
4012
4013* new tasks <chown> and <chgrp> which are wrappers of the Unix commands.
4014
4015* new task <attrib> to change file attributes on Windows systems.
4016
4017* <style> has a new attribute reloadstylesheet to work around a
4018 bug in widespread Xalan versions.
4019
4020* <tarfileset> has a new dirmode attribute to specify the permissions
4021 for directories.
4022
4023* <fixcrlf>'s eol attribute now also understands "mac", "unix" and "dos".
4024
4025* <classfileset> now picks up dependencies of the form MyClass.class. This
4026 works for the code generated by the Sun java compiler. It may not work for
4027 all compilers.
4028
4029* a new attribute "globalopts" can be added to all Perforce tasks.
4030 You can put in it all the strings described by p4 help usage. Refer to
4031 the docs for more information.
4032
4033* new Perforce tasks <p4integrate> , <p4resolve>, and <p4labelsync>
4034
4035* <p4submit> will change the property p4.change if the Perforce server
4036 renumbers the change list.
4037 It will set the property p4.needsresolve if the submit fails,
4038 and the message says that file(s) need to be resolved.
4039
4040* <replaceregexp> now has an optional encoding attribute to support
4041 replacing in files that are in a different encoding than the
4042 platform's default.
4043
4044* The <exec> task may now have its input redirected from either a file
4045 or a string from the build file. The error output can be separated
4046 to a different file when outut is redirected. standard error may be
4047 logged to the Ant log when redirecting output to a file
4048
4049* The <java> task also supports the input redirection and separate
4050 error streams introduced to the <exec> task. In addition, it is now
4051 possible to save the output into a property for use within the build
4052 file as was possible with <exec> in Ant 1.5
4053
4054* The <javadoc> task <tag> subelement has been enhanced to allow files
4055 with tag mappings to be used.
4056
4057* New tasks: <scp> supports file transfers, <sshexec> executes a
4058 command over SSH. They require jsch, a BSD licensed SSH library that
4059 can be found at http://www.jcraft.com/jsch/index.html
4060
4061* New filterreader <escapeunicode/>.
4062
4063* Support for HP's NonStop Kernel (Tandem) OS has been added.
4064
4065* <cab>'s basedir attribute is now optional if you specify nested
4066 filesets. Bugzilla Report 18046.
4067
4068* New task <sync> that synchronizes two directory trees.
4069
4070* <apply> has new forwardslash attribute that can force filenames to
4071 use forward slashes (/) as file separators even on platforms with a
4072 different separator. This is useful if you want to run certain
4073 ported Unix tools.
4074
4075* Copy has a new outputencoding attribute that can be used to change
4076 the encoding while copying files. Bugzilla Report 18217.
4077
4078* The xml formatter for JUnit will now honor test case names set with
4079 setName. Bugzilla Report 17040.
4080
4081* JUnit now has an attribute reloading, which, when set to false,
4082 makes the task reuse the same class loader for a series of tests.
4083
4084* <concat> now supports filtering and can check timestamps before
4085 overriding a file. Bugzilla Report 18166.
4086
4087* <junit> has a new attribute tempdir that controls the placement of
4088 temporary files. Bugzilla Report 15454.
4089
4090* <jdepend> now supports a new nested element <classespath> which is
4091 the same as <sourcespath> but point to compiled classes (the
4092 prefered mode of operation for JDepend > 2.5). Additionally, nested
4093 <exclude> elements can be used to exclude certain packages from
4094 being parsed. Bugzilla Report 17134.
4095
4096* The JProbe tasks now also work with JProbe 4.x. Bugzilla Report 14849.
4097
4098* <javacc> and <jjtree> will now autodetect JavaCC 3.x and can use it.
4099
4100* <sql> has a new attribute to control escape processing.
4101
4102* <sql> is able to display properly several resultsets if you are
4103 running a compound sql statement. Bugzilla Report 21594.
4104
4105* A new <containsregexp> selector has been added, that selects files
4106 if their content matches a certain regular expression.
4107
4108* <antlr>'s debug attribute has been enabled. Bugzilla Report 19051.
4109
4110* <mail> has a new attribute charset. Bugzilla Report 15434.
4111
4112* <mail> has new attributes user and password for SMTP auth.
4113 maillogger can also use this.
4114 The implementation only works with JavaMail (encoding="MIME").
4115 Implementation with plain mail remains to do.
4116 Bugzilla Report 5969.
4117
4118* <mail> and mailloger support SMTP over TLS/SSL
4119 Bugzilla Report 19180.
4120
4121* <mail> the attributes from, replyto ,tolist, cclist, bcclist
4122 can now contain email addresses of the form name <[email protected]>
4123 or (name) [email protected]
4124 Bugzilla Report 22474.
4125
4126* <mail> (version PlainMail)
4127 prevent blank headers from being sent,
4128 make the order of the headers of plain mail messages predictable
4129 Bugzilla Report 22088.
4130
4131* <zipfileset> can now be defined in the main body of a project
4132 and referred to with refid="xyz". Bugzilla Report 17007.
4133
4134* A wrapper script for OS/2 has been added.
4135
4136* <unzip> will now detect and successfully extract self-extracting
4137 archives. Bugzilla Report 16213.
4138
4139* <stcheckout> has a new attribute "converteol" that can be used to
4140 control the automatic line-end conversion performed on ASCII files.
4141 Bugzilla Report 18884.
4142
4143* Users can now modify the list of default excludes using the new
4144 defaultexcludes task. Bugzilla Report 12700.
4145
4146* There is a new data type <propertyset> that can be used to collect
4147 properties. It is supported by <ant>, <antcall>, <subant>, <java>,
4148 <echoproperties> and <junit>.
4149
4150* <concat> can now control the encoding of the output as well and optionally
4151 add new-line characters at the end of files that get concatenated but
4152 don't end in newlines. Bugzilla Report 12511.
4153
4154* <rpm> will detect the rpmbuild executable of RedHat 8.0 and newer
4155 and use that if it is on your PATH. Bugzilla Report 14650.
4156
4157* A new task <rexec> has been added that requires commons-net to work.
4158 Bugzilla Report 19541.
4159
4160* <javadoc> now supports a nested <arg> element in addition to the
4161 additionalparams attribute.
4162
4163* You can now determine the order of standard tags in <javadoc> via
4164 <tag> elements - you must not use the description attribute for them.
4165 Bugzilla Report 18912.
4166
4167* <javadoc> now supports the -noqualifier switch. Bugzilla Report 19288.
4168
4169* <javac>'s executable attribute can now also be used to specify the
4170 executable for jikes, jvc, sj or gcj. Bugzilla Report 13814.
4171
4172* <javac> has a new attribute tempdir that can control the placement
4173 of temporary files. Bugzilla Report 19765.
4174
4175* A new magic property build.compiler.jvc.extensions has been added
4176 that can be used to turn of Microsoft extensions while using the jvc
4177 compiler. Bugzilla Report 19826.
4178
4179* You can now limit the parallelism of <apply> and <chmod> by using the new
4180 maxparallel attribute.
4181
4182* With the new addsourcefile attribute, you can make <apply> ommit the
4183 source file names from the command line. Bugzilla Report 13654.
4184
4185* <apply> and <chmod> now support nested <filelist>s as well as <dirset>s.
4186 Bugzilla Reports 15929 and 20687.
4187
4188* <apply> and <chmod> will display a summary if you set the new
4189 verbose attribute to true. Bugzilla Report 19883.
4190
4191* <copy>/<move>'s failonerror attribute can now also be used to
4192 continue the build if an I/O error caused a problem. Bugzilla
4193 Report 12999.
4194
4195* new selector <type/> allowing to select only files or only directories.
4196 Bugzilla Report 20222.
4197
4198* <java> and <junit> now support a nested <bootclasspath> element that
4199 will be ignored if not forking a new VM.
4200
4201* <junit>'s nested <formatter> elements now support if/unless clauses.
4202
4203* <ejbjar>
4204 cmpversion attribute added
4205 jboss element will look for jbosscmp-jdbc.xml descriptor
4206 if ejbjar has cmpversion="2.0" set
4207 Bugzilla Reports 14707 and 14709.
4208
4209* <pvcs> config attribute added to set the location of a specific PVCS
4210 .cfg file
4211 Bugzilla Report 9752
4212
4213* <mapper> has an "unpackage" mapper
4214 Bugzilla Report 18908
4215
4216* Added <scriptdef> task allowing tasks to be defined using any BSF-supported
4217 scripting language.
4218
4219* <touch>'s datetime attribute can now accept time with a granularity
4220 of seconds as well. Bugzilla Report 21014.
4221
4222* <checksum> has two new properties: totalproperty and todir.
4223
4224* FileUtils#createTempFile will now create temporary files in the
4225 directory pointed to by the property java.io.tmpdir
4226
4227* <unzip> and friends now supports an optional encoding attribute to
4228 enable it to expand archives created with filenames using an encoding
4229 other than UTF8. Bugzilla Report 10504.
4230
4231* <patch> has a new attribute destfile that can be used to create a new
4232 file instead of patching files in place.
4233
4234* OpenVMS is detected as a valid OS family.
4235
4236* DirectoryScanner has been optimized for cases where include patterns do not
4237 start with wildcards. Bugzilla Report 20103.
4238
4239* DirectoryScanner begins to be optimized not to scan excluded directories.
4240 Bugzilla Report 21941.
4241
4242* Added keep-going feature. Bugzilla Report 21144
4243
4244* The archives generated by <zip> and friends will now contain CRC and
4245 size information in the "local file header", thereby providing this
4246 information to applications that read the archives using
4247 java.util.ZipInputStream. Bugzilla Report 19195.
4248
4249* <copy> and <move> can now handle mappers that return multiple
4250 mappings per source path. This behaviour is enabled by using
4251 an enablemultiplemapping attribute. Bugzilla Report 21320.
4252
4253* <exec> will now work on OpenVMS (please read the notes in
4254 <exec>'s manual page). Bugzilla Report 21877.
4255
4256* <exec> will now have a new attribute spawn (default false).
4257 If set to true, the process will be spawned. Bugzilla Report 5907.
4258
4259* <java> will now have a new attribute spawn (default false).
4260 If set to true, the process will be spawned. Bugzilla Report 5907.
4261
4262* <parallel> now supports a timeout which can be used to recover
4263 from deadlocks, etc in the parallel threads. <parallel> also
4264 now supports a <daemons> nested element. This can be used to
4265 run tasks in daemon threads which the parallel task will not
4266 wait for before completing. A new attribute failonany will cause
4267 <parallel> to throw an exception if any thread fails without
4268 waiting for all other threads to complete.
4269
4270* <zip> and friends will consume far less memory than they used to
4271 when run with compress="false". Bugzilla Report 21899.
4272
4273* <if/> and <unless/> attributes added to <param/> element of <style>
4274 Bugzilla Report 22044
4275
4276* <zip> and friends have a new attribute "keepcompression" that can be
4277 used to incrementally build an archive mixing compressed and uncompressed
4278 entries.
4279
4280* <junit>'s XML formatter adds a new classname attribute to the <testcase>
4281 elements.
4282
4283* new <permissions> type add permission handling to the code
4284 this type can be nested in the <java> and <junit> tasks.
4285 Bugzilla Report 22533.
4286
4287* additional shortcuts for ant options (-d --> -debug, -e --> -emacs,
4288 -h --> -help, -p --> -projecthelp, -s --> -find).
4289
4290* new selector <modified>. "cache" was renamed to "modified".
4291 Bugzilla Report 20474.
4292
4293* <stcheckout> and <stlist> have a new asofdate attribute that can be
4294 used to checkout/list files based on a date instead of a label.
4295 Bugzilla Report 20578.
4296
4297* New filter <concatfilter>. Adds the content of file at the beginning
4298 or end of a file. Discussion started at
4299 http://marc.theaimsgroup.com/?l=ant-user&m=106366791228585&w=2
4300
4301* New task <import>
4302
4303* New task <macrodef>
4304
4305* New task <presetdef>
4306
4307* Ant libraries that can make use of namespaces to avoid name
4308 clashes of custom tasks
4309
4310* <java> and <junit> now support <assertions>, which let you enable
4311 and disable Java1.4 assertions on a package or class basis. These
4312 only work when fork=true, currently.
4313
4314* .NET tasks expanded with VB support <vbc> and J#, via <jsharp>,
4315 <importtypelib> and <ilasm>. <csc> supports nested <src> types,
4316 <defines> for (potentially conditional) definitions, <reference>
4317 filesets for references. The executable attribute lets you switch to
4318 mono or other implementations -<csc> has been tested with Mono on
4319 Linux and OSX.
4320
4321
4322Changes from Ant 1.5.3 to Ant 1.5.4
4323===================================
4324
4325Changes that could break older environments:
4326--------------------------------------------
4327
4328* If the Visual Age tasks used to work for you, they may stop doing so
4329 now - and we'd like to know about it. The current set of tasks is
4330 supposed to work with any version of VAJ starting with 3.0.
4331
4332Fixed bugs:
4333-----------
4334
4335* The Visual Age for Java tasks didn't work (at least for versions 3.0
4336 and higher). Bugzilla Report 10016.
4337
4338* URL-encoding in <vaj*port> didn't work properly.
4339
4340* VAJRemoteUtil called getAbsolutePath instead of getPath
4341 causing problems when using a Windows VAJ server from a UNIX server.
4342 Bugzilla Report 20457.
4343
4344* VAJImport task failed with NullPointerException when using DirectoryScanner.
4345 Bugzilla Report 22080.
4346
4347Other changes:
4348--------------
4349
4350* Shipped XML parser is now Xerces 2.5.0
4351
4352* <javah> will invoke oldjavah on JDK 1.4.2. Bugzilla Report 18667.
4353
4354* The VAJ tasks now support a haltonfailure attribute to conditionally
4355 keep building even if they fail.
4356
4357* It is now possible to use the latest (versioned or unversioned) edition
4358 in <vajload> by using special wildcard characters. Also fixes
4359 Bugzilla Report 2236.
4360
4361Changes from Ant 1.5.2 to Ant 1.5.3
4362===================================
4363
4364Changes that could break older environments:
4365--------------------------------------------
4366
4367* The <zip> task and friends have again changed a method signature
4368 (sorry, was necessary to fix bug 17780). The return type of
4369 getResourcesToAdd has changed.
4370
4371Fixed bugs:
4372-----------
4373
4374* <zipfileset>'s filemode would get ignored and the dirmode was used
4375 for the included files as well. As a side effect, WinZIP was unable
4376 to extract or display the files, so they seemed to be missing from
4377 the archive. Bugzilla Report 17648.
4378
4379* <ftp> could use the wrong path separator when trying to change the
4380 remote working directory. Bugzilla Report 17735.
4381
4382* <jar update="true"> would loose all original files if you didn't
4383 specify any nested <(zip)fileset>s and the manifest had changed.
4384 Bugzilla Report 17780.
4385
4386* If you used a value starting with \ on Windows for the appxml
4387 attribute of <ear> or the webxml attribute of <war>, it would be
4388 ignored. Bugzilla Report 17871.
4389
4390* Ant will no longer implicitly add Sun's rt.jar in <javac> when you
4391 use jvc and don't specify a bootclasspath. Bugzilla Report 18055.
4392
4393* The prefix attribute of <zipfileset> would not generate directory
4394 entries for the prefix itself. Bugzilla Report 18403.
4395
4396* starteam checkout can now handle deleted labels. Bugzilla Report 17646.
4397
4398* The Unix wrapper script failed if you invoked it as a relative
4399 symlink and ANT_HOME has not been set. Bugzilla Report 17721.
4400
4401Other Changes:
4402--------------
4403* Added ability to specify manifest encoding for the <jar> and
4404 <manifest> tasks
4405
4406Changes from Ant 1.5.1 to Ant 1.5.2
4407=============================================
4408
4409Changes that could break older environments:
4410--------------------------------------------
4411* ANT_OPTS environment variable is now applied at the start of the
4412 Java command line, allowing position specific parameters of some
4413 JVMs, such as -classic to be specified.
4414
4415* ZipScanner#getIncludedFiles will now return the names of the ZipEntries
4416 that have been matched instead of the name of the archive.
4417
4418* The <zip> task and friends have been heavily modified, almost every
4419 method signature of the Zip class has changed. If you have subclassed
4420 Zip (or one of its subclasses), your class will most likely not
4421 compile against the current code base. If it still compiles, it will
4422 probably not work as in Ant 1.5.1.
4423
4424Fixed bugs:
4425-----------
4426* <translate> was not ignoring comment lines.
4427
4428* <manifest> wouldn't update an existing manifest if only an attribute
4429 of an existing section changed.
4430
4431* ant.bat now supports the ANT_ARGS and JAVACMD environment variables
4432 again (like Ant 1.5 did).
4433
4434* The "plain" <junit> <formatter> could throw a NullPointerException
4435 if an error occurred in setUp.
4436
4437* <junit> will now produce output when a test times out as well.
4438
4439* <replace> would count some internal character replacements when
4440 reporting the number of replaced tokens.
4441
4442* <concat> would cause an exception if a <filelist> pointed to files
4443 that do not exist.
4444
4445* <javadoc> will now pass -source to custom doclets as well.
4446
4447* <cvstagdiff> would throw a NullPointException if there had been no
4448 differences.
4449
4450* <cvschangelog> could miss today's changes.
4451
4452* <concat> could append newline characters between concatenated files.
4453
4454* <xmlvalidate> ignored the specified encoding of the files to
4455 validate.
4456
4457* the errorsbeginat attribute of the <http> condition didn't work.
4458
4459* Ant will try to force loading of certain packages like com.sun.*
4460 from the system classloader. The packages are determined by the
4461 version of the JVM running Ant.
4462
4463* Ant didn't find the runtime libraries on IBM's JDK 1.4 for Linux.
4464
4465* random component of temporary files is now always a positive integer.
4466
4467* Ant could incorrectly try to use the 1.4 regexp implementation even
4468 if it isn't available if you run the JVM with -Xverify:none.
4469
4470* Ant would die with an exception if you used nested <reference>
4471 elements in Ant and the refid attribute didn't point to an existing
4472 project reference.
4473
4474* The <get> task can now be compiled (and Ant thus bootstrapped) using
4475 Kaffee.
4476
4477* build.sysclasspath will now be honored by more tasks.
4478
4479* The signjar keystore attribute has been reverted to a String allowing
4480 it to once again accept URLs. This should not affect current File based usage
4481 unless you are extending the Signjar task.
4482
4483* <jar update="true"> would remove the original manifest.
4484
4485* fix up folder creation in PVCS task
4486
4487* <tar>'s up-to-date check didn't work for nested <(tar)fileset>s.
4488
4489* Corrected a problem in XMLLogger where it would not associated
4490 messages with a taskdef'd task
4491
4492* <uptodate> now works when using attributes (i.e. not filesets) and pointing
4493 to the same file
4494
4495* Java task (and output system) now stores output which doos not end
4496 with a line feed.
4497
4498* splash screen wouldn't disappear when build was finished.
4499
4500* <exec> now supports OS/2.
4501
4502* <zip> and friends would only update/recreate existing archives if
4503 the files to add/update have been newer than the archive.
4504
4505* <javadoc>'s <link> element could fail for offline="true" on some JDKs.
4506
4507Other changes:
4508--------------
4509
4510* MailLogger now sets the Date header correctly.
4511
4512* Shipped XML parser is now Xerces 2.3.0
4513
4514* signjar now accepts a maxmemory attribute to allow the memory allocated to the
4515 jarsigner tool to be specified. The jarsigner from the JDK's JAVA_HOME bin
4516 dir is now used rather than the first jarsigner on the path.
4517
4518* **/.DS_Store has been added to the list of default pattern excludes.
4519
4520* The Created-By header in the default manifest now contains the JVM
4521 vendor and version according to the jar specification. A new header,
4522 Ant-Version provides the Ant version used to create the jar.
4523
4524* <zip> can now store Unix permissions in a way that can be
4525 reconstructed by Info-Zip's unzip command.
4526
4527Changes from Ant 1.5.1Beta1 to 1.5.1
4528====================================
4529
4530Fixed bugs:
4531-----------
4532
4533* <tstamp>'s prefix attribute failed to apply to nested <format> elements.
4534
4535* <junitreport> created an empty junit-noframes.html if no format had
4536 been specified.
4537
4538* <basename> would remove more than it should if the file name
4539 contained more than one dot.
4540
4541* <filterset>s nested into <filterset>s didn't work.
4542
4543Other changes:
4544--------------
4545
4546* Shipped XML parser is now Xerces 2.2.0
4547
4548* Filesets now support a 'file' attribute, allowing a single-file
4549 fileset to be constructed without having to specify its parent
4550 directory separately.
4551
4552* <junit> will now return the result of a call to getName instead of
4553 "unknown" for Test implementations that don't extend TestCase but have
4554 a public String getName() method.
4555
4556Changes from Ant 1.5 to 1.5.1Beta1
4557==================================
4558
4559Fixed bugs:
4560-----------
4561* Date/time in CvsChangeLog was in local timezone and 12 hour format leading
4562 to a problem when sorting by time. It is now UTC (GMT) and in 24-hour
4563 format as per cvs 'specifications'.
4564
4565* CvsTagDiff now supports ampersand modules or modules that have a different
4566 root directory than their name.
4567
4568* EjbJar threw NPEs for the Websphere element. The property 'websphere.home'
4569 was not documented.
4570
4571* Mail example in the documentation was not correct.
4572
4573* Checksum was broken in the following scenario:
4574 (using verifyproperty OR in a condition) AND using filesets
4575 with multiple files.
4576
4577* The ExpandProperties filter threw NPEs when defined using
4578 the <filterreader> format.
4579
4580* The sh wrapper script didn't work under Cygwin if ANT_HOME wasn't
4581 set with a Unix style filename.
4582
4583* The sh wrapper script could fail if you started Ant from a directory
4584 with whitespace in its name.
4585
4586* ant -diagnostics was not working properly when the task dependency
4587 was missing and was just printing the missing dependency.
4588
4589* If a task got redefined via <taskdef>, it lost its child elements.
4590
4591* <property>'s classpathref attribute was broken.
4592
4593* <arg line="''" /> would result in no command line argument, will now
4594 be a single empty argument. Use <arg value="''"/> if you need the
4595 quotes literally.
4596
4597* <replaceregexp> could append a newline character at the end of the
4598 file.
4599
4600Other changes:
4601--------------
4602
4603* Appendix E of Java Development with Ant (Loughran/Hatcher) was
4604 contributed to the docs.
4605
4606* <available> will only print deprecration warnings if it is actually
4607 used to change the value of a property.
4608
4609Changes from Ant 1.5beta3 to Ant 1.5
4610====================================
4611
4612Changes that could break older environments:
4613--------------------------------------------
4614
4615* The filesetmanifest attribute added to <jar> after the 1.4.1
4616 release has been removed for now. This change may affect only
4617 the 1.5Beta/1.6Alpha users. An attempt will be made to add this
4618 feature back into Ant 1.6.
4619
4620Fixed bugs:
4621-----------
4622
4623* <zip> and friends would always update existing archive if you set
4624 the update attribute to true.
4625
4626* To support backward compatibility with older versions, <pathconvert>
4627 will once again set the property, even if the result is the empty
4628 string, unless the new 'setonempty' attribute is set to false|no|off
4629 (default is "true").
4630
4631* The manifest task would crash XmlLogger
4632
4633Other changes:
4634--------------
4635
4636* added **/.svn and **/.svn/** to the default excludes
4637
4638Changes from Ant 1.5beta2 to Ant 1.5beta3
4639=========================================
4640
4641Changes that could break older environments:
4642--------------------------------------------
4643
4644* <pvcs> default filenameformat has been different from Ant 1.4.1.
4645 Now it is different from 1.5beta1 and 1.5beta2.
4646
4647* <pathconvert> won't set the property if the result is the empty string.
4648
4649Fixed bugs:
4650-----------
4651
4652* <available> could fail to find files or directories that happen to
4653 start with the name of the project's basedir but are not children of
4654 the basedir.
4655
4656* Nested <property>'s inside <ant> can now be overriden by subsequent
4657 <ant> and <antcall> tasks.
4658
4659* <xslt>'s outputtype attribute wouldn't do anything.
4660
4661* <linecontains> filterreader could swallow lines.
4662
4663* <sequential> used to configure the tasks (set their attributes)
4664 before the first task has been executed. This means that properties
4665 that have been set by nested task seemed to be unset for the other
4666 tasks in the same <sequential> element.
4667
4668* <javac>'s sourcepath setting has been ignored by some compiler
4669 implementations.
4670
4671* <javadoc>'s packagelist attribute didn't work.
4672
4673* the plain mailer would always use port 25 in <mail>.
4674
4675* Ant's default logger could swallow empty lines.
4676
4677* ejbjar's iPlanet nested element now can process multiple descriptors.
4678
4679* IPlanetEjbc was looking in the wrong place for four iiop files.
4680
4681* <javac> would pass the -source switch to JDK 1.3's javac, even
4682 though it doesn't support it.
4683
4684Other changes:
4685--------------
4686
4687* <checksum> now uses a buffer (of configurable size).
4688
4689* The "Trying to override task definition" warning has been degraded
4690 to verbose level if the two task definitions only differ in the class
4691 loader instance that has loaded the definition.
4692
4693* Add a jvmargs to the ejbjar's weblogic element to allow additional
4694 arguments to be provided to the VM runnign ejbc. Document the
4695 jvmdebuglevel attribute which can be used to avoid warnings about
4696 interface classess being found on the classpath. Document the new
4697 <sysproperty> element which allows JVM properties to be defined.
4698 Added an outputdir attribute to allow the destination to be a
4699 directory into which the exploded jar is written.
4700
4701* ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
4702
4703Changes from Ant 1.5beta1 to Ant 1.5beta2
4704=========================================
4705
4706Changes that could break older environments:
4707--------------------------------------------
4708
4709* Properties will now be expanded in mail message bodies. This means
4710 that one $ sign will be stripped if your mail message contains the text $$.
4711
4712* org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
4713
4714* Available#setFile now again uses a File argument as it did in 1.4,
4715 this may break environments that have been adapted to the String
4716 argument version present in 1.5beta1.
4717
4718Fixed bugs:
4719-----------
4720* When <move> attempts a rename, it deletes the destination file, if it
4721 exists, before renaming the source file. However, <move> was not
4722 checking if the destination file was actually a directory before
4723 trying to delete it.
4724
4725* Make CVS Tasks to work under Cygwin.
4726
4727* Fix LineContains to handle huge files elegantly without causing
4728 Stack Overflows.
4729
4730* if you ask for the "classic" compiler on Java1.4, you get upgraded to
4731 "modern" because there is no classic compiler any more.
4732
4733* the <http> condition was viewing 404 'not found' exceptions as success. Now
4734 it defaults to viewing any response >=400 as an error, and has an
4735 errorsBeginAt attribute you can use if you want a higher or lower value.
4736
4737* <get> throws a build exception on an http authorization error, unless you
4738 have set ignoreerrors to true.
4739
4740* <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
4741 case, though the old spelling is retained for anyone who used it.
4742
4743* Merging of Manifests in jar now works as documented.
4744
4745* paths that have been separated by colons would be incorrectly parsed
4746 on NetWare.
4747
4748* runant.pl now supports NetWare.
4749
4750* <tempfile> and <setproxy> tasks were in beta1, but not defined by
4751 default; They now are. <tempfile> fills a property with the name of a
4752 temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
4753 settings.
4754
4755* <available classname="foo" ignoresystemclasses="true"> failed for
4756 JDK 1.1 and 1.2, even if the class could be found on the
4757 user-specified classpath.
4758
4759* <property environment=... /> now works on z/OS.
4760
4761* forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
4762 use a temporary file to hold the names of the files to compile under
4763 some conditons, but 1.1 doesn't support this feature. Ant will no
4764 longer try this, but you may run into problems with the length of the
4765 command line now.
4766
4767* the refid attribute for <property>s nested into <ant> or <param>s
4768 nested into <antcall> didn't work.
4769
4770* <replaceregexp> didn't work for nested <fileset>s.
4771
4772* <javadoc> dropped sourcepath entries if no "interesting" .java
4773 source files could be found below them. This has been backwards
4774 incompatible and caused problems with custom doclets like xdoclet.
4775
4776* Using the doclet, docletpath or docletpathref attributes of
4777 <javadoc> may have caused NullPointerExceptions.
4778
4779* nested <filesets> of <javadoc> would include too much.
4780
4781* <dependset> will no longer choke on <targetfileset>s that point to
4782 non-existing directories.
4783
4784* <patch> didn't work at all.
4785
4786* <replace> and <replaceregexp> now fail if the file they are working
4787 on is locked.
4788
4789* <javadoc> would pick up the wrong executable in the combination JDK
4790 1.2 and AIX.
4791
4792Other changes:
4793--------------
4794
4795* z/OS now gets detected by the os condition.
4796
4797* <fileset> and <dirset> now have an optional followsymlink attribute
4798 that can prevent Ant from following symbolic links on some platforms.
4799
4800* BeanShell is now supported in the <script> task.
4801
4802* <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
4803 based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
4804 this ejbc class has been deprecated. To avoid the deprecation warning use
4805 ejbcclass="weblogic.ejbc".
4806
4807* <ejbjar> will add a manifest to the generated jar based on the naming
4808 convention in use. This overrides the manifest specified in the
4809 <ejbjar> attribute
4810
4811
4812Changes from Ant 1.4.1 to 1.5beta1
4813==================================
4814
4815Changes that could break older environments:
4816--------------------------------------------
4817
4818* Important: Single $ signs are no longer silently stripped!
4819 Before you panic that we have broken all your build files, we have kept
4820 the old "$$" -> "$" behaviour. So only build files which accidentally had
4821 a $ sign in a string that was being silently stripped may break.
4822 We added this fix to stop newbie confusion; if you want to write a
4823 build file which works on ant versions 1.4.1 or earlier, stay with
4824 the double $$ sign rule.
4825
4826* Project.getBuildListeners now returns a clone of the listener
4827 list. Changes to the returned list will not affect the listeners
4828 currently attached to the Project. It also means that it is safe to
4829 iterate over the returned list if listeners are added or removed
4830 during the traversal.
4831
4832* <pvcs> default filenameformat has been different from Ant 1.4.1.
4833
4834* Some messages that are printed during startup will not be
4835 written to the logfile specified via -logfile as they might destroy
4836 the format of the file for special BuildLoggers (like XmlLogger).
4837
4838* The filesetmanifest attribute added to <jar> after the 1.4.1
4839 release has been removed for now. This change may affect only
4840 the 1.5Beta/1.6Alpha users. An attempt will be made to add this
4841 feature back into Ant 1.6.
4842* Shipped XML parser is now Xerces 2.0.1 along with the XML Parser APIs.
4843 XML Parser APIs is a separate jar that contains the necessary
4844 JAXP/DOM/SAX classes.
4845
4846* <telnet> was fixed to expand properties inside nested <read> and
4847 <write> elements; before this only happened when you assigned the text
4848 to the string attribute. If you had $ signs in the string, they may
4849 need escaping.
4850
4851* the RegexpMatcher interface has been extended to support case
4852 insensitive matches and other options - custom implementations of
4853 this interface won't work any longer. We recommend to use the new
4854 Regexp interface that also supports substitution instead of the
4855 RegexpMatcher interface in the future.
4856
4857* <gzip> will throw an exception if your src attribute points to a directory.
4858
4859* Unjar, Unzip and Unwar will throw an exception if the Src attribute
4860 represents a directory. Support for nested filesets is provided
4861 instead.
4862
4863* It is no longer possible to overwrite a property using tasks like
4864 <condition>, <exec>, <pathconvert>, or <tstamp>. In some exceptional
4865 cases it will generate a warning if you attempt to overwrite an
4866 existing property.
4867
4868* Taskwriters please note: Whenever tasks had any overloaded set* methods,
4869 Ant's introspection mechanism would select the last overloaded method
4870 provided to it by the Java Runtime. A modification has now been made such
4871 that when the Java Runtime provides a method with a String as its argument,
4872 a check is made to see if there is another overloaded method that takes in
4873 some other type of argument. If there is one such method, then the method
4874 that takes in String as an argument is not selected by the Introspector.
4875
4876* The pattern definition **/._* has been included into the Default
4877 Excludes list.
4878
4879* <propertyfile>'s <entry> element was modified to remove "never" as a value
4880 as its behavior was undocumented and flakey.
4881
4882* The -projecthelp flag now only prints out targets that include the
4883 'description' attribute, unless the -verbose or -debug flag is included
4884 on the Ant command line.
4885
4886* Ant's testcases now require JUnit 3.7 or above, as they now use the new
4887 assertTrue method instead of assert.
4888
4889* If the 'output' attribute of <ant> is set to a simple filename or a
4890 relative path, the file is created relative to ${basedir}, not ${user.dir}.
4891
4892* The default value for build.compiler is now javac1.x with x
4893 depending on the JDK that is running Ant instead of classic/modern.
4894
4895Fixed bugs:
4896-----------
4897
4898* <available> could fail to find files or directories that happen to
4899 start with the name of the project's basedir but are not children of
4900 the basedir.
4901
4902* Nested <property>'s inside <ant> can now be overriden by subsequent
4903 <ant> and <antcall> tasks.
4904
4905* <xslt>'s outputtype attribute wouldn't do anything.
4906
4907* <linecontains> filterreader could swallow lines.
4908
4909* <sequential> used to configure the tasks (set their attributes)
4910 before the first task has been executed. This means that properties
4911 that have been set by nested task seemed to be unset for the other
4912 tasks in the same <sequential> element.
4913
4914* <javac>'s sourcepath setting has been ignored by some compiler
4915 implementations.
4916
4917* <javadoc>'s packagelist attribute didn't work.
4918
4919* the plain mailer would always use port 25 in <mail>.
4920
4921* Ant's default logger could swallow empty lines.
4922
4923* ejbjar's iPlanet nested element now can process multiple descriptors.
4924
4925* IPlanetEjbc was looking in the wrong place for four iiop files.
4926
4927* <javac> would pass the -source switch to JDK 1.3's javac, even
4928 though it doesn't support it.
4929
4930* <zip> and friends would always update existing archive if you set
4931 the update attribute to true.
4932
4933* To support backward compatibility with older versions, <pathconvert>
4934 will once again set the property, even if the result is the empty
4935 string, unless the new 'setonempty' attribute is set to false|no|off
4936 (default is "true").
4937
4938* The manifest task would crash XmlLogger
4939
4940* A bug existed that prevented generated log files from being deleted as
4941 part of the build process itself. This has now been fixed.
4942
4943* Fixed bug where <move> ignored <filterset>s.
4944
4945* Ant works properly with the combination of Java1.4/WindowsXP.
4946
4947* Fixed bug where <java> used to sometimes invoke class constructors twice.
4948
4949* Fixed bug with 4NT shell support.
4950
4951* Fixed bug where ant would not perform ftp without remotedir being
4952 specified even though this was not mandatory.
4953
4954* Fixed bug where ant would not copy system properties into new Project
4955 in ant/antcall tasks when inheritall="false" is set.
4956
4957* <propertyfile> would not close the original property file.
4958
4959* <ant> will no longer override a subbuild's basedir with inheritall="true".
4960
4961* Fixed problem with the built-in <junit> formatters which assumed
4962 that only one test could be running at the same time - this is not
4963 necessarily true, see junit.extensions.ActiveTestSuite.
4964
4965* <jar>'s whenEmpty attribute is useless as JARs are never empty, they
4966 contain at least a manifest file, therefore it will now print a
4967 warning and do nothing.
4968
4969* <typedef> hasn't been all that useful as it couldn't be used outside
4970 of targets (it can now) and nested "unknown" elements have always
4971 been considered to be tasks (changed as well).
4972
4973* <fixcrlf> would fail for files that contained lines longer than 8kB.
4974
4975* Some junit formatters incorrectly assumed that all testcases would
4976 inherit from junit.framework.TestCase.
4977
4978* <fixcrlf> dropped the first characters from Mac files.
4979
4980Other changes:
4981--------------
4982
4983* <checksum> now uses a buffer (of configurable size).
4984
4985* The "Trying to override task definition" warning has been degraded
4986 to verbose level if the two task definitions only differ in the class
4987 loader instance that has loaded the definition.
4988
4989* Add a jvmargs to the ejbjar's weblogic element to allow additional
4990 arguments to be provided to the VM runnign ejbc. Document the
4991 jvmdebuglevel attribute which can be used to avoid warnings about
4992 interface classess being found on the classpath. Document the new
4993 <sysproperty> element which allows JVM properties to be defined.
4994 Added an outputdir attribute to allow the destination to be a
4995 directory into which the exploded jar is written.
4996
4997* ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
4998
4999* added **/.svn and **/.svn/** to the default excludes.
5000
5001* Selector Elements now provide a way to create filesets based on
5002 sophisticated selection criteria.
5003
5004* Gzip and Bzip2 files can now be constructed in the fly when using
5005 the tar task without having to create the intermediate tar file on
5006 disk. The Untar task can also untar GZip and BZip2 files on the fly
5007 without creating the intermediate tar file.
5008
5009* New optional type, <classfileset> added.
5010
5011* <ejbjar> now allows control over which additional classes and interfaces
5012 are added to the generated EJB jars. A new attribute "dependency" can be
5013 defined which controls what classes are added. The addition of classes now
5014 uses the Jakarta-BCEL library rather than reflection, meaning bean classes are
5015 no longer loaded into Ant's JVM. The default dependency analyzer is known as
5016 the ancestor analyzer. It provides the same behaviour as the 1.4.1 version of
5017 <ejbjar>. If the BCEL library is not present, a warning will be issued stating
5018 the ancestor analyzer is not available. In this case <ejbjar> will continue
5019 to function but will not add super classes to the jar.
5020
5021* <available> has a new attribute named ignoreSystemClasses.
5022
5023* New task <cvschangelog/> generates an XML report of changes that occur
5024 on CVS repository.
5025
5026* New filter readers: ClassConstants, ExpandProperties, HeadFilter,
5027 LineContains, LineContainsRegExp, PrefixLines, ReplaceTokens,
5028 StripJavaComments, StripLineBreaks, StripLineComments, TabsToSpaces,
5029 TailFilter.
5030
5031* <copy>, <loadfile>, <loadproperties>, <move> support FilterChains
5032 of FilterReaders.
5033
5034* New task <loadproperties> to load contents of file as Ant properties,
5035 with nested <filterchain> elements.
5036
5037* New task <loadfile> to load a whole file into a property.
5038
5039* New task <echoproperties> to list your current properties to the screen
5040 or a file.
5041
5042* New tasks <bzip2> and <bunzip2> to pack and unpack files using the
5043 BZip2 alogrithm.
5044
5045* New tasks <replaceregexp>, <checksum>, <translate>, <waitfor>,
5046 <manifest>, <vsscp>, <vssadd>, <vsscreate>, <splash>, <basename>, <dirname>,
5047 <concat>, <sourceoffsite>, <jarlib-available>, <jarlib-display>,
5048 <jarlib-manifest>, <jarlib-resolve>.
5049
5050* A new combined <mail> task, which replaces the old <mail> and
5051 <mimemail> tasks, has been added. The <mimemail> task, and
5052 old SendEmail and MimeMail classes have been deprecated.
5053
5054* Mail task allows specification of port number.
5055
5056* Users can control what <zip> and <jar> must do when duplicate files
5057 are found. A new element <zipgroupfileset> allows for multiple zip
5058 files to be merged into the archive. In addition, <jar> also has
5059 another new attribute: filesetmanifest. The existing manifest
5060 attribute of <jar> now also accepts the name of a jar added through
5061 a fileset.
5062
5063* gzip now checks that the zipfile is older than the source file
5064 before rebuilding the zipfile.
5065
5066* TarFileset takes in three new attributes - fullpath, prefix
5067 and preserveLeadingSlashes.
5068
5069* <move> attempts to rename the directory, if everything inside it is
5070 included, before performing file-by-file moves. This attempt will
5071 be done only if filtering is off and if mappers are not used. This
5072 is a performance improvement and there is no change otherwise in
5073 the functionality of this task.
5074
5075* Exec task has extra attribute "resultproperty" to get the return code
5076 into a property.
5077
5078* Exec task prints a message when a timed-out process is killed.
5079
5080* Added optional attributes - name, arch and version to the <os> task.
5081
5082* Unjar, Untar, Unwar and Unzip now support patternsets to
5083 select files from an archive for extraction. Filesets may be
5084 used to select archived files for unarchival.
5085
5086* Javac task allows debug levels to be specified. Debug levels
5087 will have an effect only when the modern compiler or the
5088 classic compiler (version 1.2 and higher) is used and debugging
5089 is enabled.
5090
5091* Added support for specifying CVS_RSH in the <cvs/> task
5092
5093* The attributes zipfile, jarfile, warfile and earfile (from the Zip,
5094 Jar, War and Ear tasks) have been deprecated and superseded by a
5095 new attribute "destfile".
5096
5097* Added new conditions <isset>, <checksum>, <http>, <socket>, <contains>,
5098 <filesmatch>.
5099
5100* <taskdef> and <typedef> will now emit a warning if a task/type of
5101 the given name already exists.
5102
5103* A new revision of VAJ tasks: The most important new feature
5104 is the ability to execute VAJ tasks from the command line by
5105 exploiting the Remote Tool Access feature of VAJ.
5106
5107* Improved support for Novell NetWare.
5108
5109* Added an optional encoding attribute to <fixcrlf>.
5110
5111* <apply> has a new attribute relative that allows users to pass the
5112 filenames as relative instead of absolute paths on the command line.
5113
5114* References can now be copied into the child build by <ant> and
5115 <antcall> using nested <reference> elements or the new inheritRefs
5116 attribute.
5117
5118* <fail> now supports builds to fail based on conditions via if and
5119 unless attributes.
5120
5121* Ant now comes with two new BuildLogger implementations - one that
5122 can send emails containing a log of the build process (MailLogger),
5123 and one that colorizes the output based on message levels, using
5124 ANSI color code escape sequences (AnsiColorLogger).
5125
5126* A "package" mapper type has been added to allow package directory
5127 names replaced with the dotted form.
5128
5129* You can now specify environment variables in the <java> and <junit> tasks
5130 if the fork attribute has been set to true.
5131
5132* -propertyfile command-line option has been added to load an entire
5133 property file just as -D properties are declared (as user properties).
5134 -D properties take precedence over -propertyfile specified ones.
5135
5136* You can now set an ANT_ARGS environment variable to hold arguments you
5137 always want passed to the 'ant' command -- for example, if you always
5138 want to use a different logger or the -find flag.
5139
5140* <tstamp> now supports a new "prefix" attribute to prefix properties set.
5141
5142* You can now specify the -sourcepath for <javac> explicitly.
5143
5144* <javac> now supports a new "listfiles" attribute to list the source
5145 files it's handing off to the compiler.
5146
5147* The compiler implementation for <javac> can now be chosen on a task by
5148 task basis. The new "compiler" attribute of <javac> can be used to override
5149 the value of the build.compiler property, if set.
5150
5151* <javac> has a new nested element, <compilerarg>, which allows you
5152 to specify additional args for the specific compiler you're using.
5153
5154* <javac>'s "source" attribute is now enabled for jikes as well.
5155
5156* <propertyfile>'s <entry> now has a 'unit' attribute to specify the
5157 increment/decrement unit on date operations.
5158
5159* <property> now supports a 'prefix' attribute when loading from a file
5160 or resource.
5161
5162* In Ant 1.4, a feature has been added to the <junit> task that would
5163 add ant.jar, optional.jar and junit.jar implicitly to the classpath -
5164 this feature can now be disabled by setting the new includeantruntime
5165 attribute to false.
5166
5167* <style> behaves differently from any other directory-based task, as it
5168 processes all files that it finds in included directories in
5169 addition to the files matched by your patterns. There is now a new
5170 attribute, 'scanincludeddirectories', to suppress this behavior.
5171
5172* <javadoc> now supports a <tag> nested element to provide the -tag option
5173 to the standard Java 1.4 doclet. The element is ignored when not running
5174 on Java 1.4.
5175
5176* <ftp> can now chmod files on a remote server that supports
5177 "site chmod", as well as set the umask before transferring files, if
5178 the server supports "site umask".
5179
5180* New <serverdeploy> "optional" task.
5181
5182* <patternset> now supports nested patternsets.
5183
5184* Perforce tasks now support a "failonerror" attribute (defaults to "true").
5185
5186* Open Source application server JOnAS support:
5187 EJB hot deploy and deploy with <serverdeploy> and <ejbjar>
5188
5189* Added new DirSet (<dirset>) datatype.
5190
5191* <path> now supports nested <dirset> and <filelist> elements.
5192
5193* <pathconvert> now supports nested <dirset> and <filelist> elements.
5194
5195* <pathconvert>'s "dirsep" and "pathsep" attributes now accept
5196 multi-character values.
5197
5198* <copy> task now has a 'failonerror' attribute to allow keep-going
5199 behaviour when the file to be copied is not found (defaults to "true").
5200
5201* <uptodate> now has a 'srcfile' attribute to allow specifying a
5202 full-path filename.
5203
5204* <exec>, <sql> and <java> now support append attributes to allow
5205 appending the output to an existing file.
5206
5207* <java> now supports a timeout attribute analog to <exec> - it is
5208 highly recommended to only use it together with fork="true".
5209
5210* <javadoc> now supports a source attribute to enable javadoc to
5211 handle assertions present in JDK 1.4 source code.
5212
5213* <replace> supports a new replacefilterfile attribute that
5214 automatically turns all properties of a given file into
5215 replacefilters.
5216
5217* An alias of <xslt> has been added to refer to the <style> task.
5218
5219* The compiler implementation for <rmic> can now be chosen on a task by
5220 task basis. The new "compiler" attribute of <rmic> can be used to override
5221 the value of the build.rmic property, if set.
5222
5223* <rmic> has a new nested element, <compilerarg>, which allows you
5224 to specify additional args for the specific compiler you're using.
5225
5226* org.apache.tools.ant.XmlLogger now is a BuildLogger, rather than just
5227 a BuildListener. It can operate in either mode successfully.
5228
5229* <junit> has a new attribute "showoutput". If set to true, output
5230 generated by tests will be sent to Ant's logging system as well as
5231 to the formatters (instead of sending it to the formatters
5232 exclusively).
5233
5234* Ant has now a pluggable way to prompt users for input, which is used
5235 by the new <input> task. IDE integrators can provide an
5236 implementation of the InputHandler interface to decouple Ant's input
5237 from the console. An implementation that gets its input from a file
5238 for unattended builds is part of Ant's distribution.
5239
5240 For more details see docs/manual/inputhandler.html.
5241
5242* <patch> has a new attribute that selects the directory in which to
5243 run the command.
5244
5245* <javadoc> now supports two new nested elements, <fileset> and <packageset>.
5246
5247
5248Changes from Ant 1.4 to Ant 1.4.1
5249===========================================
5250
5251Fixed bugs:
5252-----------
5253
5254* <ant>'s antfile attribute will now also be considered an absolute path on
5255 Windows systems, if it starts with a \ and no drive specifier.
5256
5257* The fullpath attribute of <zipfileset> has been ignored if you used
5258 the src attribute at the same time.
5259
5260* The manifest file is now always placed as the second entry (after /META-INF)
5261 in generated jars. This allows the manifest to be read by JarInputStreams
5262
5263* Fixed bug in depend task which would fail with a NullPointerException if no
5264 dependency cache was specified.
5265
5266* sql task now handles REM statements correctly so that lines starying with rem
5267 but which are not comments are actually processed.
5268
5269* XMLLogger now uses the task's name rather than the classname
5270
5271* <mapper>s will now work as expected if the to pattern expands to an
5272 absolute pathname.
5273
5274* <javac> didn't ignore memory settings in non-fork mode
5275
5276* <cab> didn't split the options attribute into several command line
5277 arguments correctly.
5278
5279Other changes:
5280--------------
5281
5282* New source attribute for <javac> to enable assertion in JDK 1.4
5283
5284* XmlLogger and <antstructure> now add an encoding declaration to the
5285 XML files they generate.
5286
5287* <fileset> has a new attribute "casesensitive" to make it match
5288 filenames in a case insensitive way (if you set it to false) - by
5289 default filesets remain case sensitive.
5290
5291Changes from Ant 1.3 to Ant 1.4
5292===========================================
5293
5294Changes that could break older environments:
5295--------------------------------------------
5296* JUnitReport now uses the xalan redirect extension for multi-output.
5297 With Xalan 1.2.2 it forces the use of bsf.jar in the classpath.
5298 (Available in the xalan distribution). It is recommended to switch
5299 to Xalan 2.x that do not need it.
5300
5301* Zip.setWhenempty() has changed its signature.
5302
5303* <rmic> is now implemented using a factory. This makes extending
5304 rmic to use a new compiler a lot easier but may break custom
5305 versions of this task that rely on the old implementation.
5306
5307* several Zip methods have changed their signature as we now use a Zip
5308 package of our own that handles Unix permissions for directories.
5309 Furthermore <zip> will now use the platform's default character
5310 encoding for filenames - this is consistent with the command line
5311 ZIP tools, but causes problems if you try to open them from within
5312 Java and your filenames contain non US-ASCII characters. Use the new
5313 encoding attribute of the task and set it to UTF8 to get the old
5314 behavior.
5315
5316* The <pvcs> task has been moved to a package of its own.
5317
5318* JUnitResultFormater has two additional methods that must be
5319 implemented by custom formatters.
5320
5321* Ant will no longer use the canonical version of a path internally -
5322 this may yield different results on filesystems that support
5323 symbolic links.
5324
5325* The output generated by the xml formatter for <junit> has changed
5326 again, it doesn't format the numeric value in the time attribute anymore.
5327
5328* Pattern matching rules have changes slightly, the pattern foo*
5329 doesn't match files contained in a directory named foo - use foo/*
5330 instead.
5331
5332* <fixcrlf> will not remove trailing whitespace at the end of lines anymore.
5333
5334* The Classloader usage has been changed for the taskdef, property, available
5335 and sql tasks so that it delegates to the parent classloader. This may cause
5336 ClassNotFoundExceptions to be thrown if a system class attempts to load a
5337 class in the taskdef's classpath (typically factory objects).
5338
5339* Ant now allows multithreading of tasks and the containment of tasks within
5340 other tasks. This can break customer listeners which do not expect messages
5341 from a task before the previous task has finished.
5342
5343* Ant now installs its own ouput stream into System.out to route output to the
5344 task currently executing on the current thread. This also means that all
5345 output is now routed as Ant message events. Customer listeners and loggers
5346 should not call System.out at any time. This has always been true but such
5347 usage now will cause problems due to possible recursion.
5348
5349* Invalid manifest files will now cause build failures in the <jar> task.
5350
5351* Ant Introspection now looks for methods with method names starting with
5352 addConfigured. When called these methods are passed an argument after it has
5353 been configured from the build file. Custom tasks supporting nested elements
5354 starting with the name configured will no longer function.
5355
5356* The environment variable JAVACMD that can be used to specify the
5357 java executable to Ant's wrapper scripts must not contain additional
5358 command line parameters any longer - please use the environment
5359 variable ANT_OPTS for such parameters now.
5360
5361* Ant's wrapper scripts now quote the CLASSPATH environment variable, thus
5362 supporting classpaths which refer to directories containing spaces. This means
5363 that the CLASSPATH environment variable cannot have quotes. Any quotes should
5364 be removed. This will not affect the operation of the CLASSPATH environment
5365 variable in other contexts.
5366
5367* A delete task like
5368 <delete includeEmptyFilesets="true">
5369 <fileset dir="somedir" />
5370 </delete>
5371 will now remove "somedir" as well, unless there are still files left
5372 in it (matched by the default excludes).
5373
5374* The copy task will now fail if the file to be copied is not found.
5375
5376* Ant properties defined in properties files now behave the same way as
5377 properties defined in the build file. In particular the $ character needs
5378 to be escaped in property values by doubling it to $$. So, to define a
5379 property with the value $hello, you need to define it in a properties file
5380 as
5381 test.prop=$$hello
5382 This was not the case in Ant 1.3
5383
5384Other changes:
5385--------------
5386
5387* New tasks: ear, p4counter, record, cvspass, vsscheckin, vsscheckout,
5388 typedef, sleep, mimemail, set of tasks for Continuus/Synergy, dependset,
5389 condition, maudit, mmetrics, jpcoverage, jpcovreport, jpcovmerge
5390
5391* Ant now uses JAXP 1.1
5392
5393* rmic now supports Kaffe's and Weblogic's version of rmic.
5394
5395* new magic property build.rmic to chose the rmic implementation
5396
5397* <tar> will now add empty directories as well
5398
5399* you can now specify a description for <p4change>
5400
5401* <touch> can now work on <fileset>s
5402
5403* <uptodate> now supports a value attribute
5404
5405* <fail> supports nested text
5406
5407* <fixcrlf> won't override files that are already in the correct
5408 format.
5409
5410* <sql> now supports REM comments as well as // and --
5411
5412* <jar> now has a nested <metainf> element following the same idea as
5413 <war>'s <webinf>.
5414
5415* <pvcs> can now handle multiple projects.
5416
5417* <available> now has a "type" attribute you can use in conjunction
5418 with the "file" attribute to specify whether the "file" you're
5419 looking for is a file or a directory.
5420
5421* New <junit> formatter named "brief"
5422
5423* <ejbjar> changes
5424 * Add support for Borland Application Server to the <ejbjar> task using
5425 a <borland> nested element.
5426 * Add support for iPlanet Application Server to the <ejbjar> task. Also
5427 includes some iPlanet utility tasks
5428 * Add support for JBoss Application Server to the <ejbjar> task.
5429 * Add a naming attribute to control the naming scheme that
5430 ejbjar uses to name the generated EJB jars.
5431 * Weblogic element now sets the compiler class for EJB 2.0 beans
5432 * <dtd> elements can be specified at the <ejbjar> level for building generic
5433 beans
5434 * <dtd> elements can now be URLs
5435 * Allow the manifest to be specified for the generated jars
5436 * The weblogic element now supprts an attribte noEJBC to skip the processing
5437 of the jar by ejbc. The ejbc step will then occur at deployment
5438 * weblogic will tell ejbc to use Jikes compiler if build.compiler is set to
5439 jikes. It can be restored to the default, javac, operation if desired.
5440
5441* Allow the <sql> Delimiter to be set in the so that Oracle stored procs may be
5442 entered
5443
5444* <execon> and <apply> can now optionally skip empty filesets.
5445
5446* <javadoc> has a new useexternalfile attribute that makes it use a
5447 temporary file for sourcefile and package names - helps to defeat
5448 command line length limitations.
5449
5450* Data types like <path> can now be defined inside of <target>s
5451
5452* you can now specify a classpath for <style> - the XSLZ processor
5453 will be loaded from this path
5454
5455* added a force attribute to <style> to support dependencies that the
5456 task cannot determine itself (dependency on parameters, not file
5457 modification times for example)
5458
5459* added vmlauncher attribute to exec tasks. This defaults to true. If
5460 it is set to false, the VM's ability to launch commands in bypassed
5461 and the OS shell, either directly or through the auxillary antRun
5462 scripts is used.
5463
5464* regexp mapper now supports the java.util.regex package of JDK 1.4.
5465
5466* New filesonly attribute for <zip> and friends to suppress directory
5467 entries.
5468
5469* New update attribute for <zip> and friends - update an existing
5470 archive instead of creating a new one.
5471
5472* <apply> and <execon> have been merged into a single task.
5473
5474* added vssver.scc to the default excludes
5475
5476* <available> has a new filepath attribute/nested element that allows
5477 you top search for a file in a given path.
5478
5479* <junit> can now optionally set a property on test failure.
5480
5481* <taskdef> can now define several tasks at once, reading the
5482 name/classname pairs from a property file or resource.
5483
5484* <unzip/unjar/unwar> and <untar> now have an overwrite attribute that
5485 defaults to true. If set to false, files that are newer than the
5486 files in the archive will not be replaced.
5487
5488* <patternset> and <fileset> now support nested <in/excludesfile>
5489 elements - using these you can have more than one in/excludes file
5490 per <patternset>.
5491
5492* Three new supported compilers for javac: kjc for kopi, gcj for the
5493 gcc frontend and sj for Symantec's compiler.
5494 In addition extJavac or the new fork attribute can be
5495 used to run the JDK's javac in a JVM separate from Ant.
5496
5497* <fixrlf> can now with CR only line-ends and can use an arbitraty
5498 between 2 and 80.
5499
5500* The .NET tasks have been adapted to the beta2 release of the framework.
5501
5502* <move> will now try to rename() files before copying them byte by
5503 byte - only if filtering is of, of course.
5504
5505* <ant> and <antcall> tasks now support a new attribute inheritAll. When set to
5506 false, only user properties are passed through to the target Ant instance.
5507 This includes properties set on the command line and properties explicitly
5508 passed
5509
5510* <javadoc> now skips off line links if the package list cannot be found.
5511
5512* <wlrun> now allows the security policy file to exist outside the weblogic
5513 directory.
5514
5515* <java> task will set the Thread contextClassLoader under JDKs 1.2+ to the
5516 classloader for the class being executed.
5517
5518* Introduce the concept of a TaskContainer - a task or element which can contain
5519 Ant Tasks.
5520
5521* Add new tasks implementing the TaskContainer interface <parallel> and
5522 <sequential> which allow parallel execution of tasks to be specified.
5523
5524* <depend> task will now take into account dependencies on jar files and class
5525 files from a given classpath.
5526
5527* <jar> manifest entries may now be specified in the build file either
5528 completely or to be merged with a manifest file.
5529
5530* <tstamp> task custom formats now support locales.
5531
5532* Added a listner which will forward events to Log4J. The log4j configuration
5533 file should be in the directory from which Ant is run or passed as a system
5534 property using a JVM argument.
5535
5536* Introduced the concept of <filtersets> to allow for more control in which
5537 filters get applied in a <copy> or <move> operation.
5538
5539* Added nowarn attribute to javac and deprecated the Jikes-magic property
5540 build.compiler.warnings.
5541
5542* The <depend> task cache format has changed and all dependency information is
5543 now stored in a single file.
5544
5545Fixed bugs:
5546-----------
5547
5548* Testcases have been made independent of current working directory.
5549
5550* Input ZIP-Files will be closed when using a <zipfileset>.
5551
5552* p4 tasks now don't fail if user, port or client have been omitted
5553 (and this is acceptable for the context of the command).
5554
5555* <javah>'s outputfile attribute will be resolved as relative to the
5556 projects basedir.
5557
5558* <antstructure> should create a valid DTD for propertyfile.operation.entry
5559 and omit tasks it fails to load.
5560
5561* won't try to pass a -bootclasspath flag to javac 1.1 anymore
5562
5563* <style>'s style attribute no handles absolute paths correctly.
5564
5565* <delete includeemptydirs="true"> now deletes more than just the leaf
5566 directories.
5567
5568* You can now specify a <fileset> for a directory that doesn't exist at
5569 declaration time but will created before the fileset gets used for the
5570 first time.
5571
5572* If the quiet attribute has been set, <delete> will handle <fileset>s
5573 with non-existing directories gracefully.
5574
5575* Output written by testcases will now be captured by the <junit> task
5576 and passed to the formatters.
5577
5578* Quote the -group parameter to Javadoc as per the specification
5579
5580* Initialise classes when loaded through the AntClassLoader - that is, run
5581 static initializers
5582
5583* Implement getResource() and getResources() in AntClassLoader
5584
5585* Create the <ejbjar> weblogic command line as a set of arguments rather than
5586 as a single line. Avoids problems with paths which contain spaces.
5587
5588* <ejbjar> now fails when the weblogic ejbc compiler reports an error.
5589
5590* Make the AntClassLoader load resources in the same order as it currently
5591 loads classes.
5592
5593* Handle classpaths with spaces
5594
5595* Make sure XSLT processors close their output files in <style>.
5596
5597* perform proper uptodate check in <rmic> when compiling for IIOP.
5598
5599* <jjtree>'s uptodate test works even if outputdirectory is not the
5600 parent dir of target
5601
5602* <copy> will remove target file (if it exists) before writing to it -
5603 this avoids problems with links on filesystems that support them.
5604
5605* <ftp> now properly recurses remote directories.
5606
5607* <ftp> closes remote connection when it's done.
5608
5609* <junit> tries to include all necessary classes for the task itself
5610 to the classpath when running in fork mode - doesn't work for JDK 1.1
5611
5612* <apply> and <execon> do now execute the command only once, if you
5613 specify the parallel attribute - instead of once per fileset.
5614
5615* directory based tasks and fileset could miss some included files in
5616 directories that have been excluded
5617
5618* <fixcrlf> failed for large files.
5619
5620* <move> removed files you tried to move to themselves.
5621
5622* <sql> task will not trty to print the result set unless the query succeeded.
5623
5624* Ant classloader will now ignore paths which are invalid relative to the
5625 project base
5626
5627* <ejbjar> weblogic elements check for jar file changes has been fixed.
5628 Previously some changes would not be included.
5629
5630* properties loaded from properties files are now resolved internally. This
5631 removes the spurious warnings about usage of properties which have not been
5632 set.
5633
5634* <jar> task and friends now process the JAR manifest to ensure it is valid.
5635
5636* The task finished event now includes any exception thrown by the task.
5637
5638* <java> task now supports a jvmVersion attribute so that if another JVM is
5639 being used, Ant can determine which options to use for features such as the
5640 VM memory limits
5641
5642
5643Changes from Ant 1.2 to Ant 1.3
5644===========================================
5645
5646Changes that could break older environments:
5647--------------------------------------------
5648
5649* Ant doesn't search for the buildfile anymore, unless you use the new
5650 -find argument.
5651
5652* <perforce> has been replaced by a number of new tasks.
5653
5654* <javac> is now implemented using a factory. This makes extending
5655 javac to use a new compiler a lot easier but may break custom
5656 versions of this task that rely on the old implementation.
5657
5658* The output generated by the xml formatter for <junit> has changed a
5659 little, it doesn't append " sec" in the time attribute anymore.
5660
5661Other changes:
5662--------------
5663
5664* A GUI Frontend: Antidote. This is currently in development. At this
5665 time, this is not part of the Ant release, although the source is
5666 included if you are interested.
5667
5668* New tasks: stylebook, propertyfile, depend, antlr, telnet, csc,
5669 ilasm, apply, javah, several clearcase tasks, junitreport, sound
5670
5671* Added output attribute to <java>.
5672
5673* Added nested zipfileset element to <zip>
5674
5675* Changed <sql> so that printing is at the task level rather than
5676 the statement level.
5677
5678* javadoc task will pass -d flag to any doclet if the destDir attribute is
5679 given. If the doclet does not accept the -d flag then omit the destdir
5680 attribute.
5681
5682* <cab> can work on non-Windows platforms with the help of libcabinet.
5683 See http://trill.cis.fordham.edu/~barbacha/cabinet_library/.
5684
5685* <ftp> now supports passive mode.
5686
5687* New <mapper> data type that can be used to get influence on the
5688 target files for some tasks like <copy> or enable new types of tasks
5689 like <apply>.
5690
5691* <execon> provides more control over the command line now, the names
5692 of the source files are no longer required to be at the end of the
5693 command.
5694
5695* Style tasks will now support TraX compliant XSL processors if one is present
5696 in your classpath.
5697
5698* Added a failonerror to the javac task. If set to false, the build will
5699 continue even if there are compilation errors.
5700
5701* Added nested format elements to the tstamp task allowing additional time
5702 formats to be defined for arbitrary properties.
5703
5704* Added classpath attribute and nested classpath element to <property>
5705 to make the resource attribute more powerful.
5706
5707* ${} property expansion will now be performed on the patterns read
5708 from files specified as includesfile or excludesfile attributes.
5709
5710* The <tar> and <untar> tasks now support GNU format for handling paths
5711 which are greater than 100 characters in length. In addition the <tar>
5712 task now supports nested filesets through which the file permissions
5713 may be controlled.
5714
5715* wlrun, wlstop and ejbjar now support Weblogic 6.0
5716
5717* The MPasre task has been updated to work with MParse 2.0
5718
5719* The documentation has been significantly updated.
5720
5721
5722Fixed bugs:
5723-----------
5724
5725* <signjar> no longer uses deprecated methods.
5726
5727* javadoc's failonerror attribute works again
5728
5729* javadoc's additionalparam attribute will now be split into separate
5730 parameters (on spaces) to allow for more than one parameter.
5731
5732* Changed <sql> task so that printing result sets works on Oracle
5733
5734* Changes to ddcreator and ejbc helper to respect the descriptor hierarchy
5735 keppgenerated in ejbc can now be turned off
5736
5737* ejbjar now correctly ignores <ejb-ref> elements in the deployment descriptor.
5738 CMP files are included by parsing the weblogic deployment descriptor rather
5739 than relying on the naming convention used in ant 1.2
5740
5741* ejbjar includes super classes and super interfaces into the generated ejb
5742 jar files. The <support> nested element allows support classes to be
5743 included in the EJB jar. The toplink element should now correctly locate
5744 the toplink descriptor.
5745
5746* <vssget> now correctly deals with spaces in arguments
5747
5748* <jar> fails early if a given manifest file doesn't exist
5749
5750* <rmic> doesn't search for the _Skel file anymore when stubversion is
5751 set to 1.2.
5752
5753* <rmic> uses the the same classpath to verify a class can be rmic'd
5754 as it passes to the compiler.
5755
5756* org.apache.tools.mail.MailMessage (and therefore <mail>) can now
5757 handle SMTP servers sending multi line responses.
5758
5759* nested <classpath> elements of <taskdef> now work for <taskdef>s not
5760 nested into <target> as well.
5761
5762* <property> and <available> will search for the resource "foo" instead
5763 of "/org/apache/tools/ant/taskdefs/foo" when given a relative resource
5764 name foo.
5765
5766* Handle build files in directories whose name contained a "#" character
5767
5768* <junit> can now log to files whose name contains a comma as well.
5769
5770* The AntClassLoader now refers to the loader which loaded it, any
5771 requests it does not handle itself. Previously these went to the
5772 primordial loader.
5773
5774Changes from Ant 1.1 to Ant 1.2
5775===============================
5776
5777Changes that could break older environments:
5778--------------------------------------------
5779
5780* Semantics of <property> has changed again in the hope to be more
5781 intuitive. ${} expansion now happens at runtime and <property> tags
5782 living inside of targets only take effect if they are visited at
5783 runtime.
5784
5785 As a side effect of this change, task's attributes get set at runtime
5786 not at parser time as well, which might change the results of
5787 <script>s or other custom tasks that reference other tasks by their id
5788 attribute.
5789
5790* copying of support files in <javac> has been removed - as well as
5791 the filtering attribute.
5792
5793* the <expand> and <keysubst> tasks have been removed.
5794
5795* the ignore and items attributes of directory based tasks have been removed.
5796
5797* the command line switches _not_ starting with - have been removed.
5798
5799* Path and EnumeratedAttribute have been moved from
5800 org.apache.tools.ant to org.apache.tools.ant.types.
5801
5802* the class attributes of <available>, <java>, <rmic> and <taskdef>
5803 have been removed.
5804
5805* the src attribute of <chmod> has been removed.
5806
5807* <patch> and <javadoc> have lost some of their attributes.
5808
5809* <java> and <cvs> have lost some undocumented attributes.
5810
5811* the Unix antRun script would search for command.sh in the directory
5812 it changed to and invoke this instead of command if present. This
5813 behavior has been dropped.
5814
5815* <ejbjar> task syntax has been changed significantly
5816
5817* <exec> is no longer implemented by org.apache.tool.ant.taskdefs.Exec.
5818 Custom tasks that rely on Project.createTask("exec") to return an
5819 instance of this class are going to fail.
5820
5821* nested <include> and <exclude> elements expect the value of their
5822 name attribute to be a single pattern, they don't accept multiple
5823 patterns anymore. Split them into multiple elements of the same type.
5824
5825* <delete dir="somedir" /> will now delete the directory itself as
5826 well as all included files. If you just want to clean out the
5827 directory and keep the empty one, use a nested fileset.
5828
5829Other changes:
5830--------------
5831
5832* New tasks: antstructure, cab, execon, fail, ftp, genkey, jlink,
5833 junit, sql, javacc, jjtree, starteam, war, unwar, uptodate,
5834 native2ascii, copy, move, mparse.
5835
5836* copydir, copyfile, deltree and rename are now deprecated. They
5837 should be replaced with the new copy, delete and move tasks.
5838
5839* <java> uses a ClassLoader of its own in no-fork mode if a classpath is
5840 specified.
5841
5842* <style> will create the necessary target directories and reprocess
5843 all files if the stylesheet changes.
5844
5845* New data types fileset and patternset - expected to get a broader use.
5846 They, as well as PATH like structures, can now be defined on a global
5847 level and later be referenced by their id attribute.
5848
5849* You can specify environment variables to <exec>.
5850
5851* <get> can check whether a remote file is actually newer than a local
5852 copy before it starts a download (HTTP only).
5853
5854* Added a -logger option to allow the class which performs logging to be
5855 specified on the command line.
5856
5857* Added a -emacs option to tell the logger to leave out taskname adornments
5858 on log output.
5859
5860* <chmod> works on all files in parallel and supports multiple filesets.
5861
5862* <replace> can now use tokens and/or values that cross line boundaries.
5863
5864* build.compiler supports now jvc as well.
5865
5866* project specific help can now be obtained with the -projecthelp option.
5867
5868* Added a -debug option to make -verbose less verbose (and more useful)
5869
5870* Ant will now search for a file named build.xml in the parent directory
5871 and above (towards the root of the filesystem) if you didn't specify
5872 -buildfile and there is no build.xml in the current directory.
5873
5874* <echo> can now write to a file and accepts nested text.
5875
5876Fixed bugs:
5877-----------
5878
5879* <chmod> didn't work when used as a directory based task.
5880
5881* Path, Available, Property didn't resolve relative filenames with
5882 respect to the Project's basedir.
5883
5884* Project didn't interpret the basedir attribute correctly in all
5885 cases.
5886
5887* Nested <src> in <javac> caused NullPointerException.
5888
5889* Corrupt Zip- and Jar-files ar now deleted if the task fails.
5890
5891* many more fixes we've forgotten to document here ...
5892
5893* The packagelistloc attribute of <javadoc>'s <link> child will be
5894 resolved as a file (i.e. it is either absolute or relative to
5895 basedir).
Note: See TracBrowser for help on using the repository browser.