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.

requested-features.html 24 KiB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090
  1. <html>
  2. <body>
  3. <h2>
  4. <center>Requested Features for Ant2</center>
  5. </h2>
  6. <h4>
  7. I. Things that don't affect the core but are requests for new tasks or
  8. enhancements to existing tasks.
  9. </h4>
  10. &quot;Accepted&quot; for a task doesn't mean that
  11. task will be a core task (or even be supplied by a voter), just that having
  12. it (as an optional task) would be acceptable.
  13. <p>
  14. <font face="Arial, Helvetica, sans-serif" size="-1">
  15. &nbsp;&nbsp;<b>Accepted</b>
  16. </font>
  17. <blockquote>
  18. <bl><li>
  19. Add a new datatype filterset to group token-filters.
  20. </li></bl>
  21. </blockquote>
  22. <blockquote>
  23. <bl><li>
  24. Make usage of particular filters/filtersets explicit in copy tasks.
  25. </li></bl>
  26. </blockquote>
  27. <blockquote>
  28. <bl><li>
  29. Make facade tasks for things like <code>&lt;javac&gt;</code>
  30. (JikesImpl, ModernImpl, etc.).
  31. (One candidate is <code>&lt;jar&gt;</code>, with implementations for
  32. a <code>&lt;fastjar&gt;</code>, for example.)
  33. </li></bl>
  34. </blockquote>
  35. <blockquote>
  36. <bl><li>
  37. Unify multiple similar tasks to use similar forms (eg., all the
  38. <code>&lt;javacc&gt;</code>-type
  39. tools).
  40. </li></bl>
  41. </blockquote>
  42. <blockquote>
  43. <bl><li>
  44. Obfuscating task.
  45. </li></bl>
  46. </blockquote>
  47. <blockquote>
  48. <bl><li>
  49. Better scripting/notification support so the hooks are available to
  50. send notifications at certain times.
  51. </li></bl>
  52. </blockquote>
  53. <blockquote>
  54. <bl><li>
  55. Add an <code>&lt;ant&gt;</code> task that will find build files according
  56. to a fileset and invoke a common target in them. (<code>&lt;anton&gt;</code>?)
  57. </li></bl>
  58. </blockquote>
  59. <blockquote>
  60. <bl><li>
  61. Add a JavaApply task that executes a given class with files from a
  62. fileset as arguments (similar to <code>&lt;apply&gt;</code>).
  63. </li></bl>
  64. </blockquote>
  65. <blockquote>
  66. <bl><li>
  67. Include some more sophisticated loggers with the Ant distribution &#150;
  68. especially for sending emails. Make the existing one more flexible
  69. (stylesheet used by XmlLogger). (Could be part of the same module tasks
  70. would be developed in?)
  71. </li></bl>
  72. </blockquote>
  73. <blockquote>
  74. <bl><li>
  75. Better docs (eg., more examples, tutorials, beginner documents, reference
  76. sheets for tasks, printable version, etc.).
  77. </li></bl>
  78. </blockquote>
  79. <blockquote>
  80. <bl><li>
  81. RPM task.
  82. </li></bl>
  83. </blockquote>
  84. <blockquote>
  85. <bl><li>
  86. Task for splitting files (head/tail/split-like functionality).
  87. </li></bl>
  88. </blockquote>
  89. <blockquote>
  90. <bl><li>
  91. Task to create XMI from Java.
  92. </li></bl>
  93. </blockquote>
  94. <blockquote>
  95. <bl><li>
  96. Socksified networking tasks, SSH tasks.
  97. (Peter Donald expressed some legal concerns that might need to be overcome,
  98. depending on the implementation.)
  99. </li></bl>
  100. </blockquote>
  101. <blockquote>
  102. <bl><li>
  103. A reachable task that works much like <code>&lt;available&gt;</code>,
  104. for network URLs.
  105. </li></bl>
  106. </blockquote>
  107. <blockquote>
  108. <bl><li>
  109. Task to extract classes from a jar-file that a given class depends on.
  110. (Based on <code>&lt;depend&gt;</code> or IBM's JAX, for example.)
  111. </li></bl>
  112. </blockquote>
  113. <blockquote>
  114. <bl><li>
  115. Unify <code>&lt;available&gt;</code> and <code>&lt;uptodate&gt;</code>
  116. into a more general
  117. <code>&lt;condition&gt;</code> task &#150; support
  118. <code>AND</code>/<code>OR</code> of
  119. several tests here.
  120. (Will need more discussion because of vote by Peter Donald.)
  121. </li></bl>
  122. </blockquote>
  123. <blockquote>
  124. <bl><li>
  125. JSP-compilation task. (Sounds like a candidate for a facade task.)
  126. </li></bl>
  127. </blockquote>
  128. <blockquote>
  129. <bl><li>
  130. URL-spider task that checks links for missing content or server errors.
  131. </li></bl>
  132. </blockquote>
  133. <font face="Arial, Helvetica, sans-serif" size="-1">
  134. &nbsp;&nbsp;<b>Rejected</b>
  135. </font>
  136. <blockquote>
  137. <bl><li>
  138. Make the default logger's output clear, informative, and terse. (Rejectors
  139. think it already is.)
  140. </blockquote>
  141. </li></bl>
  142. <blockquote>
  143. <bl><li>
  144. Add an attribute to <code>&lt;property&gt;</code> to read in an entire file
  145. as the value of a property.
  146. </li></bl>
  147. </blockquote>
  148. <blockquote>
  149. <bl><li>
  150. Make PATH-handling consistent. Every task that has a PATH attribute
  151. must also accept references to PATHs.
  152. </li></bl>
  153. </blockquote>
  154. <br>
  155. <h4>
  156. II. Goals that need to be abstract until we get into design
  157. decisions.
  158. </h4>
  159. During the discussion it became obvious that some things from this list
  160. are goals for Ant and some should be guidelines for developers.
  161. Therefore, there are two flavors, &quot;Accepted&quot; and
  162. &quot;Accepted As Guideline&quot;.
  163. <p>
  164. <font face="Arial, Helvetica, sans-serif" size="-1">
  165. &nbsp;&nbsp;<b>Accepted</b>
  166. </font>
  167. <blockquote>
  168. <bl><li>
  169. Provide a clear mission statement for Ant.
  170. </li></bl>
  171. </blockquote>
  172. <blockquote>
  173. <bl><li>
  174. Main goals<b>:</b> simplicity, understandability, extensibility.
  175. </li></bl>
  176. </blockquote>
  177. <blockquote>
  178. <bl><li>
  179. Remove magic properties if at all humanly possible.
  180. </li></bl>
  181. </blockquote>
  182. <blockquote>
  183. <bl><li>
  184. Remove as much dependency on native scripts as possible.
  185. </li></bl>
  186. </blockquote>
  187. <blockquote>
  188. <bl><li>
  189. Clean object model (ie., Project/Target/Task).
  190. </li></bl>
  191. </blockquote>
  192. <blockquote>
  193. <bl><li>
  194. Good event model to integrate well with IDE/GUI/etc.
  195. </li></bl>
  196. </blockquote>
  197. <blockquote>
  198. <bl><li>
  199. Use a consistent naming scheme for attributes across all tasks.
  200. </li></bl>
  201. </blockquote>
  202. <blockquote>
  203. <bl><li>
  204. Keep build-file syntax as compatible to Ant1 as possible
  205. (ie., don't break something just because we can).
  206. </li></bl>
  207. </blockquote>
  208. <blockquote>
  209. <bl><li>
  210. Keep the interface for tasks as similar to that of Ant1 as
  211. possible (ie., don't break something just because we can).
  212. </li></bl>
  213. </blockquote>
  214. <blockquote>
  215. <bl><li>
  216. Ant should be cancelable.
  217. </li></bl>
  218. </blockquote>
  219. <font face="Arial, Helvetica, sans-serif" size="-1">
  220. &nbsp;&nbsp;<b>Accepted As Guideline</b>
  221. </font>
  222. <blockquote>
  223. <bl><li>
  224. No commit of new features without documentation.
  225. </li></bl>
  226. </blockquote>
  227. <blockquote>
  228. <bl><li>
  229. No commit of new features without test-cases.
  230. </li></bl>
  231. </blockquote>
  232. <br>
  233. <h4>
  234. III. Things that are simple and easy to implement, where we expect the
  235. committers to agree.
  236. </h4>
  237. <font face="Arial, Helvetica, sans-serif" size="-1">
  238. &nbsp;&nbsp;<b>Accepted</b>
  239. </font>
  240. <blockquote>
  241. <bl><li>
  242. Namespace support so different concerns can occupy different namespaces
  243. from Ant (thus, SAX2/JAXP1.1).
  244. </li></bl>
  245. </blockquote>
  246. <blockquote>
  247. <bl><li>
  248. Java2
  249. </li></bl>
  250. </blockquote>
  251. <blockquote>
  252. <bl><li>
  253. Remove all deprecated methods, attributes, tasks.
  254. </li></bl>
  255. </blockquote>
  256. <blockquote>
  257. <bl><li>
  258. Allow all datatypes to be defined anywhere (ie., as children of
  259. project as well as of target).
  260. </li></bl>
  261. </blockquote>
  262. <blockquote>
  263. <bl><li>
  264. Make properties fully dynamic (ie., allow their value to be reassigned).
  265. </li></bl>
  266. </blockquote>
  267. <blockquote>
  268. <bl><li>
  269. Unify the namespace of all data types (ie., properties + filesets +
  270. patternsets + filtersets).
  271. </li></bl>
  272. </blockquote>
  273. <blockquote>
  274. <bl><li>
  275. Add a user-defined message if a target will be skipped as a
  276. result of the specified <code>if/unless</code>.
  277. </li></bl>
  278. </blockquote>
  279. <blockquote>
  280. <bl><li>
  281. Allow user datatypes to be defined via a <code>&lt;typedef&gt;</code>
  282. similar to <code>&lt;taskdef&gt;</code>.
  283. </li></bl>
  284. </blockquote>
  285. <br>
  286. <h4>
  287. IV. Things we probably agree on but need to discuss the details or
  288. decide between several possible options.
  289. </h4>
  290. &quot;Accepted&quot; means the goal/idea is fine, not that a decision on a
  291. particular implementation has been made.
  292. <p>
  293. <font face="Arial, Helvetica, sans-serif" size="-1">
  294. &nbsp;&nbsp;<b>Accepted</b>
  295. </font>
  296. <blockquote>
  297. <bl><li>
  298. The ability for GUI/IDE tools to integrate easily with object model
  299. without reinventing the wheel and writing their own parser (which
  300. Antidote was forced to do).
  301. (Two suggested solutions were allowing GUI developers to extend
  302. the object model (ie., GUITask extends Task) or to have Task as an
  303. interface (ie., GUITask implements Task). This way, the GUI tasks could
  304. be W3C DOM elements, have property vetoers/listeners, etc.)
  305. </li></bl>
  306. </blockquote>
  307. <blockquote>
  308. <bl><li>
  309. Support for numerous front-ends &#150; from command-line over GUI to servlets.
  310. (Corollary of the above?)
  311. </li></bl>
  312. </blockquote>
  313. <blockquote>
  314. <bl><li>
  315. Fully interpreted at run-time. (This almost requires some form of
  316. abstraction/proxy that stands in place of tasks till it is
  317. interpreted. This can be hash-tables/simple DOM-like model/whatever.)
  318. </li></bl>
  319. </blockquote>
  320. <blockquote>
  321. <bl><li>
  322. Provide utility classes to aid in building tasks (ie., like
  323. <code>&lt;uptodate&gt;</code> functionality abstracted).
  324. (Need to become more specific here.)
  325. </li></bl>
  326. </blockquote>
  327. <blockquote>
  328. <bl><li>
  329. Make ant-call a low-cost operation so it can do certain
  330. optional/template-like operations.
  331. (Corollary of "fully interpreted at run-time"?)
  332. </li></bl>
  333. </blockquote>
  334. <blockquote>
  335. <bl><li>
  336. Allow facilities to build projects from multiple sources (ie., CSS+XML,
  337. XSLT+XML, Velocity+text or database, from inside jars or normal
  338. <code>build.xml</code> files, etc.)
  339. (Allow the project tree to be built dynamically.)
  340. </li></bl>
  341. </blockquote>
  342. <blockquote>
  343. <bl><li>
  344. Move to a system that allows docs to be generated &#150; doc snippets
  345. should be included with the tasks they document.
  346. (Which DTD? Which tools for generation?)
  347. </li></bl>
  348. </blockquote>
  349. <blockquote>
  350. <bl><li>
  351. Allow tasks to be loaded from jars. (Use
  352. either an XML file in <code>TSK-INF/taskdefs.xml</code> or a
  353. manifest file.)
  354. </li></bl>
  355. </blockquote>
  356. <blockquote>
  357. <bl><li>
  358. Allow documentation to be stored in <code>.tsk</code> jars.
  359. (Corollary of the above two points?)
  360. </li></bl>
  361. </blockquote>
  362. <blockquote>
  363. <bl><li>
  364. Separate tasks into <code>.tsk</code> jars somehow.
  365. (Decide on categories.
  366. Probably via function &#150; ie., java tasks, file tasks, EJB tasks, etc.)
  367. </li></bl>
  368. </blockquote>
  369. <blockquote>
  370. <bl><li>
  371. Make having separate build-files easy (<i>&#224; la</i> AntFarm) and importing different
  372. projects a breeze.
  373. </li></bl>
  374. </blockquote>
  375. <blockquote>
  376. <bl><li>
  377. Provide support for user-defined task configurations &#150; (ie., give
  378. users the ability to specify a default value for attributes (eg., always
  379. use <code>debug="true"</code> in <code>&lt;javac&gt;</code> unless
  380. something else has been specified).
  381. (Three ideas so far<b>:</b> a CSS-like language,
  382. a <code>&lt;taskconfig&gt;</code> element, or
  383. properties following a specific naming scheme.)
  384. </li></bl>
  385. </blockquote>
  386. <blockquote>
  387. <bl><li>
  388. Support more control over the properties that are going to be passed
  389. to subprojects (modules).
  390. </li></bl>
  391. </blockquote>
  392. <blockquote>
  393. <bl><li>
  394. Task to prompt for user input.
  395. (Does affect core, as we need a means to request input from the front-end.)
  396. </li></bl>
  397. </blockquote>
  398. <blockquote>
  399. <bl><li>
  400. Add CVS login feature.
  401. (Requires handling of user input.)
  402. </li></bl>
  403. </blockquote>
  404. <blockquote>
  405. <bl><li>
  406. Easier installation process. GUI, maybe webstart from the homepage.
  407. This includes asking the user whether he wants to use optional tasks
  408. and downloads the required libs, automatic upgrades and so on.
  409. Self-extracting jar installer<b>:</b>
  410. <br>
  411. &nbsp;&nbsp;&nbsp;&nbsp;<code>java -jar jakarta-ant-1.3-bin.jar</code>
  412. <br>
  413. Prompts for destination directory, extracts archive, fixes all
  414. text files with <code>&lt;fixCRLF&gt;</code> task<b>;</b> on UNIX,
  415. makes scripts executable.
  416. Could also modify ant scripts with the location of <code>ANT_HOME</code>.
  417. </li></bl>
  418. </blockquote>
  419. <blockquote>
  420. <bl><li>
  421. Logo for Ant.
  422. </li></bl>
  423. </blockquote>
  424. <blockquote>
  425. <bl><li>
  426. Detach Ant from <code>System.err</code>/<code>.in</code>/<code>.out</code>.
  427. (Beware of problems with spawned processes.)
  428. </li></bl>
  429. </blockquote>
  430. <blockquote>
  431. <bl><li>
  432. Build-files should be declarative in nature.
  433. </li></bl>
  434. </blockquote>
  435. <font face="Arial, Helvetica, sans-serif" size="-1">
  436. &nbsp;&nbsp;<b>Rejected</b>
  437. </font>
  438. <blockquote>
  439. <bl><li>
  440. It should be possible to modify details of the actual build (e.g. classpath,
  441. compiler used, etc.) without the need to change the build specification.
  442. (Do <code>build.compiler</code> and <code>build.sysclasspath</code>
  443. cover everything, or do we need to add more stuff like this?)
  444. </li></bl>
  445. </blockquote>
  446. <blockquote>
  447. <bl><li>
  448. Better sub-project handling
  449. (whatever that means in detail).
  450. </li></bl>
  451. </blockquote>
  452. <br>
  453. <h4>
  454. V. Things we probably don't agree on.
  455. </h4>
  456. <i><b>Datatypes</b></i>
  457. <p>
  458. <font face="Arial, Helvetica, sans-serif" size="-1">
  459. &nbsp;&nbsp;<b>Accepted</b>
  460. </font>
  461. <blockquote>
  462. <bl><li>
  463. Allow <code>&lt;include&gt;/&lt;exclude&gt;</code>
  464. to work with multiple characteristerics of a file
  465. (ie., include into fileset if file is readable, modified after 29th of Feb,
  466. has a name that matches the pattern <code>&quot;**/*.java&quot;</code> and
  467. the property <code>foo.present</code> is set. Something similar to<b>:</b>
  468. <pre>
  469. &lt;include&gt;
  470. &lt;item-filter type="name" value="**/*.java"/&gt;
  471. &lt;item-filter type="permission" value="r"/&gt;
  472. &lt;!-- could optionally be directory or some other system specific features --&gt;
  473. &lt;item-filter type="type" value="file"/&gt;
  474. &lt;item-filter type="modify-time"
  475. operation="greater-than"
  476. value="29th Feb 2003"/&gt;
  477. &lt;/include&gt;
  478. </pre>
  479. </li></bl>
  480. </blockquote>
  481. <blockquote>
  482. <bl><li>
  483. Provide support for non-hardwired (ie., loadable) low-level
  484. components (mappers/itemset-filters/converters). Allow them to be
  485. loaded in either globally or via a new classloader.
  486. </li></bl>
  487. </blockquote>
  488. <blockquote>
  489. <bl><li>
  490. Provide support for non-hardwired (ie., loadable) converters.
  491. <br>
  492. Q<b>:</b> What is a converter? Is this an implementation detail?
  493. <br>
  494. A<b>:</b> Not an implementation detail, but a way to extend the engine
  495. to convert more datatypes. Currently, we have a fixed set that is
  496. expanded on occasion (ie., includes primitive types + File). Instead
  497. of spreading converting code throughout the tasks, it can be centralized
  498. into one component and used by the engine. This becomes particularly
  499. relevent if you build Ant-based testing systems and use Ant in certain
  500. web-related areas.
  501. </li></bl>
  502. </blockquote>
  503. <blockquote>
  504. <bl><li>
  505. Set-arithmetic for fileset/patternset/*set.
  506. </li></bl>
  507. </blockquote>
  508. <blockquote>
  509. <bl><li>
  510. Inheritance of Ant properties/datatypes/context/etc. in project hierarchy.
  511. </li></bl>
  512. </blockquote>
  513. <font face="Arial, Helvetica, sans-serif" size="-1">
  514. &nbsp;&nbsp;<b>Rejected</b>
  515. </font>
  516. <blockquote>
  517. <bl><li>
  518. Allow mappers to be genericized so that particular features can be modified
  519. during mapping. Something similar to<b>:</b>
  520. <pre>
  521. &lt;fileset ...&gt;
  522. &lt;include name="*.sh"/&gt;
  523. &lt;mapper type="unix-permissions"&gt;
  524. &lt;param name="user" value="ant"/&gt;
  525. &lt;param name="group" value="ant"/&gt;
  526. &lt;param name="mod" value="755"/&gt;
  527. &lt;/mapper&gt;
  528. &lt;/fileset&gt;
  529. </pre>
  530. </li></bl>
  531. </blockquote>
  532. <blockquote>
  533. <bl><li>
  534. Provide datatypes through property tag and remove need for separate
  535. free-standing entities. That is<b>:</b><br>
  536. <pre>
  537. &lt;property name="foo"&gt;
  538. &lt;fileset dir="blah"&gt;
  539. &lt;include name="*/**.java" /&gt;
  540. &lt;/fileset&gt;
  541. &lt;/property&gt;
  542. </pre>
  543. </li></bl>
  544. </blockquote>
  545. <blockquote>
  546. <bl><li>
  547. Make all datatypes interfaces to allow them to be customized in many
  548. ways.
  549. </li></bl>
  550. </blockquote>
  551. <blockquote>
  552. <bl><li>
  553. Inheritance between Ant datatypes (ie., fileset A inherits from
  554. fileset B (includes all entries in A).
  555. </li></bl>
  556. </blockquote>
  557. <blockquote>
  558. <bl><li>
  559. Homogenize notion of PATHs and filesets.
  560. </li></bl>
  561. </blockquote>
  562. <i><b>Ant's goals</b></i>
  563. <p>
  564. <font face="Arial, Helvetica, sans-serif" size="-1">
  565. &nbsp;&nbsp;<b>Accepted</b>
  566. </font>
  567. <blockquote>
  568. <bl><li>
  569. Provide support for CJAN.
  570. <br>
  571. Q: In what way?<br>
  572. A: Probably by supplying a set of tasks that download versioned
  573. binaries and their associated dependencies, caching the downloads
  574. in a known place and updating binaries when required.
  575. (&quot;When required&quot; being indicated by a change in property values).
  576. </li></bl>
  577. </blockquote>
  578. <font face="Arial, Helvetica, sans-serif" size="-1">
  579. &nbsp;&nbsp;<b>Rejected</b> (as a primary goal)
  580. </font>
  581. <blockquote>
  582. <bl><li>
  583. Make it possible to re-use the task engine for other things
  584. (ie., Installshield-type app, Peter's cron-server, and other task-based
  585. operations).
  586. </li></bl>
  587. </blockquote>
  588. <i><b>Class-loading</b></i>
  589. <p>
  590. <font face="Arial, Helvetica, sans-serif" size="-1">
  591. &nbsp;&nbsp;<b>Rejected</b>
  592. </font>
  593. <blockquote>
  594. <bl><li>
  595. Force resolution of classes on loading, to identify class-loader
  596. issues early (at least in global classloader).
  597. </li></bl>
  598. </blockquote>
  599. <blockquote>
  600. <bl><li>
  601. Ignore any classes contained in the damned ext dirs of a
  602. JVM &#150; possibly by launching with something like<b>:</b>
  603. <br>
  604. &nbsp;&nbsp;&nbsp;&nbsp;<code>jar -Djava.ext.dir=foo -jar ant.jar</code>
  605. <br>
  606. (Accepted if optional.)
  607. </li></bl>
  608. </blockquote>
  609. <p>
  610. <i><b>Workspace/sub-build issues</b></i>
  611. <p>
  612. <font face="Arial, Helvetica, sans-serif" size="-1">
  613. &nbsp;&nbsp;<b>Accepted</b>
  614. </font>
  615. <blockquote>
  616. <bl><li>
  617. Create the concept of workspace so that projects can be built in a
  618. DAG and thus enable projects like Catalina/Tomcat to have an easy
  619. build process. It also helps CJAN to a lesser degree and would
  620. partially solve the jars-in-CVS thing.
  621. </li></bl>
  622. </blockquote>
  623. <blockquote>
  624. <bl><li>
  625. Allow a target to depend on a target in another build-file.
  626. </li></bl>
  627. </blockquote>
  628. <p>
  629. <font face="Arial, Helvetica, sans-serif" size="-1">
  630. &nbsp;&nbsp;<b>Rejected</b>
  631. </font>
  632. <blockquote>
  633. <bl><li>
  634. Project inheritance. (What's this?)
  635. </li></bl>
  636. </blockquote>
  637. <blockquote>
  638. <bl><li>
  639. Target inheritance. That is, the ability to include targets from other
  640. project files, overriding them as necessary (so, cascading project
  641. files).
  642. </li></bl>
  643. </blockquote>
  644. <blockquote>
  645. <bl><li>
  646. Add an attribute to <code>&lt;ant&gt;</code> to feed back the environment
  647. (properties and taskdefs) from the child build to the parent.
  648. </li></bl>
  649. </blockquote>
  650. <blockquote>
  651. <bl><li>
  652. Allow a target to reference properties defined in another build-file.
  653. </li></bl>
  654. </blockquote>
  655. <p>
  656. <i><b>Documentation system</b></i>
  657. <p>
  658. <font face="Arial, Helvetica, sans-serif" size="-1">
  659. &nbsp;&nbsp;<b>Accepted</b> (with no decision on which system to use)
  660. </font>
  661. <blockquote>
  662. <bl><li>
  663. Generate docs by Anakia/XSLT.
  664. (Corollary of "move to a system that allows docs to be generated"?)
  665. </li></bl>
  666. </blockquote>
  667. <p>
  668. <i><b>Task API</b></i>
  669. <p>
  670. <font face="Arial, Helvetica, sans-serif" size="-1">
  671. &nbsp;&nbsp;<b>Accepted</b>
  672. </font>
  673. <blockquote>
  674. <bl><li>
  675. Tasks provide some way to identify their attributes from the outside.
  676. Possible solutions include a special method like <code>getProperties()</code>,
  677. an external describing file shipping with the task class or special
  678. Javadoc comments parsed by a custom doclet. Whatever the method, it
  679. should not impose any cost on run-time, as it is only used a small
  680. percentage of the time (design-time).
  681. </li></bl>
  682. </blockquote>
  683. <blockquote>
  684. <bl><li>
  685. Provide <code>&quot;failonerror&quot;</code>-like functionality to all tasks.
  686. (Provide this as an aspect?? Much like logging aspect or classloader aspect).
  687. </li></bl>
  688. </blockquote>
  689. <font face="Arial, Helvetica, sans-serif" size="-1">
  690. &nbsp;&nbsp;<b>Rejected</b>
  691. </font>
  692. <blockquote>
  693. <bl><li>
  694. Tasks should have access to its own XML representation.
  695. </blockquote>
  696. </li></bl>
  697. <blockquote>
  698. <bl><li>
  699. Task level if and unless attributes.
  700. </li></bl>
  701. </blockquote>
  702. <blockquote>
  703. <bl><li>
  704. Allow tasks to find out, whether another task has completed successfully.
  705. </li></bl>
  706. </blockquote>
  707. <p>
  708. <i><b>Logging</b></i>
  709. <blockquote>
  710. <bl><li>
  711. Allow build-file writers to modify logging (verbosity, for example)
  712. on a target-by-target or task-by-task basis.
  713. </li></bl>
  714. </blockquote>
  715. <blockquote>
  716. <bl><li>
  717. Make loggers configurable via build.xml.
  718. </li></bl>
  719. </blockquote>
  720. <p>
  721. <i><b>Multi-threading</b></i>
  722. <p>
  723. <font face="Arial, Helvetica, sans-serif" size="-1">
  724. &nbsp;&nbsp;<b>Accepted</b>
  725. </font>
  726. <blockquote>
  727. <bl><li>
  728. Multi-threaded execution of tasks within the same target.
  729. </li></bl>
  730. </blockquote>
  731. <font face="Arial, Helvetica, sans-serif" size="-1">
  732. &nbsp;&nbsp;<b>Rejected</b>
  733. </font>
  734. <blockquote>
  735. <bl><li>
  736. Multithreaded execution of targets.
  737. </li></bl>
  738. </blockquote>
  739. <p>
  740. <i><b>Procedural versus purely declarative</b></i>
  741. <p>
  742. <font face="Arial, Helvetica, sans-serif" size="-1">
  743. &nbsp;&nbsp;<b>Rejected</b>
  744. </font>
  745. <blockquote>
  746. <bl><li>
  747. Simple flow-control (<code>if-then-else</code>, <code>for</code>)
  748. </li></bl>
  749. </blockquote>
  750. <blockquote>
  751. <bl><li>
  752. Targets should be like methods, including a return value.
  753. </li></bl>
  754. </blockquote>
  755. <blockquote>
  756. <bl><li>
  757. Build-files should be purely declarative.
  758. </li></bl>
  759. </blockquote>
  760. <p>
  761. <i><b>Properties</b></i>
  762. <p>
  763. <font face="Arial, Helvetica, sans-serif" size="-1">
  764. &nbsp;&nbsp;<b>Accepted</b>
  765. </font>
  766. <blockquote>
  767. <bl><li>
  768. Ability to manage scoping of properties in general
  769. (ie., target/project/workspace).
  770. </li></bl>
  771. </blockquote>
  772. <p>
  773. <i><b>Templates</b></i>
  774. <p>
  775. <font face="Arial, Helvetica, sans-serif" size="-1">
  776. &nbsp;&nbsp;<b>Rejected</b>
  777. </font>
  778. <blockquote>
  779. <bl><li>
  780. It should be possible to provide general/(template?) build
  781. specifications, and to declare, for a concrete item, that it should be
  782. built according to such a general specification.
  783. </bl></li>
  784. </blockquote>
  785. <p>
  786. <i><b>XML issues</b></i>
  787. <p>
  788. <font face="Arial, Helvetica, sans-serif" size="-1">
  789. &nbsp;&nbsp;<b>Accepted</b>
  790. </font>
  791. <blockquote>
  792. <bl><li>
  793. A built-in mechanism to include build-file fragments &#150; something
  794. that doesn't use <code>SYSTEM</code> entities at all and therefore is
  795. XSchema-friendly, allows for property expansions, etc.
  796. </li></bl>
  797. </blockquote>
  798. <blockquote>
  799. <bl><li>
  800. Allow Ant to farm out attributes and elements that are <i>not</i>
  801. in the Ant namespace to other components (ie., hand <code>doc:</code> elements
  802. to the Documentation component or <code>log:</code> attributes to the Log
  803. policy component, etc.
  804. </li></bl>
  805. </blockquote>
  806. <font face="Arial, Helvetica, sans-serif" size="-1">
  807. &nbsp;&nbsp;<b>Rejected</b>
  808. </font>
  809. <blockquote>
  810. <bl><li>
  811. Let Ant ignore &#150; but warn &#150; if unknown XML elements or attributes
  812. occur in a build-file.
  813. </li></bl>
  814. </blockquote>
  815. <p>
  816. <i><b>Core extensions</b></i>
  817. <p>
  818. <font face="Arial, Helvetica, sans-serif" size="-1">
  819. &nbsp;&nbsp;<b>Accepted</b>
  820. </font>
  821. <blockquote>
  822. <bl><li>
  823. Allow sequence to be specified in <code>&quot;depends&quot;</code> attribute,
  824. or enhance <code>&lt;antcall&gt;</code> to work with current list of executed
  825. targets.
  826. </li></bl>
  827. </blockquote>
  828. <blockquote>
  829. <bl><li>
  830. Provide a way to define the order in which targets that a given target
  831. depends upon get executed. (Same as above?)
  832. </li></bl>
  833. </blockquote>
  834. <blockquote>
  835. <bl><li>
  836. Support nesting tasks into other elements &#150; not just as children of
  837. target &#150; as proposed by Thomas Christen in
  838. <a href http://marc.theaimsgroup.com/?l=ant-dev&m=98130655812010&w=2>
  839. his mail message</a>.
  840. </li></bl>
  841. </blockquote>
  842. <blockquote>
  843. <bl><li>
  844. Define task contexts that define various common aspects (logging,
  845. failure handling, etc.), and assign them to tasks.
  846. </li></bl>
  847. </blockquote>
  848. <font face="Arial, Helvetica, sans-serif" size="-1">
  849. &nbsp;&nbsp;<b>Rejected</b>
  850. </font>
  851. <blockquote>
  852. <bl><li>
  853. Allow named tasks to be defined by <code>&lt;script&gt;</code> elements.
  854. </li></bl>
  855. </blockquote>
  856. <blockquote>
  857. <bl><li>
  858. Specify an OnFail task or target that runs in case of a build
  859. failure.
  860. </li></bl>
  861. </blockquote>
  862. <blockquote>
  863. <bl><li>
  864. Make <code>if/unless</code> attributes check for the value of a property, not
  865. only its existance.
  866. </li></bl>
  867. </blockquote>
  868. <blockquote>
  869. <bl><li>
  870. Check for more than one condition in <code>if/unless</code> attributes.
  871. </li></bl>
  872. </blockquote>
  873. <p>
  874. <i><b>Organization</b></i>
  875. <p>
  876. <font face="Arial, Helvetica, sans-serif" size="-1">
  877. &nbsp;&nbsp;<b>Rejected</b>
  878. </font>
  879. <blockquote>
  880. <bl><li>
  881. Separate CVSes and code hierarchies for<b>:</b>
  882. </li></bl>
  883. <ul type="circle">
  884. <li>task engine [org.apache.task.*]</li>
  885. <li>project engine (ie., model of targets/projects/workspaces) +
  886. support/utility classes [org.apache.ant.*]</li>
  887. <li>core tasks (ie., tasks supported by Ant contributors) [org.apache.???]</li>
  888. </ul>
  889. </blockquote>
  890. <p>
  891. <i><b>Miscellaneous</b></i>
  892. <p>
  893. <font face="Arial, Helvetica, sans-serif" size="-1">
  894. &nbsp;&nbsp;<b>Accepted</b>
  895. </font>
  896. <blockquote>
  897. <bl><li>
  898. Internationalization.
  899. </li></bl>
  900. </blockquote>
  901. <p>
  902. <h4>
  903. VI. Things that were submitted late
  904. </h4>
  905. <p>
  906. <font face="Arial, Helvetica, sans-serif" size="-1">
  907. &nbsp;&nbsp;<b>Rejected</b>
  908. </font>
  909. <blockquote>
  910. <bl><li>
  911. Integration of the <code>&lt;depend&gt;</code> and <code>&lt;javac&gt;</code>
  912. tasks.
  913. </li></bl>
  914. </blockquote>
  915. <blockquote>
  916. <bl><li>
  917. Recursive property resolution (ie., resolving <code>${dist.${name}.dir}</code>)
  918. </li></bl>
  919. </blockquote>
  920. </body>
  921. </html>