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 128 kB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410
  1. Changes from current Ant 1.6.5 version to current SVN version
  2. =============================================================
  3. Changes that could break older environments:
  4. -------------------------------------------
  5. * Removed support for xalan1 completely. Users of Xalan1 for ant builds will
  6. have to stay at ant 1.6.5 or upgrade to xalan2.
  7. * Improved recursion detection for lines with multiple matches of same token on one single line.
  8. Bugzilla report 38456.
  9. * Task will now log correctly even if no project is set.
  10. Bugzilla report 38458.
  11. * Use alternative names for the command line arguments in javac. Bugzilla
  12. Report 37546.
  13. * Use org.apache.log4j.Logger instead of org.apache.log4j.Category.
  14. Category has been deprecated for ~2 years and has been removed from
  15. the log4j code. Logger was introduced in log4j 1.2 so users of
  16. log4j 1.1 and log4j 1.0 need to upgrade to a newer version of log4j.
  17. Bugzilla Report 31951.
  18. * build.sysclasspath now also affects the bootclasspath handling of
  19. spawned Java VMs. If you set build.sysclasspath to anything other
  20. than "ignore" (or leave it unset, since "ignore" is the default when
  21. it comes to bootclasspath handling), then the bootclasspath of the
  22. VM running Ant will be added to the bootclasspath you've specified.
  23. * The Reference class now has a project field that will get
  24. used (if set) in preference to the passed in project, when
  25. dereferencing the reference. Bugzilla Report 25777.
  26. * On DOS and Netware, filenames beginning with a drive letter
  27. and followed by a colon but with no directory separator following
  28. the colon are no longer (incorrectly) accepted as absolute pathnames
  29. by FileUtils.normalize() and FileUtils.isAbsolutePath(). Netware
  30. volumes can still be specified without an intervening separator.
  31. UNC pathnames on Windows must include a server and share name, i.e.
  32. "\\a\b" to be considered valid absolute paths.
  33. * The <java fork="false"> now as per default installs a security manager
  34. using the default permissions. This is now independent of the
  35. failonerror attribute.
  36. Bugzilla report 33361.
  37. * <signjar> now notices when the jar and signedjar are equal, and switches
  38. to the same dependency logic as when signedjar is omitted. This may break
  39. something that depended upon signing in this situation. However, since
  40. invoking the JDK jarsigner program with -signedjar set to the source jar
  41. actually crashes the JVM on our (Java1.5) systems, we don't think any
  42. build files which actually worked will be affected by the change.
  43. * <signjar> used to ignore a nested fileset when a jar was also provided
  44. as an attribute, printing a warning message; now it signs files in the
  45. fileset.
  46. * An improved method of handling timestamp granularity differences between
  47. client and server was added to the <ftp> task. FTP servers typically
  48. have HH:mm timestamps whereas local filesystems have HH:mm:ss timestamps.
  49. Previously, this required tweaking with the timediffmillis attribute
  50. which also was used to handle timezone differences. Now, there is a new
  51. timestampgranularity attribute. The default value for get operations is 0
  52. since the user has the more powerful preservelastmodified attribute to work
  53. with. Since this is not available on put operations the default value
  54. adds a minute to the server timestamp in order to account for this,
  55. Scripts which previously used timediffmillis to do this compensation may
  56. need to be rewritten. timediffmillis has now been deprecated.
  57. * On Java1.5+, Ant automatically sets the system property
  58. java.net.useSystemProxies to true, which gives it automatic use of the local
  59. IE (Windows) or Gnome2 (Unix/Linux) proxy settings. This may break any build
  60. file that somehow relied on content outside the firewall being unreachable:
  61. use the -noproxy command-line option to disable this new feature.
  62. * A bug in SQLExec would prevent the execution of trailing,
  63. non-semicolon-delimited statements. Bugzilla Report 37764.
  64. * support for the XSL:P XML parser has been removed.
  65. Bugzilla Report 23455.
  66. * Visual Age for Java optional tasks removed.
  67. * Testlet (test) optional task removed.
  68. * Icontract optional task removed.
  69. * Metamata (maudit, mmetrics, and mparse tasks) removed.
  70. * Sitraka (jpcoverage, jpcovmerge, jpcovreport) tasks suppressed.
  71. * <fixcrlf> used \r (Mac) line endings on OS X, whose proper line separator
  72. is \n (Unix). Bugzilla report 39585.
  73. * <scp> now optionally supports the sftp protocol, you may need a newer jsch.jar. Bugzilla Report 39373.
  74. Fixed bugs:
  75. -----------
  76. * Manifests have improved line length handling, taking care of encoding.
  77. Bug reports 37548 / 34425
  78. * <manifest> now closes the inputstream explicitly. Bug report 39628
  79. * <rpm> now also correctly searches the first element of the path. Bug report 39345.
  80. * ant.bat now handles classpath set to "". Bug report 38914.
  81. * <junit> now supports JUnit 4. Bugzilla Report 38811.
  82. * <junit> can now work with junit.jar in its <classpath>. Bugzilla Report 38799.
  83. * Some potential NullPointerExceptions, Bugzilla Reports 37765 and 38056
  84. * Problem when adding multiple filter files, Bugzilla Report 37341
  85. * problem referencing jars specified by Class-Path attribute in manifest
  86. of a ant task jar file, when this ant task jar file is located in
  87. a directory with space, Bugzilla Report 37085
  88. * Backward incompatible change in ZipFileSet, Bugzilla Report 35824.
  89. * Wrong replacement of file separator chars prevens junitbatchtest
  90. from running correctly on files from a zipfileset. Bugzilla Report 35499
  91. * Calling close twice on ReaderInputStream gave a nullpointer exception.
  92. Bugzilla Report 35544.
  93. * Memory leak from IntrospectionHelper.getHelper(Class) in embedded
  94. environments. Bugzilla Report 30162.
  95. * Translate task does not remove tokens when a key is not found.
  96. It logs a verbose message. Bugzilla Report 13936.
  97. * Incorrect task name with invalid "javac" task after a "presetdef".
  98. Bugzilla reports 31389 and 29499.
  99. * <manifest> was not printing warnings about invalid manifest elements.
  100. Bugzilla report 32190
  101. * <replace> got out of memory on large files (part of report 32566).
  102. <replace> can now handle files as long as there is enough disk space
  103. available.
  104. * Commandline.describeCommand() methods would attempt to describe
  105. arguments even when none, other than the executable name, were present.
  106. * Create signjar's helper ExecTask instance directly rather than by
  107. typedef discovery mechanisms. Bugzilla report 33433.
  108. * FileUtils.resolveFile() promised to return absolute files but
  109. did not always do so.
  110. * <ftp> failed to retrieve a file when the path towards the file contained
  111. an element starting with . Bugzilla report 33770
  112. * "<rmic> always compiles on Java1.5" bugzilla report=33862. Fixed default
  113. stub version to always be "compat", even on Java1.5+.
  114. * The .NET compilation tasks failed if filenames given as references
  115. contained spaces. Bugzilla Report 27170.
  116. * SQL task would try access result sets of statements that didn't
  117. return any, causing problems with Informix IDS 9.2 and IBM DB2 8.1
  118. FixPak 6 (or later). Bugzilla Reports 27162 and 29954.
  119. * Task.init() was called twice for most tasks. Bugzilla Report 34411.
  120. * JavaTest testcases sometimes fail on windows. Bugzilla Report 34502.
  121. * Targets with identical name work in imported project. Bugzilla Report 34566.
  122. * DemuxOutputStream now uses a WeakHashMap to store the thread-stream mapping,
  123. to avoid holding on to thread references after they terminate.
  124. * <xmlvalidate> and <schemavalidate> create a new parser for every file in a
  125. fileset, and so validate multiple files properly. Bugzilla Report 32791
  126. * <tar> / <untar> now accepts files upto 8GB, <tar> gives an error if larger
  127. files are to be included. This is the POSIX size limit.
  128. * <junitreport> removed line-breaks from stack-traces. Bugzilla
  129. Report 34963.
  130. * off-by-one error in environment setup for execution under OpenVMS fixed.
  131. * Bugzilla report 36171: -noclasspath crashes ant if no system classpath is set.
  132. * <pvcs> used wrong switch for retrieving revisions by label.
  133. Bugzilla Report 36359.
  134. * <sshexec> closed System.out, disabling output on second and subsequent
  135. invocations. Bugzilla report 36302.
  136. * <cvschangelog> was crashing with CVS versions >= 1.12.x due to change in
  137. the date format. Bugzilla report 30962.
  138. * The same IntrospectionHelper instance was continuously added as a listener
  139. to project. Bugzilla report 37184.
  140. * FileUtils.toURI() was not encoding non-ASCII characters to ASCII,
  141. causing impossibility to process XML entities referenced by XML
  142. documents in non ASCII paths. Bugzilla report 37348.
  143. * > 1 ssh invocations to a given host would fail. Bugzilla report 36207.
  144. * EmailTask was eating SMTP error messages. Bugzilla report 37547.
  145. * PropertySet API setMapper(...) didn't properly set up the Mapper.
  146. Bugzilla report 37760.
  147. * Proper return code for ant.bat. Bugzilla report 13655.
  148. * Project not set on ChainReaderHelpers used by the Redirector.
  149. Bugzilla report 37958.
  150. * Copy task would fail on locked (or otherwise uncopyable) files even if
  151. failonerror set to false. Bugzilla report 38175.
  152. * <junit> task did not print all the Test names when using forkmode='once'.
  153. Bugzilla report 37426.
  154. * <available> could leak resources, Bugzilla Report 38260.
  155. * Redirector called Thread.sleep in a synchronized block. Bugzilla report 37767.
  156. * CCUnlock's objselect attribute could exhibit unpredictable behavior;
  157. standardized improperly included objselect and objsel property accessors to
  158. delegate to the inherited objSelect property accessor. Bugzilla report 37766.
  159. * <unzip> and <untar> now correctly merge multiple nested patternsets.
  160. Bugzilla Report 38973.
  161. * On case-insensitive filesystems, a <move> to change filename case
  162. erroneously deleted the "destination" file before attempting to rename
  163. the source file. Bugzilla 37701.
  164. * <scp> can now handle uris with @s other than the final one denoting the
  165. domain. Bugzilla 38082.
  166. * If the class invoked by the <java> task threw a ClassNotFoundException,
  167. this was misinterpreted as the specified class itself not being found.
  168. * <echoproperties> setPrefix javadoc claimed null or empty prefix would be
  169. ignored; instead an error was thrown. Bugzilla report 39954.
  170. Other changes:
  171. --------------
  172. * Took in bugzilla report 39320.
  173. * Improve compatibility with GNU Classpath and java versions prior to 1.5. Bugzilla 39027.
  174. * ${ant.core.lib} may now be used to refer to the library containing the
  175. Ant classes, for instance useful when compiling tasks.
  176. * Minor performance improvements Bugzilla report 37777
  177. * New task <manifestclasspath> converts a path into a property
  178. suitable as the value for a manifest's Class-Path attribute.
  179. * Fixed references to obsoleted CVS web site. Bugzilla Report 36854.
  180. * Log fine-grained events at verbose level from JUnit. Bugzilla report 31885.
  181. * <WsdlToDotnet> and <style> are now deprecated in favor of <wsdltodotnet> and
  182. <xslt>, respectively. Bugzilla report 25832.
  183. * <echoproperties> now (alphanumerically) sorts the property list
  184. before echoing. Bugzilla report 18976.
  185. * A new base class DispatchTask has been added to facilitate elegant
  186. creation of tasks with multiple actions.
  187. * Major revision of <wsdltodotnet>. Supports mono wsdl and the microsoft
  188. wsdl run on mono, as well as most of the .NET WSE2.0 options. Extra
  189. schemas (files or urls) can be named in the <schema> element.
  190. Compilers can be selected using the compiler attribute, which defaults
  191. to "microsoft" on windows, and "mono" on everything else.
  192. * It is now possible to specify the pattern created/parsed by <checksum>.
  193. Bugzilla Report 16539.
  194. * Added a new "failall" value for the onerror attribute of <typedef>.
  195. Bugzilla report 31685.
  196. * New task <libraries> can retrieve library files from a maven repository.
  197. * unzip/unwar/unjar/untar now supports a nested mapper, which lets you unzip
  198. in useful ways.
  199. * Junit task -- display suite first.
  200. Bugzilla report 31962.
  201. * Added isSigned condition and signedselector selector
  202. Bugzilla report 32126.
  203. * Added preserveLastModified attribute to signjar task.
  204. Bugzilla report 30987.
  205. * Added <scriptcondition> condition, for inline scripted conditions
  206. * Added <xor> condition for exclusive-or combining of nested conditions.
  207. * Added <scriptselector> selector for scripted file selection
  208. * ant -diagnostics lists contents of ${user.home}/.ant/lib , and
  209. checks that the java.io.tmpdir directory exists and is writeable.
  210. * mail task accepts nested header element. Bugzilla report 24713.
  211. * zip/jar/war/ear supports level attribute for deflate compression level.
  212. Bugzilla report 25513.
  213. * Added loginputstring attribute to the redirector type.
  214. * Tighten security by sending storepass and keypass to signjar
  215. via the input stream of the forked process.
  216. * New task <schemavalidate> extends <xmlvalidate> with extra support
  217. for XML Schema (XSD) files.
  218. * <fixcrlf> supports a file attribute for easy fixup of a single file.
  219. * New condition <parsersupports> which can look for XML parser feature or
  220. property support in the parser Ant is using.
  221. * fixcrlf can be used in a filterchain.
  222. * <sync> has a new nested element <preserveInTarget> that can be used
  223. to protect extra-content in the target directory. Bugzilla Report
  224. 21832.
  225. * <signjar> now supports:
  226. -nested filesets at the same time as the jar attribute
  227. -a destDir attribute with the appropriate dependency logic, which
  228. can be used with the jar attribute or nested filesets
  229. -a mapper to permit filename remapping on signing
  230. -tsaurl and tsacert attributes for timestamped JAR signing
  231. -nested <sysproperty> elements, which can be used for proxy setup and the like
  232. * The linecontains and linecontainsregexp filterreaders now support a
  233. negate attribute to select lines -not- containing specified text.
  234. Bugzilla Report 34374.
  235. * <os> condition adds "winnt" as a family which can be tested. This is
  236. all windows platforms other than the Win9x line or Windows CE.
  237. * <exec> (and hence, <apply> and any other derived classes) have an OsFamily
  238. attribute, which can restrict execution to a single OS family.
  239. * added "backtrace" attribute to macrodef. Bugzilla report 27219.
  240. * Ant main provides some diagnostics if it ever sees a -cp or -lib option,
  241. as this is indicative of a script mismatch. Bugzilla report 34860
  242. * <junitreport> prints a special message if supplied an empty XML File. This
  243. can be caused by the test JVM exiting during a test, either via a
  244. System.exit() call or a JVM crash.
  245. * project name is now used for *all* targets so one can write consistent import
  246. build files. Bugzilla report 28444.
  247. * New condition <typefound> that can be used to probe for the declaration
  248. and implementation of a task, type, preset, macro, scriptdef, whatever.
  249. As it tests for the implementation, it can be used to check for optional
  250. tasks being available.
  251. * check for 1.5.* Ant main class. (weblogic.jar in classpath reports)
  252. * New condition <isfailure> that tests the return-code of an executable. This
  253. contains platform-specific logic and is better than comparing the result with
  254. "0".
  255. * Added initial support for Resource Collections, including the
  256. resourcecount task.
  257. * property attribute of pathconvert is now optional. If omitted the
  258. result will be written to the log.
  259. * New mapper, <scriptmapper>, supports scripted mapping of source files/strings
  260. to destination strings.
  261. * Add the echoxml task. This will echo nested XML to a file, with
  262. the normal <?xml ?> processor instruction. UTF-8 encoding only; no-namespace
  263. support.
  264. * Try to make subprojects of custom Project subclasses instances of the
  265. same type. Bugzilla report 17901.
  266. * <ssh> and <scp> support keyboard-interactive authentication now.
  267. * <javadoc> now supports -breakiterator for custom doclets if Ant is
  268. running on JSE 5.0 or higher. Bugzilla Report: 34580.
  269. * New logger, TimestampedLogger, that prints the wall time that a build
  270. finished/failed. Use with
  271. -logger org.apache.tools.ant.listener.TimestampedLogger
  272. * <junitreport> now generates pages alltests-errors.html and
  273. alltests-fails.html, that list only the errors and failures, respectively.
  274. Bugzilla Report: 36226
  275. * New task <makeurl> that can turn a file reference into an absolute file://
  276. url; and nested filesets/paths into a (space, comma, whatever) separated
  277. list of URLs. Useful for RMI classpath setup, amongst other things.
  278. * <xslt> now accepts nested FileNameMappers e.g. <globmapper>.
  279. Bugzilla report 37604.
  280. * New task <loadresource> that accompanies <loadfile> for non file resources.
  281. * <echo> now supports an encoding when saving to a file.
  282. * new GreedyInputHandler added.
  283. * add textfile attribute to the <filesmatch> condition. When true, the text
  284. contents of the two files are compared, ignoring line ending differences.
  285. * new <resourcesmatch> condition.
  286. * added the onmissingfiltersfile attribute to filterset. Bugzilla report 19845.
  287. * added the inline handler element to the input task.
  288. * <sql> supports property expansion if you set the expandProperties
  289. attribute. By default it does not expand properties, something we
  290. dare not change for fear of breaking complex SQL operations in
  291. existing files.
  292. * <javadoc>'s packagenames attribute is now optional and defaults to "*".
  293. * <javac>'s source and target attributes as well as <javadoc>'s source
  294. attribute will read default values from the properties
  295. ant.build.javac.source and ant.build.javac.target.
  296. * Handling of ' ', '#' in CLASSPATH and '#' in -lib (cannot use ' '
  297. in -lib on UNIX at the moment). Bugzilla Report 39295.
  298. * <scp> now optionally supports the sftp protocol. Bugzilla Report 39373.
  299. * resources can now be used to indicate the location of the stylesheet to use
  300. in <xslt>. Bugzilla Report 39407.
  301. * new <antversion> condition. Bugzilla report 32804.
  302. * ReplaceTokens should allow properties files. Bugzilla report 39688.
  303. * FTP Account could not be specified in ant FTP task. Bugzilla report 39720.
  304. * Minor performance updates. Bugzilla report 39565.
  305. * New deleteonexit attribute for the <tempfile> task. Bugzilla report 39842.
  306. Remember that the exit of the JVM can be a long time coming, especially under an
  307. IDE. Don't rely on this being called.
  308. * <scriptdef>-created scripts have support for nested text. All text
  309. passed to a scripted task can be accessed via self.text.
  310. * <fixcrlf> now supports an outputencoding attribute. Bugzilla report 39697.
  311. * <junitreport> now supports nested XSL parameters. Bugzilla report 39708.
  312. * <javacc> has a jdkversion attribute to pass the desired JDK version down to javacc.
  313. Bugzilla report 38715.
  314. Changes from Ant 1.6.4 to Ant 1.6.5
  315. ===================================
  316. Changes that could break older environments:
  317. --------------------------------------------
  318. Fixed bugs:
  319. -----------
  320. * <move> was unable to replace existing files or write into
  321. existing directories. Bugzilla report 34962.
  322. * <macrodef> with redefined default values was incorrect. (Fix for
  323. 31215 had a bug). Bugzilla report 35109.
  324. * <javadoc> will convert backslashes to forwardslashes when generating file
  325. list by useexternalfile. Bugzilla report 27814.
  326. Changes from Ant 1.6.3 to Ant 1.6.4
  327. ===================================
  328. Changes that could break older environments:
  329. --------------------------------------------
  330. * <ftp> task has had a number of changes. Uptodate calculation previously
  331. did not call a file uptodate if the source timestamp and the destination
  332. timestamp were equal. Bugzilla report 34941. Any script that attempted
  333. to compensate for this by using the timediffmillis attribute might need
  334. to be tweaked.
  335. Fixed bugs:
  336. -----------
  337. * Sun javah failed with java.lang.NoClassDefFoundError.
  338. Bugzilla report 34681.
  339. * DirectoryScanner.slowScan() was broken. Bugzilla report 34722.
  340. * DirectoryScanner.scan() could throw a NullPointerException on
  341. case-insensitive filesystems (read Windows or MacOS X).
  342. * Get w/authentication failed with ArrayOutOfBoundsExceptions.
  343. Bugzilla report 34734.
  344. * Granularity attribute for <sync> task was undocumented.
  345. Bugzilla report 34871.
  346. * <unzip> and <untar> could leave file handles open on invalid
  347. archives. Bugzilla report 34893.
  348. * propertyset threw NPE with nested, mapped propertysets.
  349. Other changes:
  350. --------------
  351. * AntXMLContext.setCurrentTargets() is now public. Bugzilla report 34680.
  352. Changes from Ant 1.6.2 to Ant 1.6.3
  353. ===================================
  354. Changes that could break older environments:
  355. --------------------------------------------
  356. * The subant task used the canonical version of a file path. This
  357. has been changed to use the absolute path. Bugzilla 30438.
  358. * Tar now writes two EOF blocks rather than one.
  359. Bugzilla report 28776
  360. * The Reference object now has a project field which it uses in preference
  361. to the project passed in. This allows composite references to be
  362. handled to nested projects.
  363. Bugzilla report 25777
  364. * <junit> with filtertrace="true" will now also swallow lines for the
  365. sun.reflect package. If you need to see them in your stack trace,
  366. you must set filtertrace to false.
  367. Bugzilla Report 22758
  368. * The jikes compiler adapter now supports -bootclasspath, -extdirs and
  369. -sourcepath and also uses the same logic for debug flags as javac.
  370. This means, the jikes compiler adapter now requires Jikes 1.15 or later.
  371. Bugzilla Reports 25868, 26404 and 32609.
  372. * The gcj compiler adapter used to include the Java runtime classes
  373. even if includeJavaRuntime was set to false, unless the
  374. bootclasspath has been specified as well. It will now always adhere
  375. to includeJavaRuntime, you may need to set it to true explicitly now
  376. if you relied on the old behavior.
  377. Other changes:
  378. --------------
  379. * <javadoc> can now take an attribute 'executable'. Bugzilla report 30606.
  380. * New attribute ignorecontents for <different> selector
  381. * Javadoc fixes for Location, Project, and RuntimeConfigurable
  382. Bugzilla 30160.
  383. * Enable to choose the regexp implementation without system property.
  384. Bugzilla Report 15390.
  385. * Expose objects and methods in IntrospectionHelper. Bugzilla Report 30794.
  386. * Allow file attribute of <move> to rename a directory.
  387. Bugzilla Report 22863.
  388. * Add xmlcatalog nested element to XmlProperty. Bugzilla report 27053.
  389. * New attribute alwayslog for <redirector> type.
  390. * Added <target> nested elements to <ant> and <antcall> to allow
  391. specification of multiple sub-build targets, which are executed
  392. with a single dependency analysis.
  393. * Refactored Target invocation into org.apache.tools.ant.Executor
  394. implementations. Bugzilla Reports 21421, 29248.
  395. * <rmic> now also supports Kaffe's rmic version shipping with Kaffe
  396. 1.1.2 and above.
  397. * added casesensitive attribute to <globmapper> and <regexpmapper>
  398. Bugzilla report 16686
  399. * added handledirsep attribute to <globmapper> and <regexpmapper>
  400. Bugzilla report 32487
  401. * added a new mapper <filtermapper>
  402. * When a BuildListener tried to access System.err or System.out, Ant
  403. would have thrown an exception - this has been changed. Ant now
  404. silently ignores the message. BuildListeners still should avoid
  405. accessing either stream.
  406. * Added a comment attribute to the zip task.
  407. Bugzilla report 22793.
  408. * Overloaded FileUtils.createNewFile with a boolean mkdirs attribute
  409. to create nonexistent parent directories.
  410. * <apply> has a new "force" attribute that, when true, disables
  411. checking of target files.
  412. * Made the dest attribute of the apply task optional; mapped target
  413. filenames will be interpreted as absolute pathnames when dest is omitted.
  414. * Changed default tempdir for <javac> from user.dir to java.io.tmpdir.
  415. * Added searchpath attribute to <exec> for searching path variable(s)
  416. when resolveexecutable = true.
  417. * Added revision and userid attributes to <pvcs> documentation.
  418. * Added support to the touch task for a mkdirs attribute to create
  419. nonexistent parent directories before touching new files.
  420. * Added support to the touch task for a pattern attribute to allow
  421. alternate datetime formats.
  422. * Added support to the touch task to map touched files using a nested
  423. mapper element.
  424. * Added support to the touch task for a verbose attribute to suppress
  425. logging of new file creation.
  426. * bad link in docs to the enhancement page in bugzilla.
  427. Bugzilla report 33252.
  428. * Added length task to get strings' and files' lengths.
  429. * <native2ascii> and <javah> now also support Kaffe's versions.
  430. * Recursive token expansion in a filterset can now be disabled by
  431. setting its recurse attribute to false.
  432. * Pathconvert no longer requires that one of (targetos|pathsep|dirsep)
  433. be set; platform defaults are used when this is the case.
  434. * Added preservelastmodified attribute to fixcrlf task. Bugzilla 25770.
  435. * Added isfileselected condition.
  436. * Added verbose="true|false" attribute to <subant>. When verbose is enabled,
  437. the directory name is logged on entry and exit of the sub-build.
  438. Bugzilla 33787.
  439. * Added -nouserlib option to allow running ant without automatically loading
  440. up ${user.home}/.lib/ant. This is useful when compiling ant, and antlibs.
  441. Modified the build.sh and build.bat to use the option.
  442. * Added -noclasspath option to allow running ant WITHOUT using CLASSPATH env
  443. variable. Modified ant.bat to do this so that %CLASSPATH% is not looked at.
  444. * Add else attribute to the condition task, which specifies an
  445. optional alternate value to set the property to if the nested
  446. condition evaluates to false. Bugzilla report 33074.
  447. * Ant generated jar files should now be detected as jar files by
  448. Solaris. Bugzilla Report 32649.
  449. * <rexec> with a single command should now work with unusal login
  450. dialogs without special read/write pairs. Bugzilla Report 26632.
  451. * <csc>'s extraoptions can now contain multiple arguments.
  452. Bugzilla Report 23599.
  453. * <macrodef> with default values set by properties would be
  454. seen as new definitions when called twice with different properties.
  455. This was confusing so the definitions are now treated as similar.
  456. Bugzilla Report 31215.
  457. * <javadoc> has a new attribute "includenosourcepackages" that can be
  458. used to document packages that don't hold source files but a
  459. package.html file. Bugzilla Report 25339.
  460. * <rpm> has new attributes failonerror and quiet.
  461. * Added two tutorials
  462. - beginner: introduction into Ant
  463. - task developers: using path, fileset etc
  464. * a number of new attributes that allow the user to handle non-standard
  465. server listing formats and time zone differences have been added in
  466. the <ftp> task.
  467. Fixed bugs:
  468. -----------
  469. * Do not pass on ThreadDeath when halting <java fork="false">. Bugzilla
  470. 32941.
  471. * Killing a thread running <java fork="true"> (e.g. from an IDE) would
  472. not stop the forked process. Bugzilla 31928.
  473. * Programs run with <java fork="true"> can now accept standard input
  474. from the Ant console. (Programs run with <java fork="false"> could
  475. already do so.) Bugzilla 24918.
  476. * AbstractCvsTask prematurely closed its outputStream and errorStream.
  477. Bugzilla 30097.
  478. * Impossible to use implicit classpath for <taskdef>
  479. when Ant core loader != Java application loader and
  480. Path.systemClassPath taken from ${java.class.path} Bugzilla 30161.
  481. * MacroInstance did not clean up nested elements correctly in the execute
  482. method, causing multiple use of the same macro instance with nested
  483. elements to fail.
  484. * checksum fileext property doc wrong. Bugzilla 30787.
  485. * FTP task, getTimeDiff method was returning wrong value. Bugzilla 30595.
  486. * make sure that Zip and its derivates call the createEmptyZip method when
  487. there are no resources to zip/jar/...
  488. * Zip task was not zipping when only empty directories were found.
  489. Bugzilla 30365.
  490. * Jar task was not including manifest files when duplicate="preserve" was
  491. chosen. Bugzilla 32802.
  492. * ant.bat was missing runAntNoClasspath label for goto.
  493. Bugzilla 34510.
  494. * Classpath was treated in the same way as -lib options. Bugzilla 28046.
  495. * Manual page for cvsversion contained incorrect attributes and did not
  496. say since 1.6.1. Bugzilla 31408.
  497. * Typo in definition of <cvsversion> task causing it not to be defined.
  498. Bugzilla 31403.
  499. * Execution of top level tasks in imported files get delayed by targets.
  500. Bugzilla report 31487.
  501. * ExecTask executes checkConfiguration() even though os does not match.
  502. Bugzilla report 31805.
  503. * Concat task instance could not be run twice.
  504. Bugzilla report 31814.
  505. * NPE using XmlLogger and antlib.
  506. Bugzilla report 31840.
  507. * Properties.propertyNames() should be used instead of .keys().
  508. Bugzilla report 27261.
  509. * Target location is not set for default target.
  510. Bugzilla report 32267.
  511. * Incorrect classloader parent in junittask when using with
  512. ant-junit.jar and junit.jar not in the project classloader. Bugzilla
  513. report 28474.
  514. * getResources() on the classloader returned by ClasspathUtils would
  515. see each resource twice - if the resource is in the project
  516. classpath and if the classloader is requested with a null path.
  517. * XMLValidate used URL#getFile rather than the ant method FileUtils#fromURI
  518. Bugzilla report 32508
  519. * fixed Regexp-Mapper docs which gave outdated instructions (optional.jar)
  520. Bugzilla report 28584
  521. * <scp> using <fileset> didn't work with OpenSSH 3.9 and later.
  522. Bugzilla report 31939
  523. * <setproxy> failed to set user/password on some JDKs.
  524. Bugzilla report 32667
  525. * untar would go into infinite loop for some invalid tar files.
  526. Bugzilla report 29877
  527. * forked <javac> won't pass -source to a JDK 1.1 or 1.2 javac anymore.
  528. Bugzilla report 32948
  529. * propertyset references did not handle nested propertyset references.
  530. * oata.types.Description.getDescription(Project) would throw a
  531. NullPointerException when the "ant.targets" reference was unset.
  532. * Wrapper scripts did not detect WINNT value of dynamic OS environment
  533. variable when logged into workstations using Novell authentication.
  534. Bugzilla Report 30366.
  535. * DependScanner.getResource() always returned nonexistent resources,
  536. even when the resource actually existed. Bugzilla Report 30558.
  537. * <apply> was broken with classfilesets. Bugzilla Report 30567.
  538. * <available> returned false positives when checking a file
  539. passed in with the current basedir leading twice:
  540. e.g. ${basedir}${file.separator}${basedir}${file.separator}foo .
  541. * The first file open that took place when using input files with the
  542. <exec>, <apply>, or <java> tasks was always logged to System.out
  543. instead of to the managing Task.
  544. * <telnet> and <rexec> would try to disconnect from servers they never
  545. connetced to, potentially leading to exceptions in commons-net.
  546. Bugzilla Report 33618.
  547. * <zip> would drop files matched by defaultexcludes during updates.
  548. Bugzilla Report 33412.
  549. * <zip> couldn't store files with size between 2GB and 4GB (the
  550. upper limit set by the ZIP format itself). Bugzilla Report 33310.
  551. * NPE when when <presetdef> tries to configure a task that
  552. cannot be instantiated. Bugzilla Report 33689.
  553. * <javac debug="false"> created an invalid command line when running
  554. the Symantec Java compiler.
  555. * Get with usetimestamp did not work on Java 1.2.
  556. * Get with usetimestamp did not work when local timestamp roughly >= now.
  557. * The framed JUnit report now handles multiple reports for the same
  558. testcase properly. Bugzilla Report 32745.
  559. * <cab> didn't work for files with spaces in their names on Windows.
  560. Bugzilla Report 17182.
  561. * The VAJ tasks could fail if the project name contained characters
  562. that need to get URL encoded. Bugzilla Report 23322.
  563. * TarInputStream#read() wasn't implemented correctly. Bugzilla Report
  564. 34097.
  565. * <xslt> failed to process file-hierarchies of more than one level if
  566. scanincludeddirectories was true. Bugzilla Report 24866.
  567. * forkmode="perBatch" or "once" would ignore extension attributes that
  568. had been specified for <formatter>s. Bugzilla Report 32973.
  569. * The refid attribute of the I/O redirector was not functional.
  570. Changes from Ant 1.6.1 to Ant 1.6.2
  571. ===================================
  572. Changes that could break older environments:
  573. --------------------------------------------
  574. * The import task used the canonical version of a file path. This
  575. has been changed to use the absolute path. Bugzilla 28505.
  576. * ant-xalan2.jar has been removed since the only class contained in it
  577. didn't depend on Xalan-J 2 at all. Its sole dependency has always
  578. been TraX and so it has been merged into ant-trax.jar.
  579. * All exceptions thrown by tasks are now wrapped in a buildexception
  580. giving the location in the buildfile of the task.
  581. * Nested elements for namespaced tasks and types may belong to the
  582. Ant default namespace as well as the task's or type's namespace.
  583. * <junitreport> will very likely no longer work with Xalan-J 1.
  584. Note that Xalan-J 1 has been deprecated for a very long time and we
  585. highly recommend that you upgrade.
  586. If you really need to continue using Xalan-J 1, please copy the
  587. junit-frames-xalan1.xsl from the distribution's etc directory as
  588. junit-frames.xsl into a new directory and use the task's styledir
  589. attribute to point to. This is the last version of the XSLT
  590. stylesheet that is expected to be compatible with Xalan-J 1.
  591. Fixed bugs:
  592. -----------
  593. * eliminate memory leak in AntClassLoader. Bugzilla Report 8689.
  594. * subant haltonfailure=false did not catch all failures. Bugzilla Report 27007.
  595. * macrodef @@ escaping was broken. Bugzilla Report 27069.
  596. * MacroDef did not allow attributes named 'description'. Bugzilla Report 27175.
  597. * Throw build exception if name attribute missing from patternset#NameEntry.
  598. Bugzilla Report 25982.
  599. * Throw build exception if target repeated in build file, but allow targets
  600. to be repeated in imported files.
  601. * <apply> didn't compare timestamps of source and targetfiles when
  602. using a nested <filelist>. Bugzilla Report 26985.
  603. * tagdiff.xml was broken in ant 1.6.1. Bugzilla Report 27057.
  604. * if the basedir contained .. or . dirs, and the build file name contained
  605. .. or ., the basedir was set incorrectly. Bugzilla Report 26765.
  606. * regression from ant 1.5, exec task outputted two redundant trailing newlines.
  607. Bugzilla Report 27546.
  608. * NPE when running commons listener. Bugzilla Report 27373.
  609. * <java> swallowed the stack trace of exceptions thrown by the
  610. executed program if run in the same VM.
  611. * -projecthelp swallowed (configuration) errors silently.
  612. Bugzilla report 27732.
  613. * filterset used by filtertask doesn't respect loglevel. Bugzilla Report 27568.
  614. * wrong compare used in ProjectComponent for logging. Bugzilla Report 28070.
  615. * failOnAny attribute for <parallel> was broken. Bugzilla Report 28122.
  616. * If <javac> uses gcj and any of the nested <compilerarg>s implies
  617. compilation to native code (like -o or --main), Ant will not pass
  618. the -C switch to gcj. This means you can now compile to native code
  619. with gcj which has been impossible in Ant < 1.6.2.
  620. * <import optional="false"> and <import optional="true">
  621. behaved identically.
  622. * <xslt> now sets the context classloader if you've specified a nested
  623. <classpath>. Bugzilla Report 24802.
  624. * <zip> and friends would delete the original file when trying to update
  625. a read-only archive. Bugzilla Report 28419.
  626. * <junit> and <assertions> are working together. Bugzilla report 27218
  627. * AntClassLoader#getResource could return invalid URLs. Bugzilla
  628. Report 28060.
  629. * Ant failed to locate tools.jar if the jre directory name wasn't all
  630. lowercase. Bugzilla Report 25798.
  631. * Redirector exhibited inconsistent behavior with regard to split
  632. output. When sent to file only, files would be created in all
  633. cases; when split file-property, files were only created if
  634. writes were performed.
  635. * fixed case handling of scriptdef attributes and elements.
  636. * UNC pathnames did not work for ANT_HOME or -lib locations on Windows.
  637. Bugzilla report 27922.
  638. * replacestring tokenfilter only replaced the first occurrence.
  639. * AntLikeTasksAtTopLevelTest failed on cygwin.
  640. * I/O-intensive processes hung when executed via <exec spawn="true">.
  641. Bugzilla reports 23893/26852.
  642. * JDependTask did not close an output file. Bugzilla Report 28557.
  643. * Using <macrodef> could break XmlLogger. Bugzilla Report 28993.
  644. * <genkey> no longer requires keytool to be in your PATH. Bugzilla
  645. Report 29382.
  646. * <symlink> could create cyclic links. Bugzilla Report 25181.
  647. * <zip whenempty="skip"> didn't work in a common situation. Bugzilla
  648. Report 22865.
  649. * <scp> now properly handles remote files and directories with spaces
  650. in their names. Bugzilla Report 26097.
  651. * <scp> now has (local|remote)tofile attributes to rename files on the
  652. fly. Bugzilla Report 26758.
  653. * <telnet> and <rexec> didn't close the session. Bugzilla Report 25935.
  654. * <subant> and XmlLogger didn't play nicley together.
  655. Other changes:
  656. --------------
  657. * doc fix concerning the dependencies of the ftp task
  658. Bugzilla Report 29334.
  659. * <xmlvalidate> has now a property nested element,
  660. allowing to set string properties for the parser
  661. Bugzilla Report 23395.
  662. * Docs fixes for xmlvalidate.html, javadoc.html, starteam.
  663. Bugzilla Reports 27092, 27284, 27554.
  664. * <pathconvert> now accepts nested <mapper>s. Bugzilla Report 26364.
  665. * Shipped XML parser is now Xerces-J 2.6.2.
  666. * Added nested file element to filelist.
  667. * spelling fixes, occurred. Bugzilla Report 27282.
  668. * add uid and gid to tarfileset. Bugzilla Report 19120.
  669. * <scp> has a verbose attribute to get some feedback during the
  670. transfer and new [local|remote][File|Todir] alternatives to file and
  671. todir that explicitly state the direction of the transfer.
  672. * The OS/2 wrapper scripts have been adapted to use the new launcher.
  673. Bugzilla Report 28226.
  674. * <sshexec> now also captures stderr output. Bugzilla Report 28349.
  675. * <xslt> now supports a nested <mapper>. Bugzilla Report 11249.
  676. * <touch> has filelist support.
  677. * <nice> task lets you set the priority of the current thread; non-forking
  678. <java> code will inherit this priority in their main thread.
  679. * New attribute "negate" on <propertyset> to invert selection criteria.
  680. * Target now supports a Location member. Bugzilla Report 28599.
  681. * New "pattern" attribute for <date> selector.
  682. * <junit> has a new forkmode attribute that controls the number of
  683. Java VMs that get created when forking tests. This allows you to
  684. run all tests in a single forked JVM reducing the overhead of VM
  685. creation a lot. Bugzilla Report 24697.
  686. * <jar> can now optionally create an index for jars different than the
  687. one it currently builds as well. See the new <indexjars> element
  688. for details. Bugzilla Report 14255.
  689. * Permit building under JDK 1.5. Bugzilla Report 28996.
  690. * minor Javadoc changes. Bugzilla Report 28998.
  691. * Misc. corrections in SignJar.java. Bugzilla Report 28999.
  692. * Remove redundant <hr> from javah.html. Bugzilla Report 28995.
  693. * Ignore built distributions. Bugzilla Report 28997.
  694. * A new roundup attribute on <zip> and related task can be used to
  695. control whether the file modification times inside the archive will
  696. be rounded up or down (since zips only store modification times with
  697. a granularity of two seconds). The default remains to round up.
  698. Bugzilla Report 17934.
  699. * A binary option has been added to <concat>. Bugzilla Report 26312.
  700. * Added DynamicConfiguratorNS, an namespace aware version of
  701. DynamicConfigurator. Bugzilla Report 28436.
  702. * Add implicit nested element to <macrodef>. Bugzilla Report 25633.
  703. * Add deleteonexit attribute to <delete>.
  704. * Added Target.getIf/Unless(). Bugzilla Report 29320.
  705. * <fail> has a status attribute that can be used to pass an exit
  706. status back to the command line.
  707. * <fail> accepts a nested <condition>.
  708. * <loadproperties> supports loading from a resource.
  709. Bugzilla Report 28340.
  710. * Nested file mappers and a container mapper implementation have been
  711. introduced. Additionally, the <mapper> element now accepts "defined"
  712. nested FileNameMapper implementations directly, allowing a usage
  713. comparable to those of <condition>, <filter>, and <selector>.
  714. * New <redirector> type introduced to provide extreme I/O flexibility.
  715. Initial support for <exec>, <apply>, and <java> tasks.
  716. * <apply> has a new ignoremissing attribute (default true for BC)
  717. which will allow nonexistent files specified via <filelist>s to
  718. be passed to the executable. Bugzilla Report 29585.
  719. * <junitreport> now also works with Xalan XSLTC and/or JDK 1.5.
  720. Bugzilla Report 27541.
  721. * <jspc> doesn't work properly with Tomcat 5.x. We've implemented a
  722. work-around but don't intend to support future changes in Tomcat
  723. 5.x. Please use the jspc task that ships with Tomcat instead of
  724. Ant's.
  725. Changes from Ant 1.6.0 to Ant 1.6.1
  726. =============================================
  727. Changes that could break older environments:
  728. --------------------------------------------
  729. * License is now Apache Software License 2.0
  730. see http://www.apache.org/licenses/ for more information
  731. Fixed bugs:
  732. -----------
  733. * Remove a recursive template call in the junit xsls that could trigger a stack
  734. overflow. It now uses Xalan extensions to call a Java class directly.
  735. Bugzilla Report 19301
  736. * Fix spurious infinite loop detection for filters (introduced in ant 1.6.0).
  737. Bugzilla Report 23154.
  738. * Fix handling of default ant namespace for nested elements.
  739. * Fix jboss element of ejb task (introduced in ant 1.6.0).
  740. * <whichresource> failed to load classes correctly.
  741. * Ant could fail to start with a NullPointerException if
  742. ANT_HOME/lib/ant-launcher.jar was part of the system CLASSPATH.
  743. * presetdef'ed types did not work with the ant-type attribute
  744. * fixed case handling of macrodef attributes and elements. Bugzilla
  745. Reports 25687 and 26225.
  746. * <java> ignored the append attribute, Bugzilla Report 26137.
  747. * The gcj compiler adapter for <javac> failed if the destination
  748. directory didn't exist. Bugzilla Report 25856.
  749. * Ant now fails with a more useful message if a new process will be
  750. forked in a directory and that directory doesn't exist.
  751. * <splash> used to break the build on non-GUI environments. Bugzilla
  752. report 11482.
  753. * Ant 1.6.0 cannot run build scripts in directories with non-ASCII names.
  754. Bugzilla Report 26642.
  755. Other changes:
  756. --------------
  757. * Shipped XML parser is now Xerces-J 2.6.1
  758. * Translate task logs a debug message specifying the number of files
  759. that it processed. Bugzilla Report 13938.
  760. * <fixcrlf> has a new attribute - fixlast. Bugzilla Report 23262.
  761. * <p4submit> has 2 new attributes, needsresolveproperty and changeproperty.
  762. Bugzilla Report 25711.
  763. * add description attributes to macrodef attributes and elements.
  764. Bugzilla Report 24711.
  765. * Extending ClearCase Tasks :
  766. - Added an extra option to 'failonerr' to each ClearCase task/command.
  767. - Extended the functionality of cccheckout. It can check (notco) to see if
  768. the desired element is already checked out to the current view. Thus it
  769. won't attempt to check it out again.
  770. - Added three new ClearCase commands: ccmkattr, ccmkdir, ccmkelem
  771. Bugzilla Report 26253.
  772. * added nested text support to <macrodef>
  773. * added initial support for Java 1.5. Java 1.5 is now correctly
  774. detected by Ant and treated just like Java 1.4. You can now specify
  775. source="1.5" in the <javac> task.
  776. * created new task <cvsversion>
  777. * added support for branch logging via the tag attribute in <cvschangelog>
  778. Bugzilla Report 13510.
  779. * added support the groovy language in the script and scriptdef tasks
  780. Changes from Ant 1.5.4 to Ant 1.6.0
  781. ===================================
  782. Changes that could break older environments:
  783. --------------------------------------------
  784. * This version of Ant can not be built with JDK 1.1 and requires at
  785. least Java 1.2 at runtime as well. Compiling for a 1.1 target is
  786. still supported.
  787. * Targets cannot have the empty string as their name any longer.
  788. * ant.jar's manifest does no longer include a Class-Path entry, so it
  789. is no longer possible to run Ant via "java -jar ant.jar" without
  790. manually altering the CLASSPATH. Instead of that a file
  791. ant-bootstrap.jar is included in the etc directory of the binary
  792. distribution, copy this to the lib directory and use
  793. "java -jar ant-bootstrap.jar" instead if you want to run Ant without
  794. the wrapper script (not recommended).
  795. * The <script> task now requires Apache BSF instead of the older IBM
  796. version. See <http://jakarta.apache.org/bsf/>
  797. * <xmlproperty> will no longer fail if the file to be loaded doesn't exist.
  798. * XML namespaces are now enabled in the XML parser, meaning XML namespace
  799. declarations no longer cause errors. However task names containing colons
  800. will cause errors unless there is a corresponding namespace uri.
  801. * The <ftp> and <telnet> tasks now require Jakarta Commons Net instead
  802. of the older ORO Netcomponents version. See
  803. <http://jakarta.apache.org/commons/net/index.html>.
  804. * <input> will no longer prompt the user and wait for input if the
  805. addproperty attribute is set to a property that has already been
  806. defined in the project. If you rely on the task waiting for input,
  807. don't use the addproperty attribute.
  808. * The Class-Path attribute in manifests will no longer merge the
  809. entries of all manifests found, but will be treated like all other
  810. manifest attributes - the most recent attribute(s) will be used.
  811. * New Launch mechanism implemented. This moves some functionality from
  812. the batch files / shell scripts into Java. This removes environment
  813. limitations, for command issues, directory depth issues on Windows. Also
  814. allows a per-user library location to be used if the main Ant install
  815. is locked down.
  816. * The Entry nested element of PropertyFile will not any more have its value
  817. attribute (actually increment) overwritten with the new value of the entry
  818. after execution.
  819. * Output stored from a <java> or <exec> task is now exactly as generated. No
  820. conversion to platform end-of-line characters is performed.
  821. * <translate> will now preserve line endings.
  822. * <ftp> followsymlinks="false" in nested fileset definitions is explicitly
  823. required in order to exclude remote symbolic links (when doing a get, chmod,
  824. delete, rmdir).
  825. * The values of the Copy#fileCopyMap variable has changed from String to
  826. String[]. (In java 1.5 terms it was Hashtable<String, String> and
  827. is now Hashtable<String, String[]>). This will affect third party code
  828. that extend Copy and override Copy#doFileOperations.
  829. * <loadproperties> didn't expand properties while <property file="..."/>
  830. does, so they were not equivalent. This has been fixed, which means
  831. that propetries may get expanded twice if you use an
  832. <expandproperties> filterreader. Bugzilla Report 17782.
  833. * User defined tasks and typedefs are now handled internally in the
  834. same way as predefined tasks and typedefs. Also tasks and typedefs
  835. are resolved at a later stage. This causes some
  836. differences especially for user defined task containers.
  837. * <checksum> log message "Calculating checksum ..." has been degraded
  838. from INFO to VERBOSE.
  839. Fixed bugs:
  840. -----------
  841. * Filter readers were not handling line endings properly. Bugzilla
  842. Report 18476.
  843. * Filtersets were also not handling line endings properly.
  844. * Expand tasks did not behave as expected with PatternSets.
  845. * <property environment=... /> now works on OS/400.
  846. * <cab> could hang listcab on large <fileset>s.
  847. * The starteam stcheckout, stcheckin tasks now correctly compute
  848. status of files against whatever local tree they are run against
  849. and, optionally, will not process a file if it is current.
  850. Previously you had to process everything unless you ran against the
  851. default folder which wasn't the normal use-case for ant-starteam.
  852. The stlist task now similarly displays that status correctly making
  853. it a more generally useful tool.
  854. * entity includes would cause exceptions if path names included spaces.
  855. * addConfiguredXXX would not work for TaskAdapter wrapped tasks
  856. * Fix <ilasm> outputfile testing so that the output file does not need
  857. to exist beforehand.
  858. * Ant will now exit with a return code of 1 if it encounters problems
  859. with the command line arguments.
  860. * ClassLoader creation changes to use a factory method in Project. A new
  861. class AntClassLoader2 implemented for 1.2+ specific features including
  862. Package information and addition of classes specified in the Class-Path
  863. element of a Jar's manifest.
  864. * It is now possible in <exec> to resolve the executable to a project
  865. basedir or execution dir relative executable. The resolveExecutable
  866. must be used to pick up such executables.
  867. * splash screen wouldn't disappear when build was finished.
  868. * <exec> output and error streams can now be redirected independently
  869. to either a property or a file (or both)
  870. * TarEntry's File-arg constructor would fail with a
  871. StringIndexOutOfBoundsException on all OSes where os.name is shorter
  872. than seven characters. Bugzilla Report 18105.
  873. * <copy> and <move>'s failonerror didn't apply to filesets pointing to
  874. non-existant directories. Bugzilla Report 18414.
  875. * The <stripjavacomments> filter sometimes removed parts of string
  876. constants. Bugzilla Report 17441.
  877. * <antlr> will now recompile your grammar if the supergrammar has
  878. changed. Bugzilla Report 12691.
  879. * <property env> will now work on Unices with /bin/env instead of
  880. /usr/bin/env. Bugzilla Report 17642.
  881. * <jar index="on"> could include multiple index lists. Bugzilla 10262.
  882. * The index created by <jar> didn't conform to the spec as it didn't
  883. include the top-level entries. Bugzilla Report 16972.
  884. * <tar> and <zip> didn't honor the defaultexcludes attribute for the
  885. implicit fileset. Bugzilla Report 18637.
  886. * The <replacetokens> filter would throw an exception if the token's
  887. value was an empty string. Bugzilla Report 18625.
  888. * Perforce tasks relying on output from the server such as <p4change>
  889. and <p4label> were hanging. Bugzilla Reports 18129 and 18956.
  890. * Improve exception and logging behavior of Perforce tasks.
  891. Bugzilla report 18154.
  892. * build.sh install had a problem on cygwin (with REALANTHOME).
  893. Bugzilla Report 17257
  894. * <replaceregexp> didn't work for multi-byte encodings if byline was false.
  895. Bugzilla Report 19187.
  896. * <replaceregexp> was altering unnecessarily the timestamp of the directories
  897. containing the files to process
  898. Bugzilla Report 22541.
  899. * file names that include spaces need to be quoted inside the @argfile
  900. argument using forked <javac> and (all JDKS). Bugzilla Report 10499.
  901. NB : a first correction was only introducing quotes for JDK 1.4
  902. It has been changed to quote for all external compilers when paths
  903. contain spaces.
  904. Also the backslashes need to be converted to forward slashes
  905. Bugzilla Report 17683.
  906. * Setting filesonly to true in <zip> and related tasks would cause the
  907. archives to be always recreated. Bugzilla Report 19449.
  908. * file names that include spaces need to be quoted inside the @argfile
  909. argument using <javadoc> and JDK 1.4. Bugzilla Report 16871.
  910. * <junit> didn't work with custom formatters that were only available
  911. on the user specified classpath when a timeout occurred. Bugzilla
  912. Report 19953.
  913. * <different> selector : make ignoreFileTimes effectively default to true
  914. and fix a bug in the comparison of timestamps. Bugzilla Report 20205.
  915. * <different> selector can now be nested directly under a fileset
  916. Bugzilla Report 20220.
  917. * <cvstagdiff> had a problem with "dd-MM-yy hh:mm:ss" formats
  918. Bugzilla Report 15995.
  919. * <cvstagdiff> cvsroot and package attributes added to the root
  920. element tagdiff of the xml output
  921. Bugzilla Report 16081.
  922. * <cvstagdiff> had a problem with aliased modules and with requests for
  923. multiple modules. Bugzilla Reports 21373 and 22877.
  924. * <cvstagdiff> could not parse properly the revision number of new files with
  925. CVS 1.11.9 or higher. Bugzilla Report 24406.
  926. * <fixcrlf> make fixcrlf create its temporary files in the default directory
  927. of FileUtils#createTempFile instead of the destination dir of fixcrlf.
  928. Bugzilla Report 20870.
  929. * <ejbjar> implementation for Borland.
  930. Prevent the task from being blocked by error messages coming from java2iiop.
  931. Bugzilla Report 19385.
  932. * <unzip>'s and <untar>'s nested patternsets didn't work as documented
  933. when the pattern ended in a slash or backslash. Bugzilla Report 20969.
  934. * <fixcrlf> will now create the parent directories for the destination
  935. files if necessary. Bugzilla Report 20840.
  936. * <xmlproperty> now handles CDATA sections. BugZilla Report 17195
  937. * <translate> now translate tokens that are placed close together.
  938. Bugzilla Report 17297
  939. * Nested websphere element for ejbjar does not support spaces in file name.
  940. Bugzilla Report 21298
  941. * Don't multiply Class-Path attributes when updating jars. Bugzilla
  942. Report 21170.
  943. * Do not overwrite the value (increment) attribute of PropertyFile nested
  944. Entry element. Bugzilla Report 21505.
  945. * Prevent sysproperties with no key or no value from being added in <junit>.
  946. Bugzilla Report 21684.
  947. * Allow references to be properly inherited via antcall
  948. Bugzilla Report 21724.
  949. * ftp chmod failed when the remote system was UNIX and local system Windows
  950. Bugzilla Report 21865.
  951. * ftp put with chmod failed when the remote system was UNIX and local system
  952. Windows. Bugzilla Report 23143.
  953. * ftp did not set the ascii mode explicity, causing problems with ftp servers
  954. having binary as default
  955. * ftp was not able to download files when they were pointed to by symbolic
  956. links. Bugzilla Report 14063.
  957. * ftp is able to download also directories pointed to by symbolic links.
  958. * replace would change \r\n into \r\r\n under Windows.
  959. * junitreport with frames did not display a link for classes without a package
  960. or in the top package.
  961. Bugzilla Report 21915.
  962. * Project.toBoolean(String) now handles null as argument and does not throw a
  963. NullPointerException any more.
  964. * The socket condition will now close the socket created to test.
  965. Bugzilla Report 23040.
  966. * <junit includeantruntime="true" fork="true"> replaced the CLASSPATH instead
  967. of adding to it. Bugzilla Report 14971.
  968. * <splash> could fail on JVMs that use null to indicate the system classloader.
  969. Bugzilla Report 23320.
  970. * <xmlcatalog>s only worked when defined inside of tasks. Bugzilla
  971. Report 20965.
  972. * <csc> and siblings (<vbc> <jsharpc>) handle large filesets by
  973. automatic use of response files. Bugzilla report #19630
  974. Other changes:
  975. --------------
  976. * Shipped XML parser is now Xerces 2.6.0
  977. * All tasks can be used outside of <target>s. Note that some tasks
  978. will not work at all outside of targets as they would cause infinite
  979. loops (<antcall> as well as <ant> and <subant> if they invoke the
  980. current build file).
  981. * Six new Clearcase tasks added.
  982. * A new filter reader namely tokenfilter has been added. Bugzilla
  983. Report 18312.
  984. * A new attribute named skip is added to the TailFilter and
  985. HeadFilter filter readers.
  986. * The filesetmanifest attribute of <jar> has been reenabled.
  987. * The start and end tokens for <translate> may now be longer than a
  988. single character.
  989. * <setproxy> lets you set the username and password for proxies that
  990. want authentication
  991. * <loadproperties> has a new encoding attribute.
  992. * <echoproperties> can now create XML output.
  993. * <echoproperties> has a new srcfile attribute that can make it read
  994. properties files and output them instead of Ant's properties.
  995. * <filterset> will now resolve filters recursively.
  996. * <input> has a new attribute that allows you to specify a default value.
  997. * Added <image> task (requires JAI).
  998. * <image> task has now proportions attribute in the <scale/> nested element
  999. instead of keepproportions (bringing in more functionality)
  1000. * New condition <isreference>
  1001. * <ftp> now has a preservelastmodified attribute to preserve the
  1002. timestamp of a downloaded file.
  1003. * new rmdir action for <ftp> that removes directories from a fileset.
  1004. * <ftp> has attributes timediffauto and timediffmillis to use together
  1005. with the newer attribute to tell ant to take into account a time difference
  1006. between client and remote side.
  1007. Bugzilla Report 19358.
  1008. * <ftp> has been optimized to go directly to the include patterns.
  1009. This reduces scanning time under UNIX when followsymlinks="true"
  1010. and casesensitive="true" (the default)
  1011. Bugzilla Report 20103.
  1012. * The SOS and VSS tasks will no longer unconditionally prepend a $ to
  1013. vsspath or projectpath.
  1014. * OS/400 now gets detected by the os condition.
  1015. * <arg> has a new attribute pathref that can be used to reference
  1016. previously defined paths.
  1017. * <xmlproperty> has been improved, you can now expand ${properties},
  1018. define ids or paths and use Ant's location magic for filename resolutions
  1019. in the XML file.
  1020. * <xmlcatalog> will now support external catalogs according to the
  1021. OASIS "Open Catalog" standard - if resolver.jar (newer than version
  1022. 1.0) from Apache's xml-commons is in your CLASSPATH.
  1023. * Starteam tasks now have support for revision labels and build labels.
  1024. Checkouts now have the option of using repository timestamps, instead
  1025. of current.
  1026. * new task <symlink> that creates and maintains symbolic links.
  1027. * new tasks <chown> and <chgrp> which are wrappers of the Unix commands.
  1028. * new task <attrib> to change file attributes on Windows systems.
  1029. * <style> has a new attribute reloadstylesheet to work around a
  1030. bug in widespread Xalan versions.
  1031. * <tarfileset> has a new dirmode attribute to specify the permissions
  1032. for directories.
  1033. * <fixcrlf>'s eol attribute now also understands "mac", "unix" and "dos".
  1034. * <classfileset> now picks up dependencies of the form MyClass.class. This
  1035. works for the code generated by the Sun java compiler. It may not work for
  1036. all compilers.
  1037. * a new attribute "globalopts" can be added to all Perforce tasks.
  1038. You can put in it all the strings described by p4 help usage. Refer to
  1039. the docs for more information.
  1040. * new Perforce tasks <p4integrate> , <p4resolve>, and <p4labelsync>
  1041. * <p4submit> will change the property p4.change if the Perforce server
  1042. renumbers the change list.
  1043. It will set the property p4.needsresolve if the submit fails,
  1044. and the message says that file(s) need to be resolved.
  1045. * <replaceregexp> now has an optional encoding attribute to support
  1046. replacing in files that are in a different encoding than the
  1047. platform's default.
  1048. * The <exec> task may now have its input redirected from either a file
  1049. or a string from the build file. The error output can be separated
  1050. to a different file when outut is redirected. standard error may be
  1051. logged to the Ant log when redirecting output to a file
  1052. * The <java> task also supports the input redirection and separate
  1053. error streams introduced to the <exec> task. In addition, it is now
  1054. possible to save the output into a property for use within the build
  1055. file as was possible with <exec> in Ant 1.5
  1056. * The <javadoc> task <tag> subelement has been enhanced to allow files
  1057. with tag mappings to be used.
  1058. * New tasks: <scp> supports file transfers, <sshexec> executes a
  1059. command over SSH. They require jsch, a BSD licensed SSH library that
  1060. can be found at http://www.jcraft.com/jsch/index.html
  1061. * New filterreader <escapeunicode/>.
  1062. * Support for HP's NonStop Kernel (Tandem) OS has been added.
  1063. * <cab>'s basedir attribute is now optional if you specify nested
  1064. filesets. Bugzilla Report 18046.
  1065. * New task <sync> that synchronizes two directory trees.
  1066. * <apply> has new forwardslash attribute that can force filenames to
  1067. use forward slashes (/) as file separators even on platforms with a
  1068. different separator. This is useful if you want to run certain
  1069. ported Unix tools.
  1070. * Copy has a new outputencoding attribute that can be used to change
  1071. the encoding while copying files. Bugzilla Report 18217.
  1072. * The xml formatter for JUnit will now honor test case names set with
  1073. setName. Bugzilla Report 17040.
  1074. * JUnit now has an attribute reloading, which, when set to false,
  1075. makes the task reuse the same class loader for a series of tests.
  1076. * <concat> now supports filtering and can check timestamps before
  1077. overriding a file. Bugzilla Report 18166.
  1078. * <junit> has a new attribute tempdir that controls the placement of
  1079. temporary files. Bugzilla Report 15454.
  1080. * <jdepend> now supports a new nested element <classespath> which is
  1081. the same as <sourcespath> but point to compiled classes (the
  1082. prefered mode of operation for JDepend > 2.5). Additionally, nested
  1083. <exclude> elements can be used to exclude certain packages from
  1084. being parsed. Bugzilla Report 17134.
  1085. * The JProbe tasks now also work with JProbe 4.x. Bugzilla Report 14849.
  1086. * <javacc> and <jjtree> will now autodetect JavaCC 3.x and can use it.
  1087. * <sql> has a new attribute to control escape processing.
  1088. * <sql> is able to display properly several resultsets if you are
  1089. running a compound sql statement. Bugzilla Report 21594.
  1090. * A new <containsregexp> selector has been added, that selects files
  1091. if their content matches a certain regular expression.
  1092. * <antlr>'s debug attribute has been enabled. Bugzilla Report 19051.
  1093. * <mail> has a new attribute charset. Bugzilla Report 15434.
  1094. * <mail> has new attributes user and password for SMTP auth.
  1095. maillogger can also use this.
  1096. The implementation only works with JavaMail (encoding="MIME").
  1097. Implementation with plain mail remains to do.
  1098. Bugzilla Report 5969.
  1099. * <mail> and mailloger support SMTP over TLS/SSL
  1100. Bugzilla Report 19180.
  1101. * <mail> the attributes from, replyto ,tolist, cclist, bcclist
  1102. can now contain email addresses of the form name <address@xyz.com>
  1103. or (name) address@xyz.com
  1104. Bugzilla Report 22474.
  1105. * <mail> (version PlainMail)
  1106. prevent blank headers from being sent,
  1107. make the order of the headers of plain mail messages predictable
  1108. Bugzilla Report 22088.
  1109. * <zipfileset> can now be defined in the main body of a project
  1110. and referred to with refid="xyz". Bugzilla Report 17007.
  1111. * A wrapper script for OS/2 has been added.
  1112. * <unzip> will now detect and successfully extract self-extracting
  1113. archives. Bugzilla Report 16213.
  1114. * <stcheckout> has a new attribute "converteol" that can be used to
  1115. control the automatic line-end conversion performed on ASCII files.
  1116. Bugzilla Report 18884.
  1117. * Users can now modify the list of default excludes using the new
  1118. defaultexcludes task. Bugzilla Report 12700.
  1119. * There is a new data type <propertyset> that can be used to collect
  1120. properties. It is supported by <ant>, <antcall>, <subant>, <java>,
  1121. <echoproperties> and <junit>.
  1122. * <concat> can now control the encoding of the output as well and optionally
  1123. add new-line characters at the end of files that get concatenated but
  1124. don't end in newlines. Bugzilla Report 12511.
  1125. * <rpm> will detect the rpmbuild executable of RedHat 8.0 and newer
  1126. and use that if it is on your PATH. Bugzilla Report 14650.
  1127. * A new task <rexec> has been added that requires commons-net to work.
  1128. Bugzilla Report 19541.
  1129. * <javadoc> now supports a nested <arg> element in addition to the
  1130. additionalparams attribute.
  1131. * You can now determine the order of standard tags in <javadoc> via
  1132. <tag> elements - you must not use the description attribute for them.
  1133. Bugzilla Report 18912.
  1134. * <javadoc> now supports the -noqualifier switch. Bugzilla Report 19288.
  1135. * <javac>'s executable attribute can now also be used to specify the
  1136. executable for jikes, jvc, sj or gcj. Bugzilla Report 13814.
  1137. * <javac> has a new attribute tempdir that can control the placement
  1138. of temporary files. Bugzilla Report 19765.
  1139. * A new magic property build.compiler.jvc.extensions has been added
  1140. that can be used to turn of Microsoft extensions while using the jvc
  1141. compiler. Bugzilla Report 19826.
  1142. * You can now limit the parallelism of <apply> and <chmod> by using the new
  1143. maxparallel attribute.
  1144. * With the new addsourcefile attribute, you can make <apply> ommit the
  1145. source file names from the command line. Bugzilla Report 13654.
  1146. * <apply> and <chmod> now support nested <filelist>s as well as <dirset>s.
  1147. Bugzilla Reports 15929 and 20687.
  1148. * <apply> and <chmod> will display a summary if you set the new
  1149. verbose attribute to true. Bugzilla Report 19883.
  1150. * <copy>/<move>'s failonerror attribute can now also be used to
  1151. continue the build if an I/O error caused a problem. Bugzilla
  1152. Report 12999.
  1153. * new selector <type/> allowing to select only files or only directories.
  1154. Bugzilla Report 20222.
  1155. * <java> and <junit> now support a nested <bootclasspath> element that
  1156. will be ignored if not forking a new VM.
  1157. * <junit>'s nested <formatter> elements now support if/unless clauses.
  1158. * <ejbjar>
  1159. cmpversion attribute added
  1160. jboss element will look for jbosscmp-jdbc.xml descriptor
  1161. if ejbjar has cmpversion="2.0" set
  1162. Bugzilla Reports 14707 and 14709.
  1163. * <pvcs> config attribute added to set the location of a specific PVCS
  1164. .cfg file
  1165. Bugzilla Report 9752
  1166. * <mapper> has an "unpackage" mapper
  1167. Bugzilla Report 18908
  1168. * Added <scriptdef> task allowing tasks to be defined using any BSF-supported
  1169. scripting language.
  1170. * <touch>'s datetime attribute can now accept time with a granularity
  1171. of seconds as well. Bugzilla Report 21014.
  1172. * <checksum> has two new properties: totalproperty and todir.
  1173. * FileUtils#createTempFile will now create temporary files in the
  1174. directory pointed to by the property java.io.tmpdir
  1175. * <unzip> and friends now supports an optional encoding attribute to
  1176. enable it to expand archives created with filenames using an encoding
  1177. other than UTF8. Bugzilla Report 10504.
  1178. * <patch> has a new attribute destfile that can be used to create a new
  1179. file instead of patching files in place.
  1180. * OpenVMS is detected as a valid OS family.
  1181. * DirectoryScanner has been optimized for cases where include patterns do not
  1182. start with wildcards. Bugzilla Report 20103.
  1183. * DirectoryScanner begins to be optimized not to scan excluded directories.
  1184. Bugzilla Report 21941.
  1185. * Added keep-going feature. Bugzilla Report 21144
  1186. * The archives generated by <zip> and friends will now contain CRC and
  1187. size information in the "local file header", thereby providing this
  1188. information to applications that read the archives using
  1189. java.util.ZipInputStream. Bugzilla Report 19195.
  1190. * <copy> and <move> can now handle mappers that return multiple
  1191. mappings per source path. This behaviour is enabled by using
  1192. an enablemultiplemapping attribute. Bugzilla Report 21320.
  1193. * <exec> will now work on OpenVMS (please read the notes in
  1194. <exec>'s manual page). Bugzilla Report 21877.
  1195. * <exec> will now have a new attribute spawn (default false).
  1196. If set to true, the process will be spawned. Bugzilla Report 5907.
  1197. * <java> will now have a new attribute spawn (default false).
  1198. If set to true, the process will be spawned. Bugzilla Report 5907.
  1199. * <parallel> now supports a timeout which can be used to recover
  1200. from deadlocks, etc in the parallel threads. <parallel> also
  1201. now supports a <daemons> nested element. This can be used to
  1202. run tasks in daemon threads which the parallel task will not
  1203. wait for before completing. A new attribute failonany will cause
  1204. <parallel> to throw an exception if any thread fails without
  1205. waiting for all other threads to complete.
  1206. * <zip> and friends will consume far less memory than they used to
  1207. when run with compress="false". Bugzilla Report 21899.
  1208. * <if/> and <unless/> attributes added to <param/> element of <style>
  1209. Bugzilla Report 22044
  1210. * <zip> and friends have a new attribute "keepcompression" that can be
  1211. used to incrementally build an archive mixing compressed and uncompressed
  1212. entries.
  1213. * <junit>'s XML formatter adds a new classname attribute to the <testcase>
  1214. elements.
  1215. * new <permissions> type add permission handling to the code
  1216. this type can be nested in the <java> and <junit> tasks.
  1217. Bugzilla Report 22533.
  1218. * additional shortcuts for ant options (-d --> -debug, -e --> -emacs,
  1219. -h --> -help, -p --> -projecthelp, -s --> -find).
  1220. * new selector <modified>. "cache" was renamed to "modified".
  1221. Bugzilla Report 20474.
  1222. * <stcheckout> and <stlist> have a new asofdate attribute that can be
  1223. used to checkout/list files based on a date instead of a label.
  1224. Bugzilla Report 20578.
  1225. * New filter <concatfilter>. Adds the content of file at the beginning
  1226. or end of a file. Discussion started at
  1227. http://marc.theaimsgroup.com/?l=ant-user&m=106366791228585&w=2
  1228. * New task <import>
  1229. * New task <macrodef>
  1230. * New task <presetdef>
  1231. * Ant libraries that can make use of namespaces to avoid name
  1232. clashes of custom tasks
  1233. * <java> and <junit> now support <assertions>, which let you enable
  1234. and disable Java1.4 assertions on a package or class basis. These
  1235. only work when fork=true, currently.
  1236. * .NET tasks expanded with VB support <vbc> and J#, via <jsharp>,
  1237. <importtypelib> and <ilasm>. <csc> supports nested <src> types,
  1238. <defines> for (potentially conditional) definitions, <reference>
  1239. filesets for references. The executable attribute lets you switch to
  1240. mono or other implementations -<csc> has been tested with Mono on
  1241. Linux and OSX.
  1242. Changes from Ant 1.5.3 to Ant 1.5.4
  1243. ===================================
  1244. Changes that could break older environments:
  1245. --------------------------------------------
  1246. * If the Visual Age tasks used to work for you, they may stop doing so
  1247. now - and we'd like to know about it. The current set of tasks is
  1248. supposed to work with any version of VAJ starting with 3.0.
  1249. Fixed bugs:
  1250. -----------
  1251. * The Visual Age for Java tasks didn't work (at least for versions 3.0
  1252. and higher). Bugzilla Report 10016.
  1253. * URL-encoding in <vaj*port> didn't work properly.
  1254. * VAJRemoteUtil called getAbsolutePath instead of getPath
  1255. causing problems when using a Windows VAJ server from a UNIX server.
  1256. Bugzilla Report 20457.
  1257. * VAJImport task failed with NullPointerException when using DirectoryScanner.
  1258. Bugzilla Report 22080.
  1259. Other changes:
  1260. --------------
  1261. * Shipped XML parser is now Xerces 2.5.0
  1262. * <javah> will invoke oldjavah on JDK 1.4.2. Bugzilla Report 18667.
  1263. * The VAJ tasks now support a haltonfailure attribute to conditionally
  1264. keep building even if they fail.
  1265. * It is now possible to use the latest (versioned or unversioned) edition
  1266. in <vajload> by using special wildcard characters. Also fixes
  1267. Bugzilla Report 2236.
  1268. Changes from Ant 1.5.2 to Ant 1.5.3
  1269. ===================================
  1270. Changes that could break older environments:
  1271. --------------------------------------------
  1272. * The <zip> task and friends have again changed a method signature
  1273. (sorry, was necessary to fix bug 17780). The return type of
  1274. getResourcesToAdd has changed.
  1275. Fixed bugs:
  1276. -----------
  1277. * <zipfileset>'s filemode would get ignored and the dirmode was used
  1278. for the included files as well. As a side effect, WinZIP was unable
  1279. to extract or display the files, so they seemed to be missing from
  1280. the archive. Bugzilla Report 17648.
  1281. * <ftp> could use the wrong path separator when trying to change the
  1282. remote working directory. Bugzilla Report 17735.
  1283. * <jar update="true"> would loose all original files if you didn't
  1284. specify any nested <(zip)fileset>s and the manifest had changed.
  1285. Bugzilla Report 17780.
  1286. * If you used a value starting with \ on Windows for the appxml
  1287. attribute of <ear> or the webxml attribute of <war>, it would be
  1288. ignored. Bugzilla Report 17871.
  1289. * Ant will no longer implicitly add Sun's rt.jar in <javac> when you
  1290. use jvc and don't specify a bootclasspath. Bugzilla Report 18055.
  1291. * The prefix attribute of <zipfileset> would not generate directory
  1292. entries for the prefix itself. Bugzilla Report 18403.
  1293. * starteam checkout can now handle deleted labels. Bugzilla Report 17646.
  1294. * The Unix wrapper script failed if you invoked it as a relative
  1295. symlink and ANT_HOME has not been set. Bugzilla Report 17721.
  1296. Other Changes:
  1297. --------------
  1298. * Added ability to specify manifest encoding for the <jar> and
  1299. <manifest> tasks
  1300. Changes from Ant 1.5.1 to Ant 1.5.2
  1301. =============================================
  1302. Changes that could break older environments:
  1303. --------------------------------------------
  1304. * ANT_OPTS environment variable is now applied at the start of the
  1305. Java command line, allowing position specific parameters of some
  1306. JVMs, such as -classic to be specified.
  1307. * ZipScanner#getIncludedFiles will now return the names of the ZipEntries
  1308. that have been matched instead of the name of the archive.
  1309. * The <zip> task and friends have been heavily modified, almost every
  1310. method signature of the Zip class has changed. If you have subclassed
  1311. Zip (or one of its subclasses), your class will most likely not
  1312. compile against the current code base. If it still compiles, it will
  1313. probably not work as in Ant 1.5.1.
  1314. Fixed bugs:
  1315. -----------
  1316. * <translate> was not ignoring comment lines.
  1317. * <manifest> wouldn't update an existing manifest if only an attribute
  1318. of an existing section changed.
  1319. * ant.bat now supports the ANT_ARGS and JAVACMD environment variables
  1320. again (like Ant 1.5 did).
  1321. * The "plain" <junit> <formatter> could throw a NullPointerException
  1322. if an error occurred in setUp.
  1323. * <junit> will now produce output when a test times out as well.
  1324. * <replace> would count some internal character replacements when
  1325. reporting the number of replaced tokens.
  1326. * <concat> would cause an exception if a <filelist> pointed to files
  1327. that do not exist.
  1328. * <javadoc> will now pass -source to custom doclets as well.
  1329. * <cvstagdiff> would throw a NullPointException if there had been no
  1330. differences.
  1331. * <cvschangelog> could miss today's changes.
  1332. * <concat> could append newline characters between concatenated files.
  1333. * <xmlvalidate> ignored the specified encoding of the files to
  1334. validate.
  1335. * the errorsbeginat attribute of the <http> condition didn't work.
  1336. * Ant will try to force loading of certain packages like com.sun.*
  1337. from the system classloader. The packages are determined by the
  1338. version of the JVM running Ant.
  1339. * Ant didn't find the runtime libraries on IBM's JDK 1.4 for Linux.
  1340. * random component of temporary files is now always a positive integer.
  1341. * Ant could incorrectly try to use the 1.4 regexp implementation even
  1342. if it isn't available if you run the JVM with -Xverify:none.
  1343. * Ant would die with an exception if you used nested <reference>
  1344. elements in Ant and the refid attribute didn't point to an existing
  1345. project reference.
  1346. * The <get> task can now be compiled (and Ant thus bootstrapped) using
  1347. Kaffee.
  1348. * build.sysclasspath will now be honored by more tasks.
  1349. * The signjar keystore attribute has been reverted to a String allowing
  1350. it to once again accept URLs. This should not affect current File based usage
  1351. unless you are extending the Signjar task.
  1352. * <jar update="true"> would remove the original manifest.
  1353. * fix up folder creation in PVCS task
  1354. * <tar>'s up-to-date check didn't work for nested <(tar)fileset>s.
  1355. * Corrected a problem in XMLLogger where it would not associated
  1356. messages with a taskdef'd task
  1357. * <uptodate> now works when using attributes (i.e. not filesets) and pointing
  1358. to the same file
  1359. * Java task (and output system) now stores output which doos not end
  1360. with a line feed.
  1361. * splash screen wouldn't disappear when build was finished.
  1362. * <exec> now supports OS/2.
  1363. * <zip> and friends would only update/recreate existing archives if
  1364. the files to add/update have been newer than the archive.
  1365. * <javadoc>'s <link> element could fail for offline="true" on some JDKs.
  1366. Other changes:
  1367. --------------
  1368. * MailLogger now sets the Date header correctly.
  1369. * Shipped XML parser is now Xerces 2.3.0
  1370. * signjar now accepts a maxmemory attribute to allow the memory allocated to the
  1371. jarsigner tool to be specified. The jarsigner from the JDK's JAVA_HOME bin
  1372. dir is now used rather than the first jarsigner on the path.
  1373. * **/.DS_Store has been added to the list of default pattern excludes.
  1374. * The Created-By header in the default manifest now contains the JVM
  1375. vendor and version according to the jar specification. A new header,
  1376. Ant-Version provides the Ant version used to create the jar.
  1377. * <zip> can now store Unix permissions in a way that can be
  1378. reconstructed by Info-Zip's unzip command.
  1379. Changes from Ant 1.5.1Beta1 to 1.5.1
  1380. ====================================
  1381. Fixed bugs:
  1382. -----------
  1383. * <tstamp>'s prefix attribute failed to apply to nested <format> elements.
  1384. * <junitreport> created an empty junit-noframes.html if no format had
  1385. been specified.
  1386. * <basename> would remove more than it should if the file name
  1387. contained more than one dot.
  1388. * <filterset>s nested into <filterset>s didn't work.
  1389. Other changes:
  1390. --------------
  1391. * Shipped XML parser is now Xerces 2.2.0
  1392. * Filesets now support a 'file' attribute, allowing a single-file
  1393. fileset to be constructed without having to specify its parent
  1394. directory separately.
  1395. * <junit> will now return the result of a call to getName instead of
  1396. "unknown" for Test implementations that don't extend TestCase but have
  1397. a public String getName() method.
  1398. Changes from Ant 1.5 to 1.5.1Beta1
  1399. ==================================
  1400. Fixed bugs:
  1401. -----------
  1402. * Date/time in CvsChangeLog was in local timezone and 12 hour format leading
  1403. to a problem when sorting by time. It is now UTC (GMT) and in 24-hour
  1404. format as per cvs 'specifications'.
  1405. * CvsTagDiff now supports ampersand modules or modules that have a different
  1406. root directory than their name.
  1407. * EjbJar threw NPEs for the Websphere element. The property 'websphere.home'
  1408. was not documented.
  1409. * Mail example in the documentation was not correct.
  1410. * Checksum was broken in the following scenario:
  1411. (using verifyproperty OR in a condition) AND using filesets
  1412. with multiple files.
  1413. * The ExpandProperties filter threw NPEs when defined using
  1414. the <filterreader> format.
  1415. * The sh wrapper script didn't work under Cygwin if ANT_HOME wasn't
  1416. set with a Unix style filename.
  1417. * The sh wrapper script could fail if you started Ant from a directory
  1418. with whitespace in its name.
  1419. * ant -diagnostics was not working properly when the task dependency
  1420. was missing and was just printing the missing dependency.
  1421. * If a task got redefined via <taskdef>, it lost its child elements.
  1422. * <property>'s classpathref attribute was broken.
  1423. * <arg line="''" /> would result in no command line argument, will now
  1424. be a single empty argument. Use <arg value="''"/> if you need the
  1425. quotes literally.
  1426. * <replaceregexp> could append a newline character at the end of the
  1427. file.
  1428. Other changes:
  1429. --------------
  1430. * Appendix E of Java Development with Ant (Loughran/Hatcher) was
  1431. contributed to the docs.
  1432. * <available> will only print deprecration warnings if it is actually
  1433. used to change the value of a property.
  1434. Changes from Ant 1.5beta3 to Ant 1.5
  1435. ====================================
  1436. Changes that could break older environments:
  1437. --------------------------------------------
  1438. * The filesetmanifest attribute added to <jar> after the 1.4.1
  1439. release has been removed for now. This change may affect only
  1440. the 1.5Beta/1.6Alpha users. An attempt will be made to add this
  1441. feature back into Ant 1.6.
  1442. Fixed bugs:
  1443. -----------
  1444. * <zip> and friends would always update existing archive if you set
  1445. the update attribute to true.
  1446. * To support backward compatibility with older versions, <pathconvert>
  1447. will once again set the property, even if the result is the empty
  1448. string, unless the new 'setonempty' attribute is set to false|no|off
  1449. (default is "true").
  1450. * The manifest task would crash XmlLogger
  1451. Other changes:
  1452. --------------
  1453. * added **/.svn and **/.svn/** to the default excludes
  1454. Changes from Ant 1.5beta2 to Ant 1.5beta3
  1455. =========================================
  1456. Changes that could break older environments:
  1457. --------------------------------------------
  1458. * <pvcs> default filenameformat has been different from Ant 1.4.1.
  1459. Now it is different from 1.5beta1 and 1.5beta2.
  1460. * <pathconvert> won't set the property if the result is the empty string.
  1461. Fixed bugs:
  1462. -----------
  1463. * <available> could fail to find files or directories that happen to
  1464. start with the name of the project's basedir but are not children of
  1465. the basedir.
  1466. * Nested <property>'s inside <ant> can now be overriden by subsequent
  1467. <ant> and <antcall> tasks.
  1468. * <xslt>'s outputtype attribute wouldn't do anything.
  1469. * <linecontains> filterreader could swallow lines.
  1470. * <sequential> used to configure the tasks (set their attributes)
  1471. before the first task has been executed. This means that properties
  1472. that have been set by nested task seemed to be unset for the other
  1473. tasks in the same <sequential> element.
  1474. * <javac>'s sourcepath setting has been ignored by some compiler
  1475. implementations.
  1476. * <javadoc>'s packagelist attribute didn't work.
  1477. * the plain mailer would always use port 25 in <mail>.
  1478. * Ant's default logger could swallow empty lines.
  1479. * ejbjar's iPlanet nested element now can process multiple descriptors.
  1480. * IPlanetEjbc was looking in the wrong place for four iiop files.
  1481. * <javac> would pass the -source switch to JDK 1.3's javac, even
  1482. though it doesn't support it.
  1483. Other changes:
  1484. --------------
  1485. * <checksum> now uses a buffer (of configurable size).
  1486. * The "Trying to override task definition" warning has been degraded
  1487. to verbose level if the two task definitions only differ in the class
  1488. loader instance that has loaded the definition.
  1489. * Add a jvmargs to the ejbjar's weblogic element to allow additional
  1490. arguments to be provided to the VM runnign ejbc. Document the
  1491. jvmdebuglevel attribute which can be used to avoid warnings about
  1492. interface classess being found on the classpath. Document the new
  1493. <sysproperty> element which allows JVM properties to be defined.
  1494. Added an outputdir attribute to allow the destination to be a
  1495. directory into which the exploded jar is written.
  1496. * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
  1497. Changes from Ant 1.5beta1 to Ant 1.5beta2
  1498. =========================================
  1499. Changes that could break older environments:
  1500. --------------------------------------------
  1501. * Properties will now be expanded in mail message bodies. This means
  1502. that one $ sign will be stripped if your mail message contains the text $$.
  1503. * org.apache.tools.ant.taskdefs.Expand no longer extends MatchingTask.
  1504. * Available#setFile now again uses a File argument as it did in 1.4,
  1505. this may break environments that have been adapted to the String
  1506. argument version present in 1.5beta1.
  1507. Fixed bugs:
  1508. -----------
  1509. * When <move> attempts a rename, it deletes the destination file, if it
  1510. exists, before renaming the source file. However, <move> was not
  1511. checking if the destination file was actually a directory before
  1512. trying to delete it.
  1513. * Make CVS Tasks to work under Cygwin.
  1514. * Fix LineContains to handle huge files elegantly without causing
  1515. Stack Overflows.
  1516. * if you ask for the "classic" compiler on Java1.4, you get upgraded to
  1517. "modern" because there is no classic compiler any more.
  1518. * the <http> condition was viewing 404 'not found' exceptions as success. Now
  1519. it defaults to viewing any response >=400 as an error, and has an
  1520. errorsBeginAt attribute you can use if you want a higher or lower value.
  1521. * <get> throws a build exception on an http authorization error, unless you
  1522. have set ignoreerrors to true.
  1523. * <wsdltodotnet> was spelt in Wintel case: <WsdlToDotnet>. It is now lower
  1524. case, though the old spelling is retained for anyone who used it.
  1525. * Merging of Manifests in jar now works as documented.
  1526. * paths that have been separated by colons would be incorrectly parsed
  1527. on NetWare.
  1528. * runant.pl now supports NetWare.
  1529. * <tempfile> and <setproxy> tasks were in beta1, but not defined by
  1530. default; They now are. <tempfile> fills a property with the name of a
  1531. temporary file; <setproxy> lets you set the JVM's http, ftp and socks proxy
  1532. settings.
  1533. * <available classname="foo" ignoresystemclasses="true"> failed for
  1534. JDK 1.1 and 1.2, even if the class could be found on the
  1535. user-specified classpath.
  1536. * <property environment=... /> now works on z/OS.
  1537. * forked <javac> failed for the wrong reason on JDK 1.1 - Ant would
  1538. use a temporary file to hold the names of the files to compile under
  1539. some conditons, but 1.1 doesn't support this feature. Ant will no
  1540. longer try this, but you may run into problems with the length of the
  1541. command line now.
  1542. * the refid attribute for <property>s nested into <ant> or <param>s
  1543. nested into <antcall> didn't work.
  1544. * <replaceregexp> didn't work for nested <fileset>s.
  1545. * <javadoc> dropped sourcepath entries if no "interesting" .java
  1546. source files could be found below them. This has been backwards
  1547. incompatible and caused problems with custom doclets like xdoclet.
  1548. * Using the doclet, docletpath or docletpathref attributes of
  1549. <javadoc> may have caused NullPointerExceptions.
  1550. * nested <filesets> of <javadoc> would include too much.
  1551. * <dependset> will no longer choke on <targetfileset>s that point to
  1552. non-existing directories.
  1553. * <patch> didn't work at all.
  1554. * <replace> and <replaceregexp> now fail if the file they are working
  1555. on is locked.
  1556. * <javadoc> would pick up the wrong executable in the combination JDK
  1557. 1.2 and AIX.
  1558. Other changes:
  1559. --------------
  1560. * z/OS now gets detected by the os condition.
  1561. * <fileset> and <dirset> now have an optional followsymlink attribute
  1562. that can prevent Ant from following symbolic links on some platforms.
  1563. * BeanShell is now supported in the <script> task.
  1564. * <ejbjar> under Weblogic attempts to use the ejbc20 compiler for 2.0 beans
  1565. based on the deployment descriptor's DTD reference. Under weblogic 7.00 Beta
  1566. this ejbc class has been deprecated. To avoid the deprecation warning use
  1567. ejbcclass="weblogic.ejbc".
  1568. * <ejbjar> will add a manifest to the generated jar based on the naming
  1569. convention in use. This overrides the manifest specified in the
  1570. <ejbjar> attribute
  1571. Changes from Ant 1.4.1 to 1.5beta1
  1572. ==================================
  1573. Changes that could break older environments:
  1574. --------------------------------------------
  1575. * Important: Single $ signs are no longer silently stripped!
  1576. Before you panic that we have broken all your build files, we have kept
  1577. the old "$$" -> "$" behaviour. So only build files which accidentally had
  1578. a $ sign in a string that was being silently stripped may break.
  1579. We added this fix to stop newbie confusion; if you want to write a
  1580. build file which works on ant versions 1.4.1 or earlier, stay with
  1581. the double $$ sign rule.
  1582. * Project.getBuildListeners now returns a clone of the listener
  1583. list. Changes to the returned list will not affect the listeners
  1584. currently attached to the Project. It also means that it is safe to
  1585. iterate over the returned list if listeners are added or removed
  1586. during the traversal.
  1587. * <pvcs> default filenameformat has been different from Ant 1.4.1.
  1588. * Some messages that are printed during startup will not be
  1589. written to the logfile specified via -logfile as they might destroy
  1590. the format of the file for special BuildLoggers (like XmlLogger).
  1591. * The filesetmanifest attribute added to <jar> after the 1.4.1
  1592. release has been removed for now. This change may affect only
  1593. the 1.5Beta/1.6Alpha users. An attempt will be made to add this
  1594. feature back into Ant 1.6.
  1595. * Shipped XML parser is now Xerces 2.0.1 along with the XML Parser APIs.
  1596. XML Parser APIs is a separate jar that contains the necessary
  1597. JAXP/DOM/SAX classes.
  1598. * <telnet> was fixed to expand properties inside nested <read> and
  1599. <write> elements; before this only happened when you assigned the text
  1600. to the string attribute. If you had $ signs in the string, they may
  1601. need escaping.
  1602. * the RegexpMatcher interface has been extended to support case
  1603. insensitive matches and other options - custom implementations of
  1604. this interface won't work any longer. We recommend to use the new
  1605. Regexp interface that also supports substitution instead of the
  1606. RegexpMatcher interface in the future.
  1607. * <gzip> will throw an exception if your src attribute points to a directory.
  1608. * Unjar, Unzip and Unwar will throw an exception if the Src attribute
  1609. represents a directory. Support for nested filesets is provided
  1610. instead.
  1611. * It is no longer possible to overwrite a property using tasks like
  1612. <condition>, <exec>, <pathconvert>, or <tstamp>. In some exceptional
  1613. cases it will generate a warning if you attempt to overwrite an
  1614. existing property.
  1615. * Taskwriters please note: Whenever tasks had any overloaded set* methods,
  1616. Ant's introspection mechanism would select the last overloaded method
  1617. provided to it by the Java Runtime. A modification has now been made such
  1618. that when the Java Runtime provides a method with a String as its argument,
  1619. a check is made to see if there is another overloaded method that takes in
  1620. some other type of argument. If there is one such method, then the method
  1621. that takes in String as an argument is not selected by the Introspector.
  1622. * The pattern definition **/._* has been included into the Default
  1623. Excludes list.
  1624. * <propertyfile>'s <entry> element was modified to remove "never" as a value
  1625. as its behavior was undocumented and flakey.
  1626. * The -projecthelp flag now only prints out targets that include the
  1627. 'description' attribute, unless the -verbose or -debug flag is included
  1628. on the Ant command line.
  1629. * Ant's testcases now require JUnit 3.7 or above, as they now use the new
  1630. assertTrue method instead of assert.
  1631. * If the 'output' attribute of <ant> is set to a simple filename or a
  1632. relative path, the file is created relative to ${basedir}, not ${user.dir}.
  1633. * The default value for build.compiler is now javac1.x with x
  1634. depending on the JDK that is running Ant instead of classic/modern.
  1635. Fixed bugs:
  1636. -----------
  1637. * <available> could fail to find files or directories that happen to
  1638. start with the name of the project's basedir but are not children of
  1639. the basedir.
  1640. * Nested <property>'s inside <ant> can now be overriden by subsequent
  1641. <ant> and <antcall> tasks.
  1642. * <xslt>'s outputtype attribute wouldn't do anything.
  1643. * <linecontains> filterreader could swallow lines.
  1644. * <sequential> used to configure the tasks (set their attributes)
  1645. before the first task has been executed. This means that properties
  1646. that have been set by nested task seemed to be unset for the other
  1647. tasks in the same <sequential> element.
  1648. * <javac>'s sourcepath setting has been ignored by some compiler
  1649. implementations.
  1650. * <javadoc>'s packagelist attribute didn't work.
  1651. * the plain mailer would always use port 25 in <mail>.
  1652. * Ant's default logger could swallow empty lines.
  1653. * ejbjar's iPlanet nested element now can process multiple descriptors.
  1654. * IPlanetEjbc was looking in the wrong place for four iiop files.
  1655. * <javac> would pass the -source switch to JDK 1.3's javac, even
  1656. though it doesn't support it.
  1657. * <zip> and friends would always update existing archive if you set
  1658. the update attribute to true.
  1659. * To support backward compatibility with older versions, <pathconvert>
  1660. will once again set the property, even if the result is the empty
  1661. string, unless the new 'setonempty' attribute is set to false|no|off
  1662. (default is "true").
  1663. * The manifest task would crash XmlLogger
  1664. * A bug existed that prevented generated log files from being deleted as
  1665. part of the build process itself. This has now been fixed.
  1666. * Fixed bug where <move> ignored <filterset>s.
  1667. * Ant works properly with the combination of Java1.4/WindowsXP.
  1668. * Fixed bug where <java> used to sometimes invoke class constructors twice.
  1669. * Fixed bug with 4NT shell support.
  1670. * Fixed bug where ant would not perform ftp without remotedir being
  1671. specified even though this was not mandatory.
  1672. * Fixed bug where ant would not copy system properties into new Project
  1673. in ant/antcall tasks when inheritall="false" is set.
  1674. * <propertyfile> would not close the original property file.
  1675. * <ant> will no longer override a subbuild's basedir with inheritall="true".
  1676. * Fixed problem with the built-in <junit> formatters which assumed
  1677. that only one test could be running at the same time - this is not
  1678. necessarily true, see junit.extensions.ActiveTestSuite.
  1679. * <jar>'s whenEmpty attribute is useless as JARs are never empty, they
  1680. contain at least a manifest file, therefore it will now print a
  1681. warning and do nothing.
  1682. * <typedef> hasn't been all that useful as it couldn't be used outside
  1683. of targets (it can now) and nested "unknown" elements have always
  1684. been considered to be tasks (changed as well).
  1685. * <fixcrlf> would fail for files that contained lines longer than 8kB.
  1686. * Some junit formatters incorrectly assumed that all testcases would
  1687. inherit from junit.framework.TestCase.
  1688. * <fixcrlf> dropped the first characters from Mac files.
  1689. Other changes:
  1690. --------------
  1691. * <checksum> now uses a buffer (of configurable size).
  1692. * The "Trying to override task definition" warning has been degraded
  1693. to verbose level if the two task definitions only differ in the class
  1694. loader instance that has loaded the definition.
  1695. * Add a jvmargs to the ejbjar's weblogic element to allow additional
  1696. arguments to be provided to the VM runnign ejbc. Document the
  1697. jvmdebuglevel attribute which can be used to avoid warnings about
  1698. interface classess being found on the classpath. Document the new
  1699. <sysproperty> element which allows JVM properties to be defined.
  1700. Added an outputdir attribute to allow the destination to be a
  1701. directory into which the exploded jar is written.
  1702. * ejbjar now supports Borland Enterprise Server 5 and Jonas 2.5
  1703. * added **/.svn and **/.svn/** to the default excludes.
  1704. * Selector Elements now provide a way to create filesets based on
  1705. sophisticated selection criteria.
  1706. * Gzip and Bzip2 files can now be constructed in the fly when using
  1707. the tar task without having to create the intermediate tar file on
  1708. disk. The Untar task can also untar GZip and BZip2 files on the fly
  1709. without creating the intermediate tar file.
  1710. * New optional type, <classfileset> added.
  1711. * <ejbjar> now allows control over which additional classes and interfaces
  1712. are added to the generated EJB jars. A new attribute "dependency" can be
  1713. defined which controls what classes are added. The addition of classes now
  1714. uses the Jakarta-BCEL library rather than reflection, meaning bean classes are
  1715. no longer loaded into Ant's JVM. The default dependency analyzer is known as
  1716. the ancestor analyzer. It provides the same behaviour as the 1.4.1 version of
  1717. <ejbjar>. If the BCEL library is not present, a warning will be issued stating
  1718. the ancestor analyzer is not available. In this case <ejbjar> will continue
  1719. to function but will not add super classes to the jar.
  1720. * <available> has a new attribute named ignoreSystemClasses.
  1721. * New task <cvschangelog/> generates an XML report of changes that occur
  1722. on CVS repository.
  1723. * New filter readers: ClassConstants, ExpandProperties, HeadFilter,
  1724. LineContains, LineContainsRegExp, PrefixLines, ReplaceTokens,
  1725. StripJavaComments, StripLineBreaks, StripLineComments, TabsToSpaces,
  1726. TailFilter.
  1727. * <copy>, <loadfile>, <loadproperties>, <move> support FilterChains
  1728. of FilterReaders.
  1729. * New task <loadproperties> to load contents of file as Ant properties,
  1730. with nested <filterchain> elements.
  1731. * New task <loadfile> to load a whole file into a property.
  1732. * New task <echoproperties> to list your current properties to the screen
  1733. or a file.
  1734. * New tasks <bzip2> and <bunzip2> to pack and unpack files using the
  1735. BZip2 alogrithm.
  1736. * New tasks <replaceregexp>, <checksum>, <translate>, <waitfor>,
  1737. <manifest>, <vsscp>, <vssadd>, <vsscreate>, <splash>, <basename>, <dirname>,
  1738. <concat>, <sourceoffsite>, <jarlib-available>, <jarlib-display>,
  1739. <jarlib-manifest>, <jarlib-resolve>.
  1740. * A new combined <mail> task, which replaces the old <mail> and
  1741. <mimemail> tasks, has been added. The <mimemail> task, and
  1742. old SendEmail and MimeMail classes have been deprecated.
  1743. * Mail task allows specification of port number.
  1744. * Users can control what <zip> and <jar> must do when duplicate files
  1745. are found. A new element <zipgroupfileset> allows for multiple zip
  1746. files to be merged into the archive. In addition, <jar> also has
  1747. another new attribute: filesetmanifest. The existing manifest
  1748. attribute of <jar> now also accepts the name of a jar added through
  1749. a fileset.
  1750. * gzip now checks that the zipfile is older than the source file
  1751. before rebuilding the zipfile.
  1752. * TarFileset takes in three new attributes - fullpath, prefix
  1753. and preserveLeadingSlashes.
  1754. * <move> attempts to rename the directory, if everything inside it is
  1755. included, before performing file-by-file moves. This attempt will
  1756. be done only if filtering is off and if mappers are not used. This
  1757. is a performance improvement and there is no change otherwise in
  1758. the funtionality of this task.
  1759. * Exec task has extra attribute "resultproperty" to get the return code
  1760. into a property.
  1761. * Exec task prints a message when a timed-out process is killed.
  1762. * Added optional attributes - name, arch and version to the <os> task.
  1763. * Unjar, Untar, Unwar and Unzip now support patternsets to
  1764. select files from an archive for extraction. Filesets may be
  1765. used to select archived files for unarchival.
  1766. * Javac task allows debug levels to be specified. Debug levels
  1767. will have an effect only when the modern compiler or the
  1768. classic compiler (version 1.2 and higher) is used and debugging
  1769. is enabled.
  1770. * Added support for specifying CVS_RSH in the <cvs/> task
  1771. * The attributes zipfile, jarfile, warfile and earfile (from the Zip,
  1772. Jar, War and Ear tasks) have been deprecated and superseded by a
  1773. new attribute "destfile".
  1774. * Added new conditions <isset>, <checksum>, <http>, <socket>, <contains>,
  1775. <filesmatch>.
  1776. * <taskdef> and <typedef> will now emit a warning if a task/type of
  1777. the given name already exists.
  1778. * A new revision of VAJ tasks: The most important new feature
  1779. is the ability to execute VAJ tasks from the command line by
  1780. exploiting the Remote Tool Access feature of VAJ.
  1781. * Improved support for Novell NetWare.
  1782. * Added an optional encoding attribute to <fixcrlf>.
  1783. * <apply> has a new attribute relative that allows users to pass the
  1784. filenames as relative instead of absolute paths on the command line.
  1785. * References can now be copied into the child build by <ant> and
  1786. <antcall> using nested <reference> elements or the new inheritRefs
  1787. attribute.
  1788. * <fail> now supports builds to fail based on conditions via if and
  1789. unless attributes.
  1790. * Ant now comes with two new BuildLogger implementations - one that
  1791. can send emails containing a log of the build process (MailLogger),
  1792. and one that colorizes the output based on message levels, using
  1793. ANSI color code escape sequences (AnsiColorLogger).
  1794. * A "package" mapper type has been added to allow package directory
  1795. names replaced with the dotted form.
  1796. * You can now specify environment variables in the <java> and <junit> tasks
  1797. if the fork attribute has been set to true.
  1798. * -propertyfile command-line option has been added to load an entire
  1799. property file just as -D properties are declared (as user properties).
  1800. -D properties take precedence over -propertyfile specified ones.
  1801. * You can now set an ANT_ARGS environment variable to hold arguments you
  1802. always want passed to the 'ant' command -- for example, if you always
  1803. want to use a different logger or the -find flag.
  1804. * <tstamp> now supports a new "prefix" attribute to prefix properties set.
  1805. * You can now specify the -sourcepath for <javac> explicitly.
  1806. * <javac> now supports a new "listfiles" attribute to list the source
  1807. files it's handing off to the compiler.
  1808. * The compiler implementation for <javac> can now be chosen on a task by
  1809. task basis. The new "compiler" attribute of <javac> can be used to override
  1810. the value of the build.compiler property, if set.
  1811. * <javac> has a new nested element, <compilerarg>, which allows you
  1812. to specify additional args for the specific compiler you're using.
  1813. * <javac>'s "source" attribute is now enabled for jikes as well.
  1814. * <propertyfile>'s <entry> now has a 'unit' attribute to specify the
  1815. increment/decrement unit on date operations.
  1816. * <property> now supports a 'prefix' attribute when loading from a file
  1817. or resource.
  1818. * In Ant 1.4, a feature has been added to the <junit> task that would
  1819. add ant.jar, optional.jar and junit.jar implicitly to the classpath -
  1820. this feature can now be disabled by setting the new includeantruntime
  1821. attribute to false.
  1822. * <style> behaves differently from any other directory-based task, as it
  1823. processes all files that it finds in included directories in
  1824. addition to the files matched by your patterns. There is now a new
  1825. attribute, 'scanincludeddirectories', to suppress this behavior.
  1826. * <javadoc> now supports a <tag> nested element to provide the -tag option
  1827. to the standard Java 1.4 doclet. The element is ignored when not running
  1828. on Java 1.4.
  1829. * <ftp> can now chmod files on a remote server that supports
  1830. "site chmod", as well as set the umask before transferring files, if
  1831. the server supports "site umask".
  1832. * New <serverdeploy> "optional" task.
  1833. * <patternset> now supports nested patternsets.
  1834. * Perforce tasks now support a "failonerror" attribute (defaults to "true").
  1835. * Open Source application server JOnAS support:
  1836. EJB hot deploy and deploy with <serverdeploy> and <ejbjar>
  1837. * Added new DirSet (<dirset>) datatype.
  1838. * <path> now supports nested <dirset> and <filelist> elements.
  1839. * <pathconvert> now supports nested <dirset> and <filelist> elements.
  1840. * <pathconvert>'s "dirsep" and "pathsep" attributes now accept
  1841. multi-character values.
  1842. * <copy> task now has a 'failonerror' attribute to allow keep-going
  1843. behaviour when the file to be copied is not found (defaults to "true").
  1844. * <uptodate> now has a 'srcfile' attribute to allow specifying a
  1845. full-path filename.
  1846. * <exec>, <sql> and <java> now support append attributes to allow
  1847. appending the output to an existing file.
  1848. * <java> now supports a timeout attribute analog to <exec> - it is
  1849. highly recommended to only use it together with fork="true".
  1850. * <javadoc> now supports a source attribute to enable javadoc to
  1851. handle assertions present in JDK 1.4 source code.
  1852. * <replace> supports a new replacefilterfile attribute that
  1853. automatically turns all properties of a given file into
  1854. replacefilters.
  1855. * An alias of <xslt> has been added to refer to the <style> task.
  1856. * The compiler implementation for <rmic> can now be chosen on a task by
  1857. task basis. The new "compiler" attribute of <rmic> can be used to override
  1858. the value of the build.rmic property, if set.
  1859. * <rmic> has a new nested element, <compilerarg>, which allows you
  1860. to specify additional args for the specific compiler you're using.
  1861. * org.apache.tools.ant.XmlLogger now is a BuildLogger, rather than just
  1862. a BuildListener. It can operate in either mode successfully.
  1863. * <junit> has a new attribute "showoutput". If set to true, output
  1864. generated by tests will be sent to Ant's logging system as well as
  1865. to the formatters (instead of sending it to the formatters
  1866. exclusively).
  1867. * Ant has now a pluggable way to prompt users for input, which is used
  1868. by the new <input> task. IDE integrators can provide an
  1869. implementation of the InputHandler interface to decouple Ant's input
  1870. from the console. An implementation that gets its input from a file
  1871. for unattended builds is part of Ant's distribution.
  1872. For more details see docs/manual/inputhandler.html.
  1873. * <patch> has a new attribute that selects the directory in which to
  1874. run the command.
  1875. * <javadoc> now supports two new nested elements, <fileset> and <packageset>.
  1876. Changes from Ant 1.4 to Ant 1.4.1
  1877. ===========================================
  1878. Fixed bugs:
  1879. -----------
  1880. * <ant>'s antfile attribute will now also be considered an absolute path on
  1881. Windows systems, if it starts with a \ and no drive specifier.
  1882. * The fullpath attribute of <zipfileset> has been ignored if you used
  1883. the src attribute at the same time.
  1884. * The manifest file is now always placed as the second entry (after /META-INF)
  1885. in generated jars. This allows the manifest to be read by JarInputStreams
  1886. * Fixed bug in depend task which would fail with a NullPointerException if no
  1887. dependency cache was specified.
  1888. * sql task now handles REM statements correctly so that lines starying with rem
  1889. but which are not comments are actually processed.
  1890. * XMLLogger now uses the task's name rather than the classname
  1891. * <mapper>s will now work as expected if the to pattern expands to an
  1892. absolute pathname.
  1893. * <javac> didn't ignore memory settings in non-fork mode
  1894. * <cab> didn't split the options attribute into several command line
  1895. arguments correctly.
  1896. Other changes:
  1897. --------------
  1898. * New source attribute for <javac> to enable assertion in JDK 1.4
  1899. * XmlLogger and <antstructure> now add an encoding declaration to the
  1900. XML files they generate.
  1901. * <fileset> has a new attribute "casesensitive" to make it match
  1902. filenames in a case insensitive way (if you set it to false) - by
  1903. default filesets remain case sensitive.
  1904. Changes from Ant 1.3 to Ant 1.4
  1905. ===========================================
  1906. Changes that could break older environments:
  1907. --------------------------------------------
  1908. * JUnitReport now uses the xalan redirect extension for multi-output.
  1909. With Xalan 1.2.2 it forces the use of bsf.jar in the classpath.
  1910. (Available in the xalan distribution). It is recommended to switch
  1911. to Xalan 2.x that do not need it.
  1912. * Zip.setWhenempty() has changed its signature.
  1913. * <rmic> is now implemented using a factory. This makes extending
  1914. rmic to use a new compiler a lot easier but may break custom
  1915. versions of this task that rely on the old implementation.
  1916. * several Zip methods have changed their signature as we now use a Zip
  1917. package of our own that handles Unix permissions for directories.
  1918. Furthermore <zip> will now use the platform's default character
  1919. encoding for filenames - this is consistent with the command line
  1920. ZIP tools, but causes problems if you try to open them from within
  1921. Java and your filenames contain non US-ASCII characters. Use the new
  1922. encoding attribute of the task and set it to UTF8 to get the old
  1923. behavior.
  1924. * The <pvcs> task has been moved to a package of its own.
  1925. * JUnitResultFormater has two additional methods that must be
  1926. implemented by custom formatters.
  1927. * Ant will no longer use the canonical version of a path internally -
  1928. this may yield different results on filesystems that support
  1929. symbolic links.
  1930. * The output generated by the xml formatter for <junit> has changed
  1931. again, it doesn't format the numeric value in the time attribute anymore.
  1932. * Pattern matching rules have changes slightly, the pattern foo*
  1933. doesn't match files contained in a directory named foo - use foo/*
  1934. instead.
  1935. * <fixcrlf> will not remove trailing whitespace at the end of lines anymore.
  1936. * The Classloader usage has been changed for the taskdef, property, available
  1937. and sql tasks so that it delegates to the parent classloader. This may cause
  1938. ClassNotFoundExceptions to be thrown if a system class attempts to load a
  1939. class in the taskdef's classpath (typically factory objects).
  1940. * Ant now allows multithreading of tasks and the containment of tasks within
  1941. other tasks. This can break customer listeners which do not expect messages
  1942. from a task before the previous task has finished.
  1943. * Ant now installs its own ouput stream into System.out to route output to the
  1944. task currently executing on the current thread. This also means that all
  1945. output is now routed as Ant message events. Customer listeners and loggers
  1946. should not call System.out at any time. This has always been true but such
  1947. usage now will cause problems due to possible recursion.
  1948. * Invalid manifest files will now cause build failures in the <jar> task.
  1949. * Ant Introspection now looks for methods with method names starting with
  1950. addConfigured. When called these methods are passed an argument after it has
  1951. been configured from the build file. Custom tasks supporting nested elements
  1952. starting with the name configured will no longer function.
  1953. * The environment variable JAVACMD that can be used to specify the
  1954. java executable to Ant's wrapper scripts must not contain additional
  1955. command line parameters any longer - please use the environment
  1956. variable ANT_OPTS for such parameters now.
  1957. * Ant's wrapper scripts now quote the CLASSPATH environment variable, thus
  1958. supporting classpaths which refer to directories containing spaces. This means
  1959. that the CLASSPATH environment variable cannot have quotes. Any quotes should
  1960. be removed. This will not affect the operation of the CLASSPATH environment
  1961. variable in other contexts.
  1962. * A delete task like
  1963. <delete includeEmptyFilesets="true">
  1964. <fileset dir="somedir" />
  1965. </delete>
  1966. will now remove "somedir" as well, unless there are still files left
  1967. in it (matched by the default excludes).
  1968. * The copy task will now fail if the file to be copied is not found.
  1969. * Ant properties defined in properties files now behave the same way as
  1970. properties defined in the build file. In particular the $ character needs
  1971. to be escaped in property values by doubling it to $$. So, to define a
  1972. property with the value $hello, you need to define it in a properties file
  1973. as
  1974. test.prop=$$hello
  1975. This was not the case in Ant 1.3
  1976. Other changes:
  1977. --------------
  1978. * New tasks: ear, p4counter, record, cvspass, vsscheckin, vsscheckout,
  1979. typedef, sleep, mimemail, set of tasks for Continuus/Synergy, dependset,
  1980. condition, maudit, mmetrics, jpcoverage, jpcovreport, jpcovmerge
  1981. * Ant now uses JAXP 1.1
  1982. * rmic now supports Kaffe's and Weblogic's version of rmic.
  1983. * new magic property build.rmic to chose the rmic implementation
  1984. * <tar> will now add empty directories as well
  1985. * you can now specify a description for <p4change>
  1986. * <touch> can now work on <fileset>s
  1987. * <uptodate> now supports a value attribute
  1988. * <fail> supports nested text
  1989. * <fixcrlf> won't override files that are already in the correct
  1990. format.
  1991. * <sql> now supports REM comments as well as // and --
  1992. * <jar> now has a nested <metainf> element following the same idea as
  1993. <war>'s <webinf>.
  1994. * <pvcs> can now handle multiple projects.
  1995. * <available> now has a "type" attribute you can use in conjunction
  1996. with the "file" attribute to specify whether the "file" you're
  1997. looking for is a file or a directory.
  1998. * New <junit> formatter named "brief"
  1999. * <ejbjar> changes
  2000. * Add support for Borland Application Server to the <ejbjar> task using
  2001. a <borland> nested element.
  2002. * Add support for iPlanet Application Server to the <ejbjar> task. Also
  2003. includes some iPlanet utility tasks
  2004. * Add support for JBoss Application Server to the <ejbjar> task.
  2005. * Add a naming attribute to control the naming scheme that
  2006. ejbjar uses to name the generated EJB jars.
  2007. * Weblogic element now sets the compiler class for EJB 2.0 beans
  2008. * <dtd> elements can be specified at the <ejbjar> level for building generic
  2009. beans
  2010. * <dtd> elements can now be URLs
  2011. * Allow the manifest to be specified for the generated jars
  2012. * The weblogic element now supprts an attribte noEJBC to skip the processing
  2013. of the jar by ejbc. The ejbc step will then occur at deployment
  2014. * weblogic will tell ejbc to use Jikes compiler if build.compiler is set to
  2015. jikes. It can be restored to the default, javac, operation if desired.
  2016. * Allow the <sql> Delimiter to be set in the so that Oracle stored procs may be
  2017. entered
  2018. * <execon> and <apply> can now optionally skip empty filesets.
  2019. * <javadoc> has a new useexternalfile attribute that makes it use a
  2020. temporary file for sourcefile and package names - helps to defeat
  2021. command line length limitations.
  2022. * Data types like <path> can now be defined inside of <target>s
  2023. * you can now specify a classpath for <style> - the XSLZ processor
  2024. will be loaded from this path
  2025. * added a force attribute to <style> to support dependencies that the
  2026. task cannot determine itself (dependency on parameters, not file
  2027. modification times for example)
  2028. * added vmlauncher attribute to exec tasks. This defaults to true. If
  2029. it is set to false, the VM's ability to launch commands in bypassed
  2030. and the OS shell, either directly or through the auxillary antRun
  2031. scripts is used.
  2032. * regexp mapper now supports the java.util.regex package of JDK 1.4.
  2033. * New filesonly attribute for <zip> and friends to suppress directory
  2034. entries.
  2035. * New update attribute for <zip> and friends - update an existing
  2036. archive instead of creating a new one.
  2037. * <apply> and <execon> have been merged into a single task.
  2038. * added vssver.scc to the default excludes
  2039. * <available> has a new filepath attribute/nested element that allows
  2040. you top search for a file in a given path.
  2041. * <junit> can now optionally set a property on test failure.
  2042. * <taskdef> can now define several tasks at once, reading the
  2043. name/classname pairs from a property file or resource.
  2044. * <unzip/unjar/unwar> and <untar> now have an overwrite attribute that
  2045. defaults to true. If set to false, files that are newer than the
  2046. files in the archive will not be replaced.
  2047. * <patternset> and <fileset> now support nested <in/excludesfile>
  2048. elements - using these you can have more than one in/excludes file
  2049. per <patternset>.
  2050. * Three new supported compilers for javac: kjc for kopi, gcj for the
  2051. gcc frontend and sj for Symantec's compiler.
  2052. In addition extJavac or the new fork attribute can be
  2053. used to run the JDK's javac in a JVM separate from Ant.
  2054. * <fixrlf> can now with CR only line-ends and can use an arbitraty
  2055. between 2 and 80.
  2056. * The .NET tasks have been adapted to the beta2 release of the framework.
  2057. * <move> will now try to rename() files before copying them byte by
  2058. byte - only if filtering is of, of course.
  2059. * <ant> and <antcall> tasks now support a new attribute inheritAll. When set to
  2060. false, only user properties are passed through to the target Ant instance.
  2061. This includes properties set on the command line and properties explicitly
  2062. passed
  2063. * <javadoc> now skips off line links if the package list cannot be found.
  2064. * <wlrun> now allows the security policy file to exist outside the weblogic
  2065. directory.
  2066. * <java> task will set the Thread contextClassLoader under JDKs 1.2+ to the
  2067. classloader for the class being executed.
  2068. * Introduce the concept of a TaskContainer - a task or element which can contain
  2069. Ant Tasks.
  2070. * Add new tasks implementing the TaskContainer interface <parallel> and
  2071. <sequential> which allow parallel execution of tasks to be specified.
  2072. * <depend> task will now take into account dependencies on jar files and class
  2073. files from a given classpath.
  2074. * <jar> manifest entries may now be specified in the build file either
  2075. completely or to be merged with a manifest file.
  2076. * <tstamp> task custom formats now support locales.
  2077. * Added a listner which will forward events to Log4J. The log4j configuration
  2078. file should be in the directory from which Ant is run or passed as a system
  2079. property using a JVM argument.
  2080. * Introduced the concept of <filtersets> to allow for more control in which
  2081. filters get applied in a <copy> or <move> operation.
  2082. * Added nowarn attribute to javac and deprecated the Jikes-magic property
  2083. build.compiler.warnings.
  2084. * The <depend> task cache format has changed and all dependency information is
  2085. now stored in a single file.
  2086. Fixed bugs:
  2087. -----------
  2088. * Testcases have been made independent of current working directory.
  2089. * Input ZIP-Files will be closed when using a <zipfileset>.
  2090. * p4 tasks now don't fail if user, port or client have been omitted
  2091. (and this is acceptable for the context of the command).
  2092. * <javah>'s outputfile attribute will be resolved as relative to the
  2093. projects basedir.
  2094. * <antstructure> should create a valid DTD for propertyfile.operation.entry
  2095. and omit tasks it fails to load.
  2096. * won't try to pass a -bootclasspath flag to javac 1.1 anymore
  2097. * <style>'s style attribute no handles absolute paths correctly.
  2098. * <delete includeemptydirs="true"> now deletes more than just the leaf
  2099. directories.
  2100. * You can now specify a <fileset> for a directory that doesn't exist at
  2101. declaration time but will created before the fileset gets used for the
  2102. first time.
  2103. * If the quiet attribute has been set, <delete> will handle <fileset>s
  2104. with non-existing directories gracefully.
  2105. * Output written by testcases will now be captured by the <junit> task
  2106. and passed to the formatters.
  2107. * Quote the -group parameter to Javadoc as per the specification
  2108. * Initialise classes when loaded through the AntClassLoader - that is, run
  2109. static initializers
  2110. * Implement getResource() and getResources() in AntClassLoader
  2111. * Create the <ejbjar> weblogic command line as a set of arguments rather than
  2112. as a single line. Avoids problems with paths which contain spaces.
  2113. * <ejbjar> now fails when the weblogic ejbc compiler reports an error.
  2114. * Make the AntClassLoader load resources in the same order as it currently
  2115. loads classes.
  2116. * Handle classpaths with spaces
  2117. * Make sure XSLT processors close their output files in <style>.
  2118. * perform proper uptodate check in <rmic> when compiling for IIOP.
  2119. * <jjtree>'s uptodate test works even if outputdirectory is not the
  2120. parent dir of target
  2121. * <copy> will remove target file (if it exists) before writing to it -
  2122. this avoids problems with links on filesystems that support them.
  2123. * <ftp> now properly recurses remote directories.
  2124. * <ftp> closes remote connection when it's done.
  2125. * <junit> tries to include all necessary classes for the task itself
  2126. to the classpath when running in fork mode - doesn't work for JDK 1.1
  2127. * <apply> and <execon> do now execute the command only once, if you
  2128. specify the parallel attribute - instead of once per fileset.
  2129. * directory based tasks and fileset could miss some included files in
  2130. directories that have been excluded
  2131. * <fixcrlf> failed for large files.
  2132. * <move> removed files you tried to move to themselves.
  2133. * <sql> task will not trty to print the result set unless the query succeeded.
  2134. * Ant classloader will now ignore paths which are invalid relative to the
  2135. project base
  2136. * <ejbjar> weblogic elements check for jar file changes has been fixed.
  2137. Previously some changes would not be included.
  2138. * properties loaded from properties files are now resolved internally. This
  2139. removes the spurious warnings about usage of properties which have not been
  2140. set.
  2141. * <jar> task and friends now process the JAR manifest to ensure it is valid.
  2142. * The task finished event now includes any exception thrown by the task.
  2143. * <java> task now supports a jvmVersion attribute so that if another JVM is
  2144. being used, Ant can determine which options to use for features such as the
  2145. VM memory limits
  2146. Changes from Ant 1.2 to Ant 1.3
  2147. ===========================================
  2148. Changes that could break older environments:
  2149. --------------------------------------------
  2150. * Ant doesn't search for the buildfile anymore, unless you use the new
  2151. -find argument.
  2152. * <perforce> has been replaced by a number of new tasks.
  2153. * <javac> is now implemented using a factory. This makes extending
  2154. javac to use a new compiler a lot easier but may break custom
  2155. versions of this task that rely on the old implementation.
  2156. * The output generated by the xml formatter for <junit> has changed a
  2157. little, it doesn't append " sec" in the time attribute anymore.
  2158. Other changes:
  2159. --------------
  2160. * A GUI Frontend: Antidote. This is currently in development. At this
  2161. time, this is not part of the Ant release, although the source is
  2162. included if you are interested.
  2163. * New tasks: stylebook, propertyfile, depend, antlr, telnet, csc,
  2164. ilasm, apply, javah, several clearcase tasks, junitreport, sound
  2165. * Added output attribute to <java>.
  2166. * Added nested zipfileset element to <zip>
  2167. * Changed <sql> so that printing is at the task level rather than
  2168. the statement level.
  2169. * javadoc task will pass -d flag to any doclet if the destDir attribute is
  2170. given. If the doclet does not accept the -d flag then omit the destdir
  2171. attribute.
  2172. * <cab> can work on non-Windows platforms with the help of libcabinet.
  2173. See http://trill.cis.fordham.edu/~barbacha/cabinet_library/.
  2174. * <ftp> now supports passive mode.
  2175. * New <mapper> data type that can be used to get influence on the
  2176. target files for some tasks like <copy> or enable new types of tasks
  2177. like <apply>.
  2178. * <execon> provides more control over the command line now, the names
  2179. of the source files are no longer required to be at the end of the
  2180. command.
  2181. * Style tasks will now support TraX compliant XSL processors if one is present
  2182. in your classpath.
  2183. * Added a failonerror to the javac task. If set to false, the build will
  2184. continue even if there are compilation errors.
  2185. * Added nested format elements to the tstamp task allowing additional time
  2186. formats to be defined for arbitrary properties.
  2187. * Added classpath attribute and nested classpath element to <property>
  2188. to make the resource attribute more powerful.
  2189. * ${} property expansion will now be performed on the patterns read
  2190. from files specified as includesfile or excludesfile attributes.
  2191. * The <tar> and <untar> tasks now support GNU format for handling paths
  2192. which are greater than 100 characters in length. In addition the <tar>
  2193. task now supports nested filesets through which the file permissions
  2194. may be controlled.
  2195. * wlrun, wlstop and ejbjar now support Weblogic 6.0
  2196. * The MPasre task has been updated to work with MParse 2.0
  2197. * The documentation has been significantly updated.
  2198. Fixed bugs:
  2199. -----------
  2200. * <signjar> doesn't use deprectated methods anymore.
  2201. * javadoc's failonerror attribute works again
  2202. * javadoc's additionalparam attribute will now be split into separate
  2203. parameters (on spaces) to allow for more than one parameter.
  2204. * Changed <sql> task so that printing result sets works on Oracle
  2205. * Changes to ddcreator and ejbc helper to respect the descriptor hierarchy
  2206. keppgenerated in ejbc can now be turned off
  2207. * ejbjar now correctly ignores <ejb-ref> elements in the deployment descriptor.
  2208. CMP files are included by parsing the weblogic deployment descriptor rather
  2209. than relying on the naming convention used in ant 1.2
  2210. * ejbjar includes super classes and super interfaces into the generated ejb
  2211. jar files. The <support> nested element allows support classes to be
  2212. included in the EJB jar. The toplink element should now correctly locate
  2213. the toplink descriptor.
  2214. * <vssget> now correctly deals with spaces in arguments
  2215. * <jar> fails early if a given manifest file doesn't exist
  2216. * <rmic> doesn't search for the _Skel file anymore when stubversion is
  2217. set to 1.2.
  2218. * <rmic> uses the the same classpath to verify a class can be rmic'd
  2219. as it passes to the compiler.
  2220. * org.apache.tools.mail.MailMessage (and therefore <mail>) can now
  2221. handle SMTP servers sending multi line responses.
  2222. * nested <classpath> elements of <taskdef> now work for <taskdef>s not
  2223. nested into <target> as well.
  2224. * <property> and <available> will search for the resource "foo" instead
  2225. of "/org/apache/tools/ant/taskdefs/foo" when given a relative resource
  2226. name foo.
  2227. * Handle build files in directories whose name contained a "#" character
  2228. * <junit> can now log to files whose name contains a comma as well.
  2229. * The AntClassLoader now refers to the loader which loaded it, any
  2230. requests it does not handle itself. Previously these went to the
  2231. primordial loader.
  2232. Changes from Ant 1.1 to Ant 1.2
  2233. ===============================
  2234. Changes that could break older environments:
  2235. --------------------------------------------
  2236. * Semantics of <property> has changed again in the hope to be more
  2237. intuitive. ${} expansion now happens at runtime and <property> tags
  2238. living inside of targets only take effect if they are visited at
  2239. runtime.
  2240. As a side effect of this change, task's attributes get set at runtime
  2241. not at parser time as well, which might change the results of
  2242. <script>s or other custom tasks that reference other tasks by their id
  2243. attribute.
  2244. * copying of support files in <javac> has been removed - as well as
  2245. the filtering attribute.
  2246. * the <expand> and <keysubst> tasks have been removed.
  2247. * the ignore and items attributes of directory based tasks have been removed.
  2248. * the command line switches _not_ starting with - have been removed.
  2249. * Path and EnumeratedAttribute have been moved from
  2250. org.apache.tools.ant to org.apache.tools.ant.types.
  2251. * the class attributes of <available>, <java>, <rmic> and <taskdef>
  2252. have been removed.
  2253. * the src attribute of <chmod> has been removed.
  2254. * <patch> and <javadoc> have lost some of their attributes.
  2255. * <java> and <cvs> have lost some undocumented attributes.
  2256. * the Unix antRun script would search for command.sh in the directory
  2257. it changed to and invoke this instead of command if present. This
  2258. behavior has been dropped.
  2259. * <ejbjar> task syntax has been changed significantly
  2260. * <exec> is no longer implemented by org.apache.tool.ant.taskdefs.Exec.
  2261. Custom tasks that rely on Project.createTask("exec") to return an
  2262. instance of this class are going to fail.
  2263. * nested <include> and <exclude> elements expect the value of their
  2264. name attribute to be a single pattern, they don't accept multiple
  2265. patterns anymore. Split them into multiple elements of the same type.
  2266. * <delete dir="somedir" /> will now delete the directory itself as
  2267. well as all included files. If you just want to clean out the
  2268. directory and keep the empty one, use a nested fileset.
  2269. Other changes:
  2270. --------------
  2271. * New tasks: antstructure, cab, execon, fail, ftp, genkey, jlink,
  2272. junit, sql, javacc, jjtree, starteam, war, unwar, uptodate,
  2273. native2ascii, copy, move, mparse.
  2274. * copydir, copyfile, deltree and rename are now deprecated. They
  2275. should be replaced with the new copy, delete and move tasks.
  2276. * <java> uses a ClassLoader of its own in no-fork mode if a classpath is
  2277. specified.
  2278. * <style> will create the necessary target directories and reprocess
  2279. all files if the stylesheet changes.
  2280. * New data types fileset and patternset - expected to get a broader use.
  2281. They, as well as PATH like structures, can now be defined on a global
  2282. level and later be referenced by their id attribute.
  2283. * You can specify environment variables to <exec>.
  2284. * <get> can check whether a remote file is actually newer than a local
  2285. copy before it starts a download (HTTP only).
  2286. * Added a -logger option to allow the class which performs logging to be
  2287. specified on the command line.
  2288. * Added a -emacs option to tell the logger to leave out taskname adornments
  2289. on log output.
  2290. * <chmod> works on all files in parallel and supports multiple filesets.
  2291. * <replace> can now use tokens and/or values that cross line boundaries.
  2292. * build.compiler supports now jvc as well.
  2293. * project specific help can now be obtained with the -projecthelp option.
  2294. * Added a -debug option to make -verbose less verbose (and more useful)
  2295. * Ant will now search for a file named build.xml in the parent directory
  2296. and above (towards the root of the filesystem) if you didn't specify
  2297. -buildfile and there is no build.xml in the current directory.
  2298. * <echo> can now write to a file and accepts nested text.
  2299. Fixed bugs:
  2300. -----------
  2301. * <chmod> didn't work when used as a directory based task.
  2302. * Path, Available, Property didn't resolve relative filenames with
  2303. respect to the Project's basedir.
  2304. * Project didn't interpret the basedir attribute correctly in all
  2305. cases.
  2306. * Nested <src> in <javac> caused NullPointerException.
  2307. * Corrupt Zip- and Jar-files ar now deleted if the task fails.
  2308. * many more fixes we've forgotten to document here ...
  2309. * The packagelistloc attribute of <javadoc>'s <link> child will be
  2310. resolved as a file (i.e. it is either absolute or relative to
  2311. basedir).