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.

index.html 26 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- Content Stylesheet for Site -->
  3. <!-- start the processing -->
  4. <html>
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  7. <meta name="author" value="Adam Murdoch">
  8. <meta name="email" value="adammurdoch@apache.org">
  9. <title>Apache Myrmidon - Myrmidon</title>
  10. </head>
  11. <body bgcolor="#ffffff" text="#000000" link="#525D76">
  12. <table border="0" width="100%" cellspacing="0">
  13. <!-- TOP IMAGE -->
  14. <tr>
  15. <td colspan="2">
  16. <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
  17. </td>
  18. </tr>
  19. </table>
  20. <table border="0" width="100%" cellspacing="4">
  21. <tr><td colspan="2">
  22. <hr noshade="" size="1"/>
  23. </td></tr>
  24. <tr>
  25. <!-- LEFT SIDE NAVIGATION -->
  26. <td valign="top" nowrap="true">
  27. <p><strong>Myrmidon</strong></p>
  28. <ul>
  29. <li> <a href="./index.html">Introduction</a>
  30. </li>
  31. </ul>
  32. </td>
  33. <td align="left" valign="top">
  34. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  35. <tr><td bgcolor="#525D76">
  36. <font color="#ffffff" face="arial,helvetica,sanserif">
  37. <a name="What is Myrmidon?"><strong>What is Myrmidon?</strong></a>
  38. </font>
  39. </td></tr>
  40. <tr><td>
  41. <blockquote>
  42. <p>
  43. Myrmidon is one of the Ant 2 proposals currently in development. You can
  44. read more about the goals of Ant 2
  45. <a href="http://jakarta.apache.org/ant/ant2/">here</a>.
  46. </p>
  47. <p>
  48. Myrmidon is a general-purpose <i>task engine</i>. It contains the basic
  49. building blocks for assembling any sort of task-based tool. Ant 2
  50. is an example of such a tool, which could be assembled using the Myrmidon task
  51. engine, and a library of build related tasks.
  52. </p>
  53. <p>
  54. Currently, Myrmidon is a prototype of what a task engine might look. It
  55. includes a small set of tasks and data types. We are currently porting
  56. many of the Ant 1.x tasks to the Myrmidon task engine.
  57. </p>
  58. <p>
  59. </p>
  60. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  61. <tr><td bgcolor="#828DA6">
  62. <font color="#ffffff" face="arial,helvetica,sanserif">
  63. <a name="Differences to Ant 1.x"><strong>Differences to Ant 1.x</strong></a>
  64. </font>
  65. </td></tr>
  66. <tr><td>
  67. <blockquote>
  68. <p>Some of the differences between Ant 1.x and Myrmidon:</p>
  69. <ul>
  70. <li>
  71. Groups of tasks can be assembled into self-describing <i>antlib</i> task
  72. libraries. This makes it very easy to distribute and install tasks and data-types.
  73. </li>
  74. <li>
  75. A project can import other projects, and reference their targets.
  76. </li>
  77. <li>
  78. Changes to the property model:
  79. <ul>
  80. <li>Properties and data type references now share the same namespace.</li>
  81. <li>Properties are mutable.</li>
  82. <li>Properties are scoped into global, local, and parent contexts.</li>
  83. </ul>
  84. </li>
  85. <li>
  86. Changes to task and data-type API:
  87. <ul>
  88. <li>An interface based API, through which a task interacts with the
  89. task engine, and the services it provides.</li>
  90. <li>A well-defined object lifecycle.</li>
  91. <li>Polymorphic types are supported when objects are configured.</li>
  92. <li>Reference handling is handled automatically when objects are configured.</li>
  93. <li>Aspects can be used to decorate tasks, to add facilities like logging,
  94. error handling, or user preferences.</li>
  95. </ul>
  96. </li>
  97. <li>
  98. A set of well-defined services and APIs have been introduced, to allow
  99. tasks to do their work without depending on other tasks:
  100. <ul>
  101. <li>Execute external commands.</li>
  102. <li>Execute other tasks.</li>
  103. <li>Manage ClassLoaders and Class-paths.</li>
  104. <li>Virtual file system (in progress).</li>
  105. <li>Execute Java applications (in progress).</li>
  106. <li>...</li>
  107. </ul>
  108. </li>
  109. </ul>
  110. </blockquote>
  111. </td></tr>
  112. </table>
  113. </blockquote>
  114. </td></tr>
  115. </table>
  116. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  117. <tr><td bgcolor="#525D76">
  118. <font color="#ffffff" face="arial,helvetica,sanserif">
  119. <a name="Building Myrmidon"><strong>Building Myrmidon</strong></a>
  120. </font>
  121. </td></tr>
  122. <tr><td>
  123. <blockquote>
  124. <p>
  125. First, you will need to fetch the Myrmidon source from CVS. The source
  126. can be source in the <code>proposal/myrmidon</code> directory of the
  127. Ant source tree. You should check out the <code>jakarta-ant</code> CVS
  128. module, as described
  129. <a href="http://jakarta.apache.org/site/cvsindex.html">here</a>.
  130. </p>
  131. <p>
  132. To build Myrmidon, use the <code>build.xml</code> build script. You will need
  133. to use Ant 1.4.1 or later. The default target builds the Myrmidon distribution
  134. into the <code>dist</code> directory. The distribution is a ready-to-run
  135. installation of Myrmidon.
  136. </p>
  137. </blockquote>
  138. </td></tr>
  139. </table>
  140. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  141. <tr><td bgcolor="#525D76">
  142. <font color="#ffffff" face="arial,helvetica,sanserif">
  143. <a name="Running Myrmidon"><strong>Running Myrmidon</strong></a>
  144. </font>
  145. </td></tr>
  146. <tr><td>
  147. <blockquote>
  148. <p>
  149. To run Myrmidon, use one of the following methods:
  150. </p>
  151. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  152. <tr><td bgcolor="#828DA6">
  153. <font color="#ffffff" face="arial,helvetica,sanserif">
  154. <a name="Launcher Script"><strong>Launcher Script</strong></a>
  155. </font>
  156. </td></tr>
  157. <tr><td>
  158. <blockquote>
  159. <p>
  160. On Windows and Unix platforms, you can use the <code>ant</code> script
  161. in the distribution's <code>bin</code> directory. The following environment
  162. variables can be used, but are not required (except on Windows 9x - see below).
  163. </p>
  164. <p>
  165. </p>
  166. <table>
  167. <tr>
  168. <td bgcolor="#039acc" colspan="" rowspan=""
  169. valign="top" align="left">
  170. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  171. Variable
  172. </font>
  173. </td>
  174. <td bgcolor="#039acc" colspan="" rowspan=""
  175. valign="top" align="left">
  176. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  177. Description
  178. </font>
  179. </td>
  180. </tr>
  181. <tr>
  182. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  183. valign="top" align="left">
  184. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  185. JAVA_HOME
  186. </font>
  187. </td>
  188. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  189. valign="top" align="left">
  190. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  191. The directory that the JDK is installed in.
  192. </font>
  193. </td>
  194. </tr>
  195. <tr>
  196. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  197. valign="top" align="left">
  198. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  199. JAVACMD
  200. </font>
  201. </td>
  202. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  203. valign="top" align="left">
  204. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  205. The command to use to start the JVM. Defaults to <code>java</code>.
  206. </font>
  207. </td>
  208. </tr>
  209. <tr>
  210. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  211. valign="top" align="left">
  212. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  213. ANT_HOME
  214. </font>
  215. </td>
  216. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  217. valign="top" align="left">
  218. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  219. The directory containing the Myrmidon distribution. This must be
  220. set when running on Windows 95, 98 or Me.
  221. </font>
  222. </td>
  223. </tr>
  224. </table>
  225. </blockquote>
  226. </td></tr>
  227. </table>
  228. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  229. <tr><td bgcolor="#828DA6">
  230. <font color="#ffffff" face="arial,helvetica,sanserif">
  231. <a name="Executable Jar File"><strong>Executable Jar File</strong></a>
  232. </font>
  233. </td></tr>
  234. <tr><td>
  235. <blockquote>
  236. <p>
  237. The Myrmidon distribution includes an executable Jar file, which can be used
  238. to run Myrmidon. Use the following command:
  239. </p>
  240. <pre>
  241. prompt&gt; <i>java</i> -jar <i>ant-home</i>/bin/myrmidon-launcher.jar <i>options</i>
  242. </pre>
  243. </blockquote>
  244. </td></tr>
  245. </table>
  246. <p>
  247. Run Myrmidon with the <code>-h</code> command-line option for a list of
  248. the command-line options that are available.
  249. </p>
  250. </blockquote>
  251. </td></tr>
  252. </table>
  253. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  254. <tr><td bgcolor="#525D76">
  255. <font color="#ffffff" face="arial,helvetica,sanserif">
  256. <a name="Project File"><strong>Project File</strong></a>
  257. </font>
  258. </td></tr>
  259. <tr><td>
  260. <blockquote>
  261. <p>
  262. The project file format is very similar to that of Ant 1. The root element of
  263. the project file must be a <code>&lt;project&gt;</code> element. It can
  264. take the following attributes:
  265. </p>
  266. <table>
  267. <tr>
  268. <td bgcolor="#039acc" colspan="" rowspan=""
  269. valign="top" align="left">
  270. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  271. Attribute
  272. </font>
  273. </td>
  274. <td bgcolor="#039acc" colspan="" rowspan=""
  275. valign="top" align="left">
  276. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  277. Description
  278. </font>
  279. </td>
  280. <td bgcolor="#039acc" colspan="" rowspan=""
  281. valign="top" align="left">
  282. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  283. Default Value
  284. </font>
  285. </td>
  286. </tr>
  287. <tr>
  288. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  289. valign="top" align="left">
  290. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  291. basedir
  292. </font>
  293. </td>
  294. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  295. valign="top" align="left">
  296. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  297. The base directory for the project.
  298. </font>
  299. </td>
  300. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  301. valign="top" align="left">
  302. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  303. The directory containing the project file.
  304. </font>
  305. </td>
  306. </tr>
  307. <tr>
  308. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  309. valign="top" align="left">
  310. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  311. default
  312. </font>
  313. </td>
  314. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  315. valign="top" align="left">
  316. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  317. The name of the default target.
  318. </font>
  319. </td>
  320. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  321. valign="top" align="left">
  322. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  323. <code>main</code>
  324. </font>
  325. </td>
  326. </tr>
  327. <tr>
  328. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  329. valign="top" align="left">
  330. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  331. version
  332. </font>
  333. </td>
  334. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  335. valign="top" align="left">
  336. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  337. The project file version that the project is written for.
  338. </font>
  339. </td>
  340. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  341. valign="top" align="left">
  342. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  343. None, must be <code>2.0</code>
  344. </font>
  345. </td>
  346. </tr>
  347. </table>
  348. <p>
  349. A <code>&lt;project&gt;</code> element can contain the following elements,
  350. in the order given below:
  351. </p>
  352. <ul>
  353. <li><a href="#Project References"><code>&lt;projectref&gt;</code></a></li>
  354. <li><a href="#Library Imports"><code>&lt;import&gt;</code></a></li>
  355. <li><a href="#Implicit Tasks">Implicit tasks</a></li>
  356. <li><a href="#Targets"><code>&lt;target&gt;</code></a></li>
  357. </ul>
  358. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  359. <tr><td bgcolor="#828DA6">
  360. <font color="#ffffff" face="arial,helvetica,sanserif">
  361. <a name="Project References"><strong>Project References</strong></a>
  362. </font>
  363. </td></tr>
  364. <tr><td>
  365. <blockquote>
  366. <p>Project references allow the project to import, or reference, other projects.
  367. A <code>&lt;projectref&gt;</code> element takes the following attributes:</p>
  368. <table>
  369. <tr>
  370. <td bgcolor="#039acc" colspan="" rowspan=""
  371. valign="top" align="left">
  372. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  373. Attribute
  374. </font>
  375. </td>
  376. <td bgcolor="#039acc" colspan="" rowspan=""
  377. valign="top" align="left">
  378. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  379. Description
  380. </font>
  381. </td>
  382. <td bgcolor="#039acc" colspan="" rowspan=""
  383. valign="top" align="left">
  384. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  385. Default Value
  386. </font>
  387. </td>
  388. </tr>
  389. <tr>
  390. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  391. valign="top" align="left">
  392. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  393. name
  394. </font>
  395. </td>
  396. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  397. valign="top" align="left">
  398. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  399. The name to use to identify the referenced project.
  400. </font>
  401. </td>
  402. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  403. valign="top" align="left">
  404. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  405. Required
  406. </font>
  407. </td>
  408. </tr>
  409. <tr>
  410. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  411. valign="top" align="left">
  412. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  413. location
  414. </font>
  415. </td>
  416. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  417. valign="top" align="left">
  418. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  419. The path to the project file to reference.
  420. </font>
  421. </td>
  422. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  423. valign="top" align="left">
  424. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  425. Required
  426. </font>
  427. </td>
  428. </tr>
  429. </table>
  430. <p>
  431. The targets of a referenced project can be used in the <code>depends</code> list
  432. of a target in the referencing project, using the following syntax:
  433. <code><i>project-name</i>-&gt;<i>target-name</i></code>.
  434. </p>
  435. </blockquote>
  436. </td></tr>
  437. </table>
  438. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  439. <tr><td bgcolor="#828DA6">
  440. <font color="#ffffff" face="arial,helvetica,sanserif">
  441. <a name="Library Imports"><strong>Library Imports</strong></a>
  442. </font>
  443. </td></tr>
  444. <tr><td>
  445. <blockquote>
  446. <p>Library imports allow the project to import the tasks and data-types from an
  447. antlib. An <code>&lt;import&gt;</code> element takes the following attributes:</p>
  448. <table>
  449. <tr>
  450. <td bgcolor="#039acc" colspan="" rowspan=""
  451. valign="top" align="left">
  452. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  453. Attribute
  454. </font>
  455. </td>
  456. <td bgcolor="#039acc" colspan="" rowspan=""
  457. valign="top" align="left">
  458. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  459. Description
  460. </font>
  461. </td>
  462. <td bgcolor="#039acc" colspan="" rowspan=""
  463. valign="top" align="left">
  464. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  465. Default Value
  466. </font>
  467. </td>
  468. </tr>
  469. <tr>
  470. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  471. valign="top" align="left">
  472. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  473. library
  474. </font>
  475. </td>
  476. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  477. valign="top" align="left">
  478. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  479. The name of the library to import. The <code>ext</code> directory
  480. of the Myrmidon distribution is searched for a library file with
  481. the given name, and an <code>atl</code> extension.
  482. </font>
  483. </td>
  484. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  485. valign="top" align="left">
  486. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  487. Required
  488. </font>
  489. </td>
  490. </tr>
  491. <tr>
  492. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  493. valign="top" align="left">
  494. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  495. type
  496. </font>
  497. </td>
  498. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  499. valign="top" align="left">
  500. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  501. The type of definition to import. Values include <code>task</code>,
  502. and <code>data-type</code>.
  503. </font>
  504. </td>
  505. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  506. valign="top" align="left">
  507. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  508. None
  509. </font>
  510. </td>
  511. </tr>
  512. <tr>
  513. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  514. valign="top" align="left">
  515. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  516. name
  517. </font>
  518. </td>
  519. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  520. valign="top" align="left">
  521. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  522. The name of the type to import.
  523. </font>
  524. </td>
  525. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  526. valign="top" align="left">
  527. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  528. None
  529. </font>
  530. </td>
  531. </tr>
  532. </table>
  533. <p>
  534. If the <code>type</code> and <code>name</code> attributes are not provided,
  535. the entire contents of the antlib are imported.
  536. </p>
  537. </blockquote>
  538. </td></tr>
  539. </table>
  540. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  541. <tr><td bgcolor="#828DA6">
  542. <font color="#ffffff" face="arial,helvetica,sanserif">
  543. <a name="Implicit Tasks"><strong>Implicit Tasks</strong></a>
  544. </font>
  545. </td></tr>
  546. <tr><td>
  547. <blockquote>
  548. <p>Implicit tasks are run before any of the project's targets are run.</p>
  549. </blockquote>
  550. </td></tr>
  551. </table>
  552. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  553. <tr><td bgcolor="#828DA6">
  554. <font color="#ffffff" face="arial,helvetica,sanserif">
  555. <a name="Targets"><strong>Targets</strong></a>
  556. </font>
  557. </td></tr>
  558. <tr><td>
  559. <blockquote>
  560. <p>Targets are the same as Ant 1.x.</p>
  561. </blockquote>
  562. </td></tr>
  563. </table>
  564. </blockquote>
  565. </td></tr>
  566. </table>
  567. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  568. <tr><td bgcolor="#525D76">
  569. <font color="#ffffff" face="arial,helvetica,sanserif">
  570. <a name="Tasks"><strong>Tasks</strong></a>
  571. </font>
  572. </td></tr>
  573. <tr><td>
  574. <blockquote>
  575. <p>
  576. The following table lists the current set of tasks. You can find example
  577. usages of these tasks in the sample project file <code>src/make/sample.ant</code>.
  578. </p>
  579. <table>
  580. <tr>
  581. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  582. valign="top" align="left">
  583. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  584. fail
  585. </font>
  586. </td>
  587. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  588. valign="top" align="left">
  589. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  590. Causes the build to fail.
  591. </font>
  592. </td>
  593. </tr>
  594. <tr>
  595. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  596. valign="top" align="left">
  597. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  598. if
  599. </font>
  600. </td>
  601. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  602. valign="top" align="left">
  603. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  604. Conditionally executes a set of tasks.
  605. </font>
  606. </td>
  607. </tr>
  608. <tr>
  609. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  610. valign="top" align="left">
  611. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  612. load-properties
  613. </font>
  614. </td>
  615. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  616. valign="top" align="left">
  617. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  618. Loads a set of properties from a file.
  619. </font>
  620. </td>
  621. </tr>
  622. <tr>
  623. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  624. valign="top" align="left">
  625. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  626. log
  627. </font>
  628. </td>
  629. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  630. valign="top" align="left">
  631. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  632. Writes a log message.
  633. </font>
  634. </td>
  635. </tr>
  636. <tr>
  637. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  638. valign="top" align="left">
  639. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  640. property
  641. </font>
  642. </td>
  643. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  644. valign="top" align="left">
  645. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  646. Sets a property.
  647. </font>
  648. </td>
  649. </tr>
  650. <tr>
  651. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  652. valign="top" align="left">
  653. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  654. try-catch
  655. </font>
  656. </td>
  657. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  658. valign="top" align="left">
  659. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  660. Runs a set of tasks, with a provided error and clean-up handler.
  661. </font>
  662. </td>
  663. </tr>
  664. <tr>
  665. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  666. valign="top" align="left">
  667. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  668. converter-def
  669. </font>
  670. </td>
  671. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  672. valign="top" align="left">
  673. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  674. Register a type converter. These are used when configuring a task
  675. or data-type from attributes.
  676. </font>
  677. </td>
  678. </tr>
  679. <tr>
  680. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  681. valign="top" align="left">
  682. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  683. type-def
  684. </font>
  685. </td>
  686. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  687. valign="top" align="left">
  688. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  689. Register a task or data-type.
  690. </font>
  691. </td>
  692. </tr>
  693. <tr>
  694. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  695. valign="top" align="left">
  696. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  697. import
  698. </font>
  699. </td>
  700. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  701. valign="top" align="left">
  702. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  703. Register the contents of an antlib.
  704. </font>
  705. </td>
  706. </tr>
  707. </table>
  708. </blockquote>
  709. </td></tr>
  710. </table>
  711. </td>
  712. </tr>
  713. <!-- FOOTER -->
  714. <tr><td colspan="2">
  715. <hr noshade="" size="1"/>
  716. </td></tr>
  717. <tr><td colspan="2">
  718. <div align="center"><font color="#525D76" size="-1"><em>
  719. Copyright &#169; 2000-2002, Apache Software Foundation
  720. </em></font></div>
  721. </td></tr>
  722. </table>
  723. </body>
  724. </html>
  725. <!-- end the processing -->