You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

WHATSNEW 67 kB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810
  1. Changes from Ant 1.5.1 to current CVS version
  2. =============================================
  3. Changes that could break older environments:
  4. --------------------------------------------
  5. * Targets cannot have the empty string as their name any longer.
  6. * ant.jar's manifest does no longer include a Class-Path entry, so it
  7. is no longer possible to run Ant via "java -jar ant.jar" without
  8. manually altering the CLASSPATH. Instead of that a file
  9. ant-bootstrap.jar is included in the etc directory of the binary
  10. distribution, copy this to the lib directory and use
  11. "java -jar ant-bootstrap.jar" instead if you want to run Ant without
  12. the wrapper script (not recommended).
  13. * The <script> task now requires Apache BSF instead of the older IBM
  14. version. See <http://jakarta.apache.org/bsf/>
  15. Fixed bugs:
  16. -----------
  17. * <property environment=... /> now works on OS/400.
  18. * <manifest> wouldn't update an existing manifest if only an attribute
  19. of an existing section changed.
  20. * ant.bat now supports the ANT_ARGS and JAVACMD environment variables
  21. again (like Ant 1.5 did).
  22. * The "plain" <junit> <formatter> could throw a NullPointerException
  23. if an error occured in setUp.
  24. * <cab> could hang listcab on large <fileset>s.
  25. * <junit> will now produce output when a test times out as well.
  26. * The starteam stcheckout, stcheckin tasks now correctly compute status of files
  27. against whatever local tree they are run against and, optionally, will not
  28. process a file if it is current. Previously you had to process everything
  29. unless you ran against the default folder which wasn't the normal use-case for
  30. ant-starteam. The stlist task now similarly displays that status correctly
  31. making it a more generally useful tool.
  32. * <replace> would count some internal character replacements when
  33. reporting the number of replaced tokens.
  34. * <concat> would cause an exception if a <filelist> pointed to files
  35. that do not exist.
  36. * <javadoc> will now pass -source to custom doclets as well.
  37. Other changes:
  38. --------------
  39. * <setproxy> lets you set the username and password for proxies that want authentication
  40. * <loadproperties> has a new encoding attribute.
  41. * <echoproperties> can now create XML output.
  42. * <echoproperties> has a new srcfile attribute that can make it read
  43. properties files and output them instead of Ant's properties.
  44. * <filterset> will now resolve filters recursively.
  45. * <input> has a new attribute that allows you to specify a default value.
  46. * All tasks can be used outside of <target>s
  47. * Added <image> task (requires JAI).
  48. * New condition <isreference>
  49. * <ftp> now has a preservelastmodified attribute to preserve the
  50. timestamp of a downloaded file.
  51. * new rmdir action for <ftp> that removes directories from a fileset.
  52. * The SOS and VSS tasks will no longer unconditionally prepend a $ to
  53. vsspath or projectpath.
  54. * OS/400 now gets detected by the os condition.
  55. * <arg> has a new attribute pathref that can be used to reference
  56. previously defined paths.
  57. * <xmlproperty> has been improved, you can now expand ${properties},
  58. define ids or paths and use Ant's location magic for filename resolutions
  59. in the XML file.
  60. * <xmlcatalog> will now support external catalogs according to the
  61. OASIS "Open Catalog" standard - if resolver.jar from Apache's
  62. xml-commons is in your CLASSPATH.
  63. * Starteam tasks now have support for revision labels and build labels.
  64. Checkouts now have the option of using repository timestamps, instead
  65. of current.
  66. * new task <symlink> that creates and maintains symbolic links.
  67. * new tasks <chown> and <chgrp> which are wrappers of the Unix commands.
  68. * new task <attrib> to change file attributes on Windows systems.
  69. * MailLogger now sets the Date header correctly.
  70. * Shipped XML parser is now Xerces 2.2.1
  71. Changes from Ant 1.5.1Beta1 to 1.5.1
  72. ====================================
  73. Fixed bugs:
  74. -----------
  75. * <tstamp>'s prefix attribute failed to apply to nested <format> elements.
  76. * <junitreport> created an empty junit-noframes.html if no format had
  77. been specified.
  78. * <basename> would remove more than it should if the file name
  79. contained more than one dot.
  80. * <filterset>s nested into <filterset>s didn't work.
  81. Other changes:
  82. --------------
  83. * Shipped XML parser is now Xerces 2.2.0
  84. * Filesets now support a 'file' attribute, allowing a single-file
  85. fileset to be constructed without having to specify its parent
  86. directory separately.
  87. * <junit> will now return the result of a call to getName instead of
  88. "unknown" for Test implementations that don't extend TestCase but have
  89. a public String getName() method.
  90. Changes from Ant 1.5 to 1.5.1Beta1
  91. ==================================
  92. Fixed bugs:
  93. -----------
  94. * Date/time in CvsChangeLog was in local timezone and 12 hour format leading
  95. to a problem when sorting by time. It is now UTC (GMT) and in 24-hour
  96. format as per cvs 'specifications'.
  97. * CvsTagDiff now supports ampersand modules or modules that have a different
  98. root directory than their name.
  99. * EjbJar threw NPEs for the Websphere element. The property 'websphere.home'
  100. was not documented.
  101. * Mail example in the documentation was not correct.
  102. * Checksum was broken in the following scenario:
  103. (using verifyproperty OR in a condition) AND using filesets
  104. with multiple files.
  105. * The ExpandProperties filter threw NPEs when defined using
  106. the <filterreader> format.
  107. * The sh wrapper script didn't work under Cygwin if ANT_HOME wasn't
  108. set with a Unix style filename.
  109. * The sh wrapper script could fail if you started Ant from a directory
  110. with whitespace in its name.
  111. * ant -diagnostics was not working properly when the task dependency
  112. was missing and was just printing the missing dependency.
  113. * If a task got redefined via <taskdef>, it lost its child elements.
  114. * <property>'s classpathref attribute was broken.
  115. * <arg line="''" /> would result in no command line argument, will now
  116. be a single empty argument. Use <arg value="''"/> if you need the
  117. quotes literally.
  118. * <replaceregexp> could append a newline character at the end of the
  119. file.
  120. Other changes:
  121. --------------
  122. * Appendix E of Java Development with Ant (Loughran/Hatcher) was
  123. contributed to the docs.
  124. * <available> will only print deprecration warnings if it is actually
  125. used to change the value of a property.
  126. Changes from Ant 1.5beta3 to Ant 1.5
  127. ====================================
  128. Changes that could break older environments:
  129. --------------------------------------------
  130. * The filesetmanifest attribute added to <jar> after the 1.4.1
  131. release has been removed for now. This change may affect only
  132. the 1.5Beta/1.6Alpha users. An attempt will be made to add this
  133. feature back into Ant 1.6.
  134. Fixed bugs:
  135. -----------
  136. * <zip> and friends would always update existing archive if you set
  137. the update attribute to true.
  138. * To support backward compatibility with older versions, <pathconvert>
  139. will once again set the property, even if the result is the empty
  140. string, unless the new 'setonempty' attribute is set to false|no|off
  141. (default is "true").
  142. * The manifest task would crash XmlLogger
  143. Other changes:
  144. --------------
  145. * added **/.svn and **/.svn/** to the default excludes
  146. Changes from Ant 1.5beta2 to Ant 1.5beta3
  147. =========================================
  148. Changes that could break older environments:
  149. --------------------------------------------
  150. * Project.getBuildListeners now returns a clone of the listener
  151. list. Changes to the returned list will not affect the listeners
  152. currently attached to the Project. It also means that it is safe to
  153. iterate over the returned list if listeners are added or removed
  154. during the traversal.
  155. * <pvcs> default filenameformat has been different from Ant 1.4.1.
  156. Now it is different from 1.5beta1 and 1.5beta2.
  157. * Some messages that are printed during startup will not be
  158. written to the logfile specified via -logfile as they might destroy
  159. the format of the file for special BuildLoggers (like XmlLogger).
  160. * <pathconvert> won't set the property if the result is the empty string.
  161. Fixed bugs:
  162. -----------
  163. * <available> could fail to find files or directories that happen to
  164. start with the name of the project's basedir but are not children of
  165. the basedir.
  166. * Nested <property>'s inside <ant> can now be overriden by subsequent
  167. <ant> and <antcall> tasks.
  168. * <xslt>'s outputtype attribute wouldn't do anything.
  169. * <linecontains> filterreader could swallow lines.
  170. * <sequential> used to configure the tasks (set their attributes)
  171. before the first task has been executed. This means that properties
  172. that have been set by nested task seemed to be unset for the other
  173. tasks in the same <sequential> element.
  174. * <javac>'s sourcepath setting has been ignored by some compiler
  175. implementations.
  176. * <javadoc>'s packagelist attribute didn't work.
  177. * the plain mailer would always use port 25 in <mail>.
  178. * Ant's default logger could swallow empty lines.
  179. * ejbjar's iPlanet nested element now can process multiple descriptors.
  180. * IPlanetEjbc was looking in the wrong place for four iiop files.
  181. * <javac> would pass the -source switch to JDK 1.3's javac, even
  182. though it doesn't support it.
  183. Other changes:
  184. --------------
  185. * <checksum> now uses a buffer (of configurable size).
  186. * The "Trying to override task definition" warning has been degraded
  187. to verbose level if the two task definitions only differ in the class
  188. loader instance that has loaded the definition.
  189. * Add a jvmargs to the ejbjar's weblogic element to allow additional
  190. arguments to be provided to the VM runnign ejbc. Document the
  191. jvmdebuglevel attribute which can be used to avoid warnings about
  192. interface classess being found on the classpath. Document the new
  193. <sysproperty> element which allows JVM properties to be defined.
  194. Added an outputdir attribute to allow the destination to be a
  195. directory into which the exploded jar is written.
  196. * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
  197. Changes from Ant 1.5beta1 to Ant 1.5beta2
  198. =========================================
  199. Changes that could break older environments:
  200. --------------------------------------------
  201. * Properties will now be expanded in mail message bodies. This means
  202. that one $ sign will be stripped if your mail message contains the text
  203. $$.
  204. * org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
  205. * Available#setFile now again uses a File argument as it did in 1.4,
  206. this may break environments that have been adapted to the String
  207. argument version present in 1.5beta1.
  208. Fixed bugs:
  209. -----------
  210. * When <move> attempts a rename, it deletes the destination file, if it
  211. exists, before renaming the source file. However, <move> was not
  212. checking if the destination file was actually a directory before
  213. trying to delete it.
  214. * Make CVS Tasks to work under Cygwin.
  215. * Fix LineContains to handle huge files elegantly without causing
  216. Stack Overflows.
  217. * if you ask for the "classic" compiler on Java1.4, you get upgraded to
  218. "modern" because there is no classic compiler any more.
  219. * the <http> condition was viewing 404 'not found' exceptions as success. Now
  220. it defaults to viewing any response >=400 as an error, and has an errorsBeginAt
  221. attribute you can use if you want a higher or lower value.
  222. * <get> throws a build exception on an http authorization error, unless you
  223. have set ignoreerrors to true.
  224. * <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
  225. case, though the old spelling is retained for anyone who used it.
  226. * Merging of Manifests in jar now works as documented.
  227. * paths that have been separated by colons would be incorrectly parsed
  228. on NetWare.
  229. * runant.pl now supports NetWare.
  230. * <tempfile> and <setproxy> tasks were in beta1, but not defined by
  231. default; They now are. <tempfile> fills a property with the name of a
  232. temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
  233. settings.
  234. * <available classname="foo" ignoresystemclasses="true"> failed for
  235. JDK 1.1 and 1.2, even if the class could be found on the
  236. user-specified classpath.
  237. * <property environment=... /> now works on z/OS.
  238. * forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
  239. use a temporary file to hold the names of the files to compile under
  240. some conditons, but 1.1 doesn't support this feature. Ant will no
  241. longer try this, but you may run into problems with the length of the
  242. command line now.
  243. * the refid attribute for <property>s nested into <ant> or <param>s
  244. nested into <antcall> didn't work.
  245. * <replaceregexp> didn't work for nested <fileset>s.
  246. * <javadoc> dropped sourcepath entries if no "interesting" .java
  247. source files could be found below them. This has been backwards
  248. incompatible and caused problems with custom doclets like xdoclet.
  249. * Using the doclet, docletpath or docletpathref attributes of
  250. <javadoc> may have caused NullPointerExceptions.
  251. * nested <filesets> of <javadoc> would include too much.
  252. * <dependset> will no longer choke on <targetfileset>s that point to
  253. non-existing directories.
  254. * <patch> didn't work at all.
  255. * <replace> and <replaceregexp> now fail if the file they are working
  256. on is locked.
  257. * <javadoc> would pick up the wrong executable in the combination JDK
  258. 1.2 and AIX.
  259. Other changes:
  260. --------------
  261. * z/OS now gets detected by the os condition.
  262. * <fileset> and <dirset> now have an optional followsymlink attribute
  263. that can prevent Ant from following symbolic links on some platforms.
  264. * BeanShell is now supported in the <script> task.
  265. * <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
  266. based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
  267. this ejbc class has been deprecated. To avoid the deprecation warning use
  268. ejbcclass="weblogic.ejbc".
  269. * <ejbjar> will add a manifest to the generated jar based on the naming
  270. convention in use. This overrides the manifest specified in the
  271. <ejbjar> attribute
  272. Changes from Ant 1.4.1 to 1.5beta1
  273. ==================================
  274. Changes that could break older environments:
  275. --------------------------------------------
  276. * Important: Single $ signs are no longer silently stripped!
  277. =======
  278. * Project.getBuildListeners now returns a clone of the listener
  279. list. Changes to the returned list will not affect the listeners
  280. currently attached to the Project. It also means that it is safe to
  281. iterate over the returned list if listeners are added or removed
  282. during the traversal.
  283. * <pvcs> default filenameformat has been different from Ant 1.4.1.
  284. Now it is different from 1.5beta1 and 1.5beta2.
  285. * Some messages that are printed during startup will not be
  286. written to the logfile specified via -logfile as they might destroy
  287. the format of the file for special BuildLoggers (like XmlLogger).
  288. Fixed bugs:
  289. -----------
  290. * <available> could fail to find files or directories that happen to
  291. start with the name of the project's basedir but are not children of
  292. the basedir.
  293. * Nested <property>'s inside <ant> can now be overriden by subsequent
  294. <ant> and <antcall> tasks.
  295. * <xslt>'s outputtype attribute wouldn't do anything.
  296. * <linecontains> filterreader could swallow lines.
  297. * <sequential> used to configure the tasks (set their attributes)
  298. before the first task has been executed. This means that properties
  299. that have been set by nested task seemed to be unset for the other
  300. tasks in the same <sequential> element.
  301. * <javac>'s sourcepath setting has been ignored by some compiler
  302. implementations.
  303. * <javadoc>'s packagelist attribute didn't work.
  304. * the plain mailer would always use port 25 in <mail>.
  305. * Ant's default logger could swallow empty lines.
  306. * ejbjar's iPlanet nested element now can process multiple descriptors.
  307. * IPlanetEjbc was looking in the wrong place for four iiop files.
  308. * <javac> would pass the -source switch to JDK 1.3's javac, even
  309. though it doesn't support it.
  310. Other changes:
  311. --------------
  312. * <checksum> now uses a buffer (of configurable size).
  313. * The "Trying to override task definition" warning has been degraded
  314. to verbose level if the two task definitions only differ in the class
  315. loader instance that has loaded the definition.
  316. * Add a jvmargs to the ejbjar's weblogic element to allow additional
  317. arguments to be provided to the VM runnign ejbc. Document the
  318. jvmdebuglevel attribute which can be used to avoid warnings about
  319. interface classess being found on the classpath. Document the new
  320. <sysproperty> element which allows JVM properties to be defined.
  321. Added an outputdir attribute to allow the destination to be a
  322. directory into which the exploded jar is written.
  323. * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
  324. Changes from Ant 1.5beta1 to Ant 1.5beta2
  325. =========================================
  326. Changes that could break older environments:
  327. --------------------------------------------
  328. * Properties will now be expanded in mail message bodies. This means
  329. that one $ sign will be stripped if your mail message contains the text
  330. $$.
  331. * org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
  332. * Available#setFile now again uses a File argument as it did in 1.4,
  333. this may break environments that have been adapted to the String
  334. argument version present in 1.5beta1.
  335. Fixed bugs:
  336. -----------
  337. * When <move> attempts a rename, it deletes the destination file, if it
  338. exists, before renaming the source file. However, <move> was not
  339. checking if the destination file was actually a directory before
  340. trying to delete it.
  341. * Make CVS Tasks to work under Cygwin.
  342. * Fix LineContains to handle huge files elegantly without causing
  343. Stack Overflows.
  344. * if you ask for the "classic" compiler on Java1.4, you get upgraded to
  345. "modern" because there is no classic compiler any more.
  346. * the <http> condition was viewing 404 'not found' exceptions as success. Now
  347. it defaults to viewing any response >=400 as an error, and has an errorsBeginAt
  348. attribute you can use if you want a higher or lower value.
  349. * <get> throws a build exception on an http authorization error, unless you
  350. have set ignoreerrors to true.
  351. * <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
  352. case, though the old spelling is retained for anyone who used it.
  353. * Merging of Manifests in jar now works as documented.
  354. * paths that have been separated by colons would be incorrectly parsed
  355. on NetWare.
  356. * runant.pl now supports NetWare.
  357. * <tempfile> and <setproxy> tasks were in beta1, but not defined by
  358. default; They now are. <tempfile> fills a property with the name of a
  359. temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
  360. settings.
  361. * <available classname="foo" ignoresystemclasses="true"> failed for
  362. JDK 1.1 and 1.2, even if the class could be found on the
  363. user-specified classpath.
  364. * <property environment=... /> now works on z/OS.
  365. * forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
  366. use a temporary file to hold the names of the files to compile under
  367. some conditons, but 1.1 doesn't support this feature. Ant will no
  368. longer try this, but you may run into problems with the length of the
  369. command line now.
  370. * the refid attribute for <property>s nested into <ant> or <param>s
  371. nested into <antcall> didn't work.
  372. * <replaceregexp> didn't work for nested <fileset>s.
  373. * <javadoc> dropped sourcepath entries if no "interesting" .java
  374. source files could be found below them. This has been backwards
  375. incompatible and caused problems with custom doclets like xdoclet.
  376. * Using the doclet, docletpath or docletpathref attributes of
  377. <javadoc> may have caused NullPointerExceptions.
  378. * nested <filesets> of <javadoc> would include too much.
  379. * <dependset> will no longer choke on <targetfileset>s that point to
  380. non-existing directories.
  381. * <patch> didn't work at all.
  382. * <replace> and <replaceregexp> now fail if the file they are working
  383. on is locked.
  384. * <javadoc> would pick up the wrong executable in the combination JDK
  385. 1.2 and AIX.
  386. Other changes:
  387. --------------
  388. * z/OS now gets detected by the os condition.
  389. * <fileset> and <dirset> now have an optional followsymlink attribute
  390. that can prevent Ant from following symbolic links on some platforms.
  391. * BeanShell is now supported in the <script> task.
  392. * <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
  393. based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
  394. this ejbc class has been deprecated. To avoid the deprecation warning use
  395. ejbcclass="weblogic.ejbc".
  396. * <ejbjar> will add a manifest to the generated jar based on the naming
  397. convention in use. This overrides the manifest specified in the
  398. <ejbjar> attribute
  399. Changes from Ant 1.4.1 to 1.5beta1
  400. ==================================
  401. Changes that could break older environments:
  402. --------------------------------------------
  403. * Important: Single $ signs are no longer silently stripped!
  404. * The filesetmanifest attribute added to <jar> after the 1.4.1
  405. release has been removed for now. This change may affect only
  406. the 1.5Beta/1.6Alpha users. An attempt will be made to add this
  407. feature back into Ant 1.6.
  408. Fixed bugs:
  409. -----------
  410. * <zip> and friends would always update existing archive if you set
  411. the update attribute to true.
  412. * To support backward compatibility with older versions, <pathconvert>
  413. will once again set the property, even if the result is the empty
  414. string, unless the new 'setonempty' attribute is set to false|no|off
  415. (default is "true").
  416. * The manifest task would crash XmlLogger
  417. Other changes:
  418. --------------
  419. * added **/.svn and **/.svn/** to the default excludes
  420. Changes from Ant 1.5beta2 to Ant 1.5beta3
  421. =========================================
  422. Changes that could break older environments:
  423. --------------------------------------------
  424. * Project.getBuildListeners now returns a clone of the listener
  425. list. Changes to the returned list will not affect the listeners
  426. currently attached to the Project. It also means that it is safe to
  427. iterate over the returned list if listeners are added or removed
  428. during the traversal.
  429. * <pvcs> default filenameformat has been different from Ant 1.4.1.
  430. Now it is different from 1.5beta1 and 1.5beta2.
  431. * Some messages that are printed during startup will not be
  432. written to the logfile specified via -logfile as they might destroy
  433. the format of the file for special BuildLoggers (like XmlLogger).
  434. * <pathconvert> won't set the property if the result is the empty string.
  435. Fixed bugs:
  436. -----------
  437. * <available> could fail to find files or directories that happen to
  438. start with the name of the project's basedir but are not children of
  439. the basedir.
  440. * Nested <property>'s inside <ant> can now be overriden by subsequent
  441. <ant> and <antcall> tasks.
  442. * <xslt>'s outputtype attribute wouldn't do anything.
  443. * <linecontains> filterreader could swallow lines.
  444. * <sequential> used to configure the tasks (set their attributes)
  445. before the first task has been executed. This means that properties
  446. that have been set by nested task seemed to be unset for the other
  447. tasks in the same <sequential> element.
  448. * <javac>'s sourcepath setting has been ignored by some compiler
  449. implementations.
  450. * <javadoc>'s packagelist attribute didn't work.
  451. * the plain mailer would always use port 25 in <mail>.
  452. * Ant's default logger could swallow empty lines.
  453. * ejbjar's iPlanet nested element now can process multiple descriptors.
  454. * IPlanetEjbc was looking in the wrong place for four iiop files.
  455. * <javac> would pass the -source switch to JDK 1.3's javac, even
  456. though it doesn't support it.
  457. Other changes:
  458. --------------
  459. * <checksum> now uses a buffer (of configurable size).
  460. * The "Trying to override task definition" warning has been degraded
  461. to verbose level if the two task definitions only differ in the class
  462. loader instance that has loaded the definition.
  463. * Add a jvmargs to the ejbjar's weblogic element to allow additional
  464. arguments to be provided to the VM runnign ejbc. Document the
  465. jvmdebuglevel attribute which can be used to avoid warnings about
  466. interface classess being found on the classpath. Document the new
  467. <sysproperty> element which allows JVM properties to be defined.
  468. Added an outputdir attribute to allow the destination to be a
  469. directory into which the exploded jar is written.
  470. * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
  471. Changes from Ant 1.5beta1 to Ant 1.5beta2
  472. =========================================
  473. Changes that could break older environments:
  474. --------------------------------------------
  475. * Properties will now be expanded in mail message bodies. This means
  476. that one $ sign will be stripped if your mail message contains the text
  477. $$.
  478. * org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
  479. * Available#setFile now again uses a File argument as it did in 1.4,
  480. this may break environments that have been adapted to the String
  481. argument version present in 1.5beta1.
  482. Fixed bugs:
  483. -----------
  484. * When <move> attempts a rename, it deletes the destination file, if it
  485. exists, before renaming the source file. However, <move> was not
  486. checking if the destination file was actually a directory before
  487. trying to delete it.
  488. * Make CVS Tasks to work under Cygwin.
  489. * Fix LineContains to handle huge files elegantly without causing
  490. Stack Overflows.
  491. * if you ask for the "classic" compiler on Java1.4, you get upgraded to
  492. "modern" because there is no classic compiler any more.
  493. * the <http> condition was viewing 404 'not found' exceptions as success. Now
  494. it defaults to viewing any response >=400 as an error, and has an errorsBeginAt
  495. attribute you can use if you want a higher or lower value.
  496. * <get> throws a build exception on an http authorization error, unless you
  497. have set ignoreerrors to true.
  498. * <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
  499. case, though the old spelling is retained for anyone who used it.
  500. * Merging of Manifests in jar now works as documented.
  501. * paths that have been separated by colons would be incorrectly parsed
  502. on NetWare.
  503. * runant.pl now supports NetWare.
  504. * <tempfile> and <setproxy> tasks were in beta1, but not defined by
  505. default; They now are. <tempfile> fills a property with the name of a
  506. temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
  507. settings.
  508. * <available classname="foo" ignoresystemclasses="true"> failed for
  509. JDK 1.1 and 1.2, even if the class could be found on the
  510. user-specified classpath.
  511. * <property environment=... /> now works on z/OS.
  512. * forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
  513. use a temporary file to hold the names of the files to compile under
  514. some conditons, but 1.1 doesn't support this feature. Ant will no
  515. longer try this, but you may run into problems with the length of the
  516. command line now.
  517. * the refid attribute for <property>s nested into <ant> or <param>s
  518. nested into <antcall> didn't work.
  519. * <replaceregexp> didn't work for nested <fileset>s.
  520. * <javadoc> dropped sourcepath entries if no "interesting" .java
  521. source files could be found below them. This has been backwards
  522. incompatible and caused problems with custom doclets like xdoclet.
  523. * Using the doclet, docletpath or docletpathref attributes of
  524. <javadoc> may have caused NullPointerExceptions.
  525. * nested <filesets> of <javadoc> would include too much.
  526. * <dependset> will no longer choke on <targetfileset>s that point to
  527. non-existing directories.
  528. * <patch> didn't work at all.
  529. * <replace> and <replaceregexp> now fail if the file they are working
  530. on is locked.
  531. * <javadoc> would pick up the wrong executable in the combination JDK
  532. 1.2 and AIX.
  533. Other changes:
  534. --------------
  535. * z/OS now gets detected by the os condition.
  536. * <fileset> and <dirset> now have an optional followsymlink attribute
  537. that can prevent Ant from following symbolic links on some platforms.
  538. * BeanShell is now supported in the <script> task.
  539. * <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
  540. based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
  541. this ejbc class has been deprecated. To avoid the deprecation warning use
  542. ejbcclass="weblogic.ejbc".
  543. * <ejbjar> will add a manifest to the generated jar based on the naming
  544. convention in use. This overrides the manifest specified in the
  545. <ejbjar> attribute
  546. Changes from Ant 1.4.1 to 1.5beta1
  547. ==================================
  548. Changes that could break older environments:
  549. --------------------------------------------
  550. * Important: Single $ signs are no longer silently stripped!
  551. Before you panic that we have broken all your build files, we have kept
  552. the old "$$" -> "$" behaviour. So only build files which accidentally had
  553. a $ sign in a string that was being silently stripped may break.
  554. We added this fix to stop newbie confusion; if you want to write a
  555. build file which works on ant versions 1.4.1 or earlier, stay with
  556. the double $$ sign rule.
  557. * Shipped XML parser is now Xerces 2.0.1 along with the XML Parser APIs.
  558. XML Parser APIs is a separate jar that contains the necessary
  559. JAXP/DOM/SAX classes.
  560. * <telnet> was fixed to expand properties inside nested <read> and
  561. <write> elements; before this only happened when you assigned the text
  562. to the string attribute. If you had $ signs in the string, they may
  563. need escaping.
  564. * the RegexpMatcher interface has been extended to support case
  565. insensitive matches and other options - custom implementations of
  566. this interface won't work any longer. We recommend to use the new
  567. Regexp interface that also supports substitution instead of the
  568. RegexpMatcher interface in the future.
  569. * <gzip> will throw an exception if your src attribute points to a directory.
  570. * Unjar, Unzip and Unwar will throw an exception if the Src attribute
  571. represents a directory. Support for nested filesets is provided
  572. instead.
  573. * It is no longer possible to overwrite a property using tasks like
  574. <condition>, <exec>, <pathconvert>, or <tstamp>. In some exceptional
  575. cases it will generate a warning if you attempt to overwrite an
  576. existing property.
  577. * Taskwriters please note: Whenever tasks had any overloaded set* methods,
  578. Ant's introspection mechanism would select the last overloaded method
  579. provided to it by the Java Runtime. A modification has now been made such
  580. that when the Java Runtime provides a method with a String as its argument,
  581. a check is made to see if there is another overloaded method that takes in
  582. some other type of argument. If there is one such method, then the method
  583. that takes in String as an argument is not selected by the Introspector.
  584. * The pattern definition **/._* has been included into the Default
  585. Excludes list.
  586. * <propertyfile>'s <entry> element was modified to remove "never" as a value
  587. as its behavior was undocumented and flakey.
  588. * The -projecthelp flag now only prints out targets that include the
  589. 'description' attribute, unless the -verbose or -debug flag is included
  590. on the Ant command line.
  591. * Ant's testcases now require JUnit 3.7 or above, as they now use the new
  592. assertTrue method instead of assert.
  593. * If the 'output' attribute of <ant> is set to a simple filename or a
  594. relative path, the file is created relative to ${basedir}, not ${user.dir}.
  595. * The default value for build.compiler is now javac1.x with x
  596. depending on the JDK that is running Ant instead of classic/modern.
  597. Fixed bugs:
  598. -----------
  599. * A bug existed that prevented generated log files from being deleted as
  600. part of the build process itself. This has now been fixed.
  601. * Fixed bug where <move> ignored <filterset>s.
  602. * Ant works properly with the combination of Java1.4/WindowsXP.
  603. * Fixed bug where <java> used to sometimes invoke class constructors twice.
  604. * Fixed bug with 4NT shell support.
  605. * Fixed bug where ant would not perform ftp without remotedir being
  606. specified even though this was not mandatory.
  607. * Fixed bug where ant would not copy system properties into new Project
  608. in ant/antcall tasks when inheritall="false" is set.
  609. * <propertyfile> would not close the original property file.
  610. * <ant> will no longer override a subbuild's basedir with inheritall="true".
  611. * Fixed problem with the built-in <junit> formatters which assumed
  612. that only one test could be running at the same time - this is not
  613. necessarily true, see junit.extensions.ActiveTestSuite.
  614. * <jar>'s whenEmpty attribute is useless as JARs are never empty, they
  615. contain at least a manifest file, therefore it will now print a
  616. warning and do nothing.
  617. * <typedef> hasn't been all that useful as it couldn't be used outside
  618. of targets (it can now) and nested "unknown" elements have always
  619. been considered to be tasks (changed as well).
  620. * <fixcrlf> would fail for files that contained lines longer than 8kB.
  621. * Some junit formatters incorrectly assumed that all testcases would
  622. inherit from junit.framework.TestCase.
  623. * <fixcrlf> dropped the first characters from Mac files.
  624. Other changes:
  625. --------------
  626. * Selector Elements now provide a way to create filesets based on
  627. sophisticated selection criteria.
  628. * Gzip and Bzip2 files can now be constructed in the fly when using
  629. the tar task without having to create the intermediate tar file on
  630. disk. The Untar task can also untar GZip and BZip2 files on the fly
  631. without creating the intermediate tar file.
  632. * New optional type, <classfileset> added.
  633. * <ejbjar> now allows control over which additional classes and interfaces
  634. are added to the generated EJB jars. A new attribute "dependency" can be
  635. defined which controls what classes are added. The addition of classes now uses
  636. the Jakarta-BCEL library rather than reflection, meaning bean classes are
  637. no longer loaded into Ant's JVM. The default dependency analyzer is known as
  638. the ancestor analyzer. It provides the same behaviour as the 1.4.1 version of
  639. <ejbjar>. If the BCEL library is not present, a warning will be issued stating
  640. the ancestor analyzer is not available. In this case <ejbjar> will continue
  641. to function but will not add super classes to the jar.
  642. * <available> has a new attribute named ignoreSystemClasses.
  643. * New task <cvschangelog/> generates an XML report of changes that occur
  644. on CVS repository.
  645. * New filter readers: ClassConstants, ExpandProperties, HeadFilter,
  646. LineContains, LineContainsRegExp, PrefixLines, ReplaceTokens,
  647. StripJavaComments, StripLineBreaks, StripLineComments, TabsToSpaces,
  648. TailFilter.
  649. * <copy>, <loadfile>, <loadproperties>, <move> support FilterChains
  650. of FilterReaders.
  651. * New task <loadproperties> to load contents of file as Ant properties,
  652. with nested <filterchain> elements.
  653. * New task <loadfile> to load a whole file into a property.
  654. * New task <echoproperties> to list your current properties to the screen
  655. or a file.
  656. * New tasks <bzip2> and <bunzip2> to pack and unpack files using the
  657. BZip2 alogrithm.
  658. * New tasks <replaceregexp>, <checksum>, <translate>, <waitfor>,
  659. <manifest>, <vsscp>, <vssadd>, <vsscreate>, <splash>, <basename>, <dirname>,
  660. <concat>, <sourceoffsite>, <jarlib-available>, <jarlib-display>,
  661. <jarlib-manifest>, <jarlib-resolve>.
  662. * A new combined <mail> task, which replaces the old <mail> and
  663. <mimemail> tasks, has been added. The <mimemail> task, and
  664. old SendEmail and MimeMail classes have been deprecated.
  665. * Mail task allows specification of port number.
  666. * Users can control what <zip> and <jar> must do when duplicate files
  667. are found. A new element <zipgroupfileset> allows for multiple zip
  668. files to be merged into the archive. In addition, <jar> also has
  669. another new attribute: filesetmanifest. The existing manifest
  670. attribute of <jar> now also accepts the name of a jar added through
  671. a fileset.
  672. * gzip now checks that the zipfile is older than the source file
  673. before rebuilding the zipfile.
  674. * TarFileset takes in three new attributes - fullpath, prefix
  675. and preserveLeadingSlashes.
  676. * <move> attempts to rename the directory, if everything inside it is
  677. included, before performing file-by-file moves. This attempt will
  678. be done only if filtering is off and if mappers are not used. This
  679. is a performance improvement and there is no change otherwise in
  680. the funtionality of this task.
  681. * Exec task has extra attribute "resultproperty" to get the return code
  682. into a property.
  683. * Exec task prints a message when a timed-out process is killed.
  684. * Added optional attributes - name, arch and version to the <os> task.
  685. * Unjar, Untar, Unwar and Unzip now support patternsets to
  686. select files from an archive for extraction. Filesets may be
  687. used to select archived files for unarchival.
  688. * Javac task allows debug levels to be specified. Debug levels
  689. will have an effect only when the modern compiler or the
  690. classic compiler (version 1.2 and higher) is used and debugging
  691. is enabled.
  692. * Added support for specifying CVS_RSH in the <cvs/> task
  693. * The attributes zipfile, jarfile, warfile and earfile (from the Zip,
  694. Jar, War and Ear tasks) have been deprecated and superseded by a
  695. new attribute "destfile".
  696. * Added new conditions <isset>, <checksum>, <http>, <socket>, <contains>,
  697. <filesmatch>.
  698. * <taskdef> and <typedef> will now emit a warning if a task/type of
  699. the given name already exists.
  700. * A new revision of VAJ tasks: The most important new feature
  701. is the ability to execute VAJ tasks from the command line by
  702. exploiting the Remote Tool Access feature of VAJ.
  703. * Improved support for Novell NetWare.
  704. * Added an optional encoding attribute to <fixcrlf>.
  705. * <apply> has a new attribute relative that allows users to pass the
  706. filenames as relative instead of absolute paths on the command line.
  707. * References can now be copied into the child build by <ant> and
  708. <antcall> using nested <reference> elements or the new inheritRefs
  709. attribute.
  710. * <fail> now supports builds to fail based on conditions via if and
  711. unless attributes.
  712. * Ant now comes with two new BuildLogger implementations - one that
  713. can send emails containing a log of the build process (MailLogger),
  714. and one that colorizes the output based on message levels, using
  715. ANSI color code escape sequences (AnsiColorLogger).
  716. * A "package" mapper type has been added to allow package directory
  717. names replaced with the dotted form.
  718. * You can now specify environment variables in the <java> and <junit> tasks
  719. if the fork attribute has been set to true.
  720. * -propertyfile command-line option has been added to load an entire
  721. property file just as -D properties are declared (as user properties).
  722. -D properties take precedence over -propertyfile specified ones.
  723. * You can now set an ANT_ARGS environment variable to hold arguments you
  724. always want passed to the 'ant' command -- for example, if you always
  725. want to use a different logger or the -find flag.
  726. * <tstamp> now supports a new "prefix" attribute to prefix properties set.
  727. * You can now specify the -sourcepath for <javac> explicitly.
  728. * <javac> now supports a new "listfiles" attribute to list the source
  729. files it's handing off to the compiler.
  730. * The compiler implementation for <javac> can now be chosen on a task by
  731. task basis. The new "compiler" attribute of <javac> can be used to override
  732. the value of the build.compiler property, if set.
  733. * <javac> has a new nested element, <compilerarg>, which allows you
  734. to specify additional args for the specific compiler you're using.
  735. * <javac>'s "source" attribute is now enabled for jikes as well.
  736. * <propertyfile>'s <entry> now has a 'unit' attribute to specify the
  737. increment/decrement unit on date operations.
  738. * <property> now supports a 'prefix' attribute when loading from a file
  739. or resource.
  740. * In Ant 1.4, a feature has been added to the <junit> task that would
  741. add ant.jar, optional.jar and junit.jar implicitly to the classpath -
  742. this feature can now be disabled by setting the new includeantruntime
  743. attribute to false.
  744. * <style> behaves differently from any other directory-based task, as it
  745. processes all files that it finds in included directories in
  746. addition to the files matched by your patterns. There is now a new
  747. attribute, 'scanincludeddirectories', to suppress this behavior.
  748. * <javadoc> now supports a <tag> nested element to provide the -tag option
  749. to the standard Java 1.4 doclet. The element is ignored when not running
  750. on Java 1.4.
  751. * <ftp> can now chmod files on a remote server that supports
  752. "site chmod", as well as set the umask before transferring files, if
  753. the server supports "site umask".
  754. * New <serverdeploy> "optional" task.
  755. * <patternset> now supports nested patternsets.
  756. * Perforce tasks now support a "failonerror" attribute (defaults to "true").
  757. * Open Source application server JOnAS support:
  758. EJB hot deploy and deploy with <serverdeploy> and <ejbjar>
  759. * Added new DirSet (<dirset>) datatype.
  760. * <path> now supports nested <dirset> and <filelist> elements.
  761. * <pathconvert> now supports nested <dirset> and <filelist> elements.
  762. * <pathconvert>'s "dirsep" and "pathsep" attributes now accept
  763. multi-character values.
  764. * <copy> task now has a 'failonerror' attribute to allow keep-going
  765. behaviour when the file to be copied is not found (defaults to "true").
  766. * <uptodate> now has a 'srcfile' attribute to allow specifying a
  767. full-path filename.
  768. * <exec>, <sql> and <java> now support append attributes to allow
  769. appending the output to an existing file.
  770. * <java> now supports a timeout attribute analog to <exec> - it is
  771. highly recommended to only use it together with fork="true".
  772. * <javadoc> now supports a source attribute to enable javadoc to
  773. handle assertions present in JDK 1.4 source code.
  774. * <replace> supports a new replacefilterfile attribute that
  775. automatically turns all properties of a given file into
  776. replacefilters.
  777. * An alias of <xslt> has been added to refer to the <style> task.
  778. * The compiler implementation for <rmic> can now be chosen on a task by
  779. task basis. The new "compiler" attribute of <rmic> can be used to override
  780. the value of the build.rmic property, if set.
  781. * <rmic> has a new nested element, <compilerarg>, which allows you
  782. to specify additional args for the specific compiler you're using.
  783. * org.apache.tools.ant.XmlLogger now is a BuildLogger, rather than just
  784. a BuildListener. It can operate in either mode successfully.
  785. * <junit> has a new attribute "showoutput". If set to true, output
  786. generated by tests will be sent to Ant's logging system as well as
  787. to the formatters (instead of sending it to the formatters
  788. exclusively).
  789. * Ant has now a pluggable way to prompt users for input, which is used
  790. by the new <input> task. IDE integrators can provide an
  791. implementation of the InputHandler interface to decouple Ant's input
  792. from the console. An implementation that gets its input from a file
  793. for unattended builds is part of Ant's distribution.
  794. For more details see docs/manual/inputhandler.html.
  795. * <patch> has a new attribute that selects the directory in which to
  796. run the command.
  797. * <javadoc> now supports two new nested elements, <fileset> and <packageset>.
  798. Changes from Ant 1.4 to Ant 1.4.1
  799. ===========================================
  800. Fixed bugs:
  801. -----------
  802. * <ant>'s antfile attribute will now also be considered an absolute path on
  803. Windows systems, if it starts with a \ and no drive specifier.
  804. * The fullpath attribute of <zipfileset> has been ignored if you used
  805. the src attribute at the same time.
  806. * The manifest file is now always placed as the second entry (after /META-INF)
  807. in generated jars. This allows the manifest to be read by JarInputStreams
  808. * Fixed bug in depend task which would fail with a NullPointerException if no
  809. dependency cache was specified.
  810. * sql task now handles REM statements correctly so that lines starying with rem
  811. but which are not comments are actually processed.
  812. * XMLLogger now uses the task's name rather than the classname
  813. * <mapper>s will now work as expected if the to pattern expands to an
  814. absolute pathname.
  815. * <javac> didn't ignore memory settings in non-fork mode
  816. * <cab> didn't split the options attribute into several command line
  817. arguments correctly.
  818. Other changes:
  819. --------------
  820. * New source attribute for <javac> to enable assertion in JDK 1.4
  821. * XmlLogger and <antstructure> now add an encoding declaration to the
  822. XML files they generate.
  823. * <fileset> has a new attribute "casesensitive" to make it match
  824. filenames in a case insensitive way (if you set it to false) - by
  825. default filesets remain case sensitive.
  826. Changes from Ant 1.3 to Ant 1.4
  827. ===========================================
  828. Changes that could break older environments:
  829. --------------------------------------------
  830. * JUnitReport now uses the xalan redirect extension for multi-output.
  831. With Xalan 1.2.2 it forces the use of bsf.jar in the classpath.
  832. (Available in the xalan distribution). It is recommended to switch
  833. to Xalan 2.x that do not need it.
  834. * Zip.setWhenempty() has changed its signature.
  835. * <rmic> is now implemented using a factory. This makes extending
  836. rmic to use a new compiler a lot easier but may break custom
  837. versions of this task that rely on the old implementation.
  838. * several Zip methods have changed their signature as we now use a Zip
  839. package of our own that handles Unix permissions for directories.
  840. Furthermore <zip> will now use the platform's default character
  841. encoding for filenames - this is consistent with the command line
  842. ZIP tools, but causes problems if you try to open them from within
  843. Java and your filenames contain non US-ASCII characters. Use the new
  844. encoding attribute of the task and set it to UTF8 to get the old
  845. behavior.
  846. * The <pvcs> task has been moved to a package of its own.
  847. * JUnitResultFormater has two additional methods that must be
  848. implemented by custom formatters.
  849. * Ant will no longer use the canonical version of a path internally -
  850. this may yield different results on filesystems that support
  851. symbolic links.
  852. * The output generated by the xml formatter for <junit> has changed
  853. again, it doesn't format the numeric value in the time attribute anymore.
  854. * Pattern matching rules have changes slightly, the pattern foo*
  855. doesn't match files contained in a directory named foo - use foo/*
  856. instead.
  857. * <fixcrlf> will not remove trailing whitespace at the end of lines anymore.
  858. * The Classloader usage has been changed for the taskdef, property, available
  859. and sql tasks so that it delegates to the parent classloader. This may cause
  860. ClassNotFoundExceptions to be thrown if a system class attempts to load a
  861. class in the taskdef's classpath (typically factory objects).
  862. * Ant now allows multithreading of tasks and the containment of tasks within
  863. other tasks. This can break customer listeners which do not expect messages
  864. from a task before the previous task has finished.
  865. * Ant now installs its own ouput stream into System.out to route output to the
  866. task currently executing on the current thread. This also means that all
  867. output is now routed as Ant message events. Customer listeners and loggers
  868. should not call System.out at any time. This has always been true but such
  869. usage now will cause problems due to possible recursion.
  870. * Invalid manifest files will now cause build failures in the <jar> task.
  871. * Ant Introspection now looks for methods with method names starting with
  872. addConfigured. When called these methods are passed an argument after it has
  873. been configured from the build file. Custom tasks supporting nested elements
  874. starting with the name configured will no longer function.
  875. * The environment variable JAVACMD that can be used to specify the
  876. java executable to Ant's wrapper scripts must not contain additional
  877. command line parameters any longer - please use the environment
  878. variable ANT_OPTS for such parameters now.
  879. * Ant's wrapper scripts now quote the CLASSPATH environment variable, thus
  880. supporting classpaths which refer to directories containing spaces. This means
  881. that the CLASSPATH environment variable cannot have quotes. Any quotes should
  882. be removed. This will not affect the operation of the CLASSPATH environment
  883. variable in other contexts.
  884. * A delete task like
  885. <delete includeEmptyFilesets="true">
  886. <fileset dir="somedir" />
  887. </delete>
  888. will now remove "somedir" as well, unless there are still files left
  889. in it (matched by the default excludes).
  890. * The copy task will now fail if the file to be copied is not found.
  891. * Ant properties defined in properties files now behave the same way as
  892. properties defined in the build file. In particular the $ character needs
  893. to be escaped in property values by doubling it to $$. So, to define a
  894. property with the value $hello, you need to define it in a properties file
  895. as
  896. test.prop=$$hello
  897. This was not the case in Ant 1.3
  898. Other changes:
  899. --------------
  900. * New tasks: ear, p4counter, record, cvspass, vsscheckin, vsscheckout,
  901. typedef, sleep, mimemail, set of tasks for Continuus/Synergy, dependset,
  902. condition, maudit, mmetrics, jpcoverage, jpcovreport, jpcovmerge
  903. * Ant now uses JAXP 1.1
  904. * rmic now supports Kaffe's and Weblogic's version of rmic.
  905. * new magic property build.rmic to chose the rmic implementation
  906. * <tar> will now add empty directories as well
  907. * you can now specify a description for <p4change>
  908. * <touch> can now work on <fileset>s
  909. * <uptodate> now supports a value attribute
  910. * <fail> supports nested text
  911. * <fixcrlf> won't override files that are already in the correct
  912. format.
  913. * <sql> now supports REM comments as well as // and --
  914. * <jar> now has a nested <metainf> element following the same idea as
  915. <war>'s <webinf>.
  916. * <pvcs> can now handle multiple projects.
  917. * <available> now has a "type" attribute you can use in conjunction
  918. with the "file" attribute to specify whether the "file" you're
  919. looking for is a file or a directory.
  920. * New <junit> formatter named "brief"
  921. * <ejbjar> changes
  922. * Add support for Borland Application Server to the <ejbjar> task using
  923. a <borland> nested element.
  924. * Add support for iPlanet Application Server to the <ejbjar> task. Also
  925. includes some iPlanet utility tasks
  926. * Add support for JBoss Application Server to the <ejbjar> task.
  927. * Add a naming attribute to control the naming scheme that
  928. ejbjar uses to name the generated EJB jars.
  929. * Weblogic element now sets the compiler class for EJB 2.0 beans
  930. * <dtd> elements can be specified at the <ejbjar> level for building generic
  931. beans
  932. * <dtd> elements can now be URLs
  933. * Allow the manifest to be specified for the generated jars
  934. * The weblogic element now supprts an attribte noEJBC to skip the processing
  935. of the jar by ejbc. The ejbc step will then occur at deployment
  936. * weblogic will tell ejbc to use Jikes compiler if build.compiler is set to
  937. jikes. It can be restored to the default, javac, operation if desired.
  938. * Allow the <sql> Delimiter to be set in the so that Oracle stored procs may be
  939. entered
  940. * <execon> and <apply> can now optionally skip empty filesets.
  941. * <javadoc> has a new useexternalfile attribute that makes it use a
  942. temporary file for sourcefile and package names - helps to defeat
  943. command line length limitations.
  944. * Data types like <path> can now be defined inside of <target>s
  945. * you can now specify a classpath for <style> - the XSLZ processor
  946. will be loaded from this path
  947. * added a force attribute to <style> to support dependencies that the
  948. task cannot determine itself (dependency on parameters, not file
  949. modification times for example)
  950. * added vmlauncher attribute to exec tasks. This defaults to true. If
  951. it is set to false, the VM's ability to launch commands in bypassed
  952. and the OS shell, either directly or through the auxillary antRun
  953. scripts is used.
  954. * regexp mapper now supports the java.util.regex package of JDK 1.4.
  955. * New filesonly attribute for <zip> and friends to suppress directory
  956. entries.
  957. * New update attribute for <zip> and friends - update an existing
  958. archive instead of creating a new one.
  959. * <apply> and <execon> have been merged into a single task.
  960. * added vssver.scc to the default excludes
  961. * <available> has a new filepath attribute/nested element that allows
  962. you top search for a file in a given path.
  963. * <junit> can now optionally set a property on test failure.
  964. * <taskdef> can now define several tasks at once, reading the
  965. name/classname pairs from a property file or resource.
  966. * <unzip/unjar/unwar> and <untar> now have an overwrite attribute that
  967. defaults to true. If set to false, files that are newer than the
  968. files in the archive will not be replaced.
  969. * <patternset> and <fileset> now support nested <in/excludesfile>
  970. elements - using these you can have more than one in/excludes file
  971. per <patternset>.
  972. * Three new supported compilers for javac: kjc for kopi, gcj for the
  973. gcc frontend and sj for Symantec's compiler.
  974. In addition extJavac or the new fork attribute can be
  975. used to run the JDK's javac in a JVM separate from Ant.
  976. * <fixrlf> can now with CR only line-ends and can use an arbitraty
  977. between 2 and 80.
  978. * The .NET tasks have been adapted to the beta2 release of the framework.
  979. * <move> will now try to rename() files before copying them byte by
  980. byte - only if filtering is of, of course.
  981. * <ant> and <antcall> tasks now support a new attribute inheritAll. When set to
  982. false, only user properties are passed through to the target Ant instance.
  983. This includes properties set on the command line and properties explicitly
  984. passed
  985. * <javadoc> now skips off line links if the package list cannot be found.
  986. * <wlrun> now allows the security policy file to exist outside the weblogic
  987. directory.
  988. * <java> task will set the Thread contextClassLoader under JDKs 1.2+ to the
  989. classloader for the class being executed.
  990. * Introduce the concept of a TaskContainer - a task or element which can contain
  991. Ant Tasks.
  992. * Add new tasks implementing the TaskContainer interface <parallel> and
  993. <sequential> which allow parallel execution of tasks to be specified.
  994. * <depend> task will now take into account dependencies on jar files and class
  995. files from a given classpath.
  996. * <jar> manifest entries may now be specified in the build file either
  997. completely or to be merged with a manifest file.
  998. * <tstamp> task custom formats now support locales.
  999. * Added a listner which will forward events to Log4J. The log4j configuration
  1000. file should be in the directory from which Ant is run or passed as a system
  1001. property using a JVM argument.
  1002. * Introduced the concept of <filtersets> to allow for more control in which
  1003. filters get applied in a <copy> or <move> operation.
  1004. * Added nowarn attribute to javac and deprecated the Jikes-magic property
  1005. build.compiler.warnings.
  1006. * The <depend> task cache format has changed and all dependency information is
  1007. now stored in a single file.
  1008. Fixed bugs:
  1009. -----------
  1010. * Testcases have been made independent of current working directory.
  1011. * Input ZIP-Files will be closed when using a <zipfileset>.
  1012. * p4 tasks now don't fail if user, port or client have been omitted
  1013. (and this is acceptable for the context of the command).
  1014. * <javah>'s outputfile attribute will be resolved as relative to the
  1015. projects basedir.
  1016. * <antstructure> should create a valid DTD for propertyfile.operation.entry
  1017. and omit tasks it fails to load.
  1018. * won't try to pass a -bootclasspath flag to javac 1.1 anymore
  1019. * <style>'s style attribute no handles absolute paths correctly.
  1020. * <delete includeemptydirs="true"> now deletes more than just the leaf
  1021. directories.
  1022. * You can now specify a <fileset> for a directory that doesn't exist at
  1023. declaration time but will created before the fileset gets used for the
  1024. first time.
  1025. * If the quiet attribute has been set, <delete> will handle <fileset>s
  1026. with non-existing directories gracefully.
  1027. * Output written by testcases will now be captured by the <junit> task
  1028. and passed to the formatters.
  1029. * Quote the -group parameter to Javadoc as per the specification
  1030. * Initialise classes when loaded through the AntClassLoader - that is, run
  1031. static initializers
  1032. * Implement getResource() and getResources() in AntClassLoader
  1033. * Create the <ejbjar> weblogic command line as a set of arguments rather than
  1034. as a single line. Avoids problems with paths which contain spaces.
  1035. * <ejbjar> now fails when the weblogic ejbc compiler reports an error.
  1036. * Make the AntClassLoader load resources in the same order as it currently
  1037. loads classes.
  1038. * Handle classpaths with spaces
  1039. * Make sure XSLT processors close their output files in <style>.
  1040. * perform proper uptodate check in <rmic> when compiling for IIOP.
  1041. * <jjtree>'s uptodate test works even if outputdirectory is not the
  1042. parent dir of target
  1043. * <copy> will remove target file (if it exists) before writing to it -
  1044. this avoids problems with links on filesystems that support them.
  1045. * <ftp> now properly recurses remote directories.
  1046. * <ftp> closes remote connection when it's done.
  1047. * <junit> tries to include all necessary classes for the task itself
  1048. to the classpath when running in fork mode - doesn't work for JDK 1.1
  1049. * <apply> and <execon> do now execute the command only once, if you
  1050. specify the parallel attribute - instead of once per fileset.
  1051. * directory based tasks and fileset could miss some included files in
  1052. directories that have been excluded
  1053. * <fixcrlf> failed for large files.
  1054. * <move> removed files you tried to move to themselves.
  1055. * <sql> task will not trty to print the result set unless the query succeeded.
  1056. * Ant classloader will now ignore paths which are invalid relative to the
  1057. project base
  1058. * <ejbjar> weblogic elements check for jar file changes has been fixed.
  1059. Previously some changes would not be included.
  1060. * properties loaded from properties files are now resolved internally. This
  1061. removes the spurious warnings about usage of properties which have not been
  1062. set.
  1063. * <jar> task and friends now process the JAR manifest to ensure it is valid.
  1064. * The task finished event now includes any exception thrown by the task.
  1065. * <java> task now supports a jvmVersion attribute so that if another JVM is
  1066. being used, Ant can determine which options to use for features such as the
  1067. VM memory limits
  1068. Changes from Ant 1.2 to Ant 1.3
  1069. ===========================================
  1070. Changes that could break older environments:
  1071. --------------------------------------------
  1072. * Ant doesn't search for the buildfile anymore, unless you use the new
  1073. -find argument.
  1074. * <perforce> has been replaced by a number of new tasks.
  1075. * <javac> is now implemented using a factory. This makes extending
  1076. javac to use a new compiler a lot easier but may break custom
  1077. versions of this task that rely on the old implementation.
  1078. * The output generated by the xml formatter for <junit> has changed a
  1079. little, it doesn't append " sec" in the time attribute anymore.
  1080. Other changes:
  1081. --------------
  1082. * A GUI Frontend: Antidote. This is currently in development. At this
  1083. time, this is not part of the Ant release, although the source is
  1084. included if you are interested.
  1085. * New tasks: stylebook, propertyfile, depend, antlr, telnet, csc,
  1086. ilasm, apply, javah, several clearcase tasks, junitreport, sound
  1087. * Added output attribute to <java>.
  1088. * Added nested zipfileset element to <zip>
  1089. * Changed <sql> so that printing is at the task level rather than
  1090. the statement level.
  1091. * javadoc task will pass -d flag to any doclet if the destDir attribute is
  1092. given. If the doclet does not accept the -d flag then omit the destdir
  1093. attribute.
  1094. * <cab> can work on non-Windows platforms with the help of libcabinet.
  1095. See http://trill.cis.fordham.edu/~barbacha/cabinet_library/.
  1096. * <ftp> now supports passive mode.
  1097. * New <mapper> data type that can be used to get influence on the
  1098. target files for some tasks like <copy> or enable new types of tasks
  1099. like <apply>.
  1100. * <execon> provides more control over the command line now, the names
  1101. of the source files are no longer required to be at the end of the
  1102. command.
  1103. * Style tasks will now support TraX compliant XSL processors if one is present
  1104. in your classpath.
  1105. * Added a failonerror to the javac task. If set to false, the build will
  1106. continue even if there are compilation errors.
  1107. * Added nested format elements to the tstamp task allowing additional time
  1108. formats to be defined for arbitrary properties.
  1109. * Added classpath attribute and nested classpath element to <property>
  1110. to make the resource attribute more powerful.
  1111. * ${} property expansion will now be performed on the patterns read
  1112. from files specified as includesfile or excludesfile attributes.
  1113. * The <tar> and <untar> tasks now support GNU format for handling paths
  1114. which are greater than 100 characters in length. In addition the <tar>
  1115. task now supports nested filesets through which the file permissions
  1116. may be controlled.
  1117. * wlrun, wlstop and ejbjar now support Weblogic 6.0
  1118. * The MPasre task has been updated to work with MParse 2.0
  1119. * The documentation has been significantly updated.
  1120. Fixed bugs:
  1121. -----------
  1122. * <signjar> doesn't use deprectated methods anymore.
  1123. * javadoc's failonerror attribute works again
  1124. * javadoc's additionalparam attribute will now be split into separate
  1125. parameters (on spaces) to allow for more than one parameter.
  1126. * Changed <sql> task so that printing result sets works on Oracle
  1127. * Changes to ddcreator and ejbc helper to respect the descriptor hierarchy
  1128. keppgenerated in ejbc can now be turned off
  1129. * ejbjar now correctly ignores <ejb-ref> elements in the deployment descriptor.
  1130. CMP files are included by parsing the weblogic deployment descriptor rather
  1131. than relying on the naming convention used in ant 1.2
  1132. * ejbjar includes super classes and super interfaces into the generated ejb
  1133. jar files. The <support> nested element allows support classes to be
  1134. included in the EJB jar. The toplink element should now correctly locate
  1135. the toplink descriptor.
  1136. * <vssget> now correctly deals with spaces in arguments
  1137. * <jar> fails early if a given manifest file doesn't exist
  1138. * <rmic> doesn't search for the _Skel file anymore when stubversion is
  1139. set to 1.2.
  1140. * <rmic> uses the the same classpath to verify a class can be rmic'd
  1141. as it passes to the compiler.
  1142. * org.apache.tools.mail.MailMessage (and therefore <mail>) can now
  1143. handle SMTP servers sending multi line responses.
  1144. * nested <classpath> elements of <taskdef> now work for <taskdef>s not
  1145. nested into <target> as well.
  1146. * <property> and <available> will search for the resource "foo" instead
  1147. of "/org/apache/tools/ant/taskdefs/foo" when given a relative resource
  1148. name foo.
  1149. * Handle build files in directories whose name contained a "#" character
  1150. * <junit> can now log to files whose name contains a comma as well.
  1151. * The AntClassLoader now refers to the loader which loaded it, any
  1152. requests it does not handle itself. Previously these went to the
  1153. primordial loader.
  1154. Changes from Ant 1.1 to Ant 1.2
  1155. ===============================
  1156. Changes that could break older environments:
  1157. --------------------------------------------
  1158. * Semantics of <property> has changed again in the hope to be more
  1159. intuitive. ${} expansion now happens at runtime and <property> tags
  1160. living inside of targets only take effect if they are visited at
  1161. runtime.
  1162. As a side effect of this change, task's attributes get set at runtime
  1163. not at parser time as well, which might change the results of
  1164. <script>s or other custom tasks that reference other tasks by their id
  1165. attribute.
  1166. * copying of support files in <javac> has been removed - as well as
  1167. the filtering attribute.
  1168. * the <expand> and <keysubst> tasks have been removed.
  1169. * the ignore and items attributes of directory based tasks have been removed.
  1170. * the command line switches _not_ starting with - have been removed.
  1171. * Path and EnumeratedAttribute have been moved from
  1172. org.apache.tools.ant to org.apache.tools.ant.types.
  1173. * the class attributes of <available>, <java>, <rmic> and <taskdef>
  1174. have been removed.
  1175. * the src attribute of <chmod> has been removed.
  1176. * <patch> and <javadoc> have lost some of their attributes.
  1177. * <java> and <cvs> have lost some undocumented attributes.
  1178. * the Unix antRun script would search for command.sh in the directory
  1179. it changed to and invoke this instead of command if present. This
  1180. behavior has been dropped.
  1181. * <ejbjar> task syntax has been changed significantly
  1182. * <exec> is no longer implemented by org.apache.tool.ant.taskdefs.Exec.
  1183. Custom tasks that rely on Project.createTask("exec") to return an
  1184. instance of this class are going to fail.
  1185. * nested <include> and <exclude> elements expect the value of their
  1186. name attribute to be a single pattern, they don't accept multiple
  1187. patterns anymore. Split them into multiple elements of the same type.
  1188. * <delete dir="somedir" /> will now delete the directory itself as
  1189. well as all included files. If you just want to clean out the
  1190. directory and keep the empty one, use a nested fileset.
  1191. Other changes:
  1192. --------------
  1193. * New tasks: antstructure, cab, execon, fail, ftp, genkey, jlink,
  1194. junit, sql, javacc, jjtree, starteam, war, unwar, uptodate,
  1195. native2ascii, copy, move, mparse.
  1196. * copydir, copyfile, deltree and rename are now deprecated. They
  1197. should be replaced with the new copy, delete and move tasks.
  1198. * <java> uses a ClassLoader of its own in no-fork mode if a classpath is
  1199. specified.
  1200. * <style> will create the necessary target directories and reprocess
  1201. all files if the stylesheet changes.
  1202. * New data types fileset and patternset - expected to get a broader use.
  1203. They, as well as PATH like structures, can now be defined on a global
  1204. level and later be referenced by their id attribute.
  1205. * You can specify environment variables to <exec>.
  1206. * <get> can check whether a remote file is actually newer than a local
  1207. copy before it starts a download (HTTP only).
  1208. * Added a -logger option to allow the class which performs logging to be
  1209. specified on the command line.
  1210. * Added a -emacs option to tell the logger to leave out taskname adornments
  1211. on log output.
  1212. * <chmod> works on all files in parallel and supports multiple filesets.
  1213. * <replace> can now use tokens and/or values that cross line boundaries.
  1214. * build.compiler supports now jvc as well.
  1215. * project specific help can now be obtained with the -projecthelp option.
  1216. * Added a -debug option to make -verbose less verbose (and more useful)
  1217. * Ant will now search for a file named build.xml in the parent directory
  1218. and above (towards the root of the filesystem) if you didn't specify
  1219. -buildfile and there is no build.xml in the current directory.
  1220. * <echo> can now write to a file and accepts nested text.
  1221. Fixed bugs:
  1222. -----------
  1223. * <chmod> didn't work when used as a directory based task.
  1224. * Path, Available, Property didn't resolve relative filenames with
  1225. respect to the Project's basedir.
  1226. * Project didn't interpret the basedir attribute correctly in all
  1227. cases.
  1228. * Nested <src> in <javac> caused NullPointerException.
  1229. * Corrupt Zip- and Jar-files ar now deleted if the task fails.
  1230. * many more fixes we've forgotten to document here ...
  1231. * The packagelistloc attribute of <javadoc>'s <link> child will be
  1232. resolved as a file (i.e. it is either absolute or relative to
  1233. basedir).