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.

buildfile.html 27 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673
  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 - User Guide</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> <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. </td>
  19. <td valign="bottom"><div align="right"><b><font size="+3" color="#525D76">Apache Myrmidon</font></b></div></td>
  20. </tr>
  21. </table>
  22. <table border="0" width="100%" cellspacing="4">
  23. <tr><td colspan="2">
  24. <hr noshade="" size="1"/>
  25. </td></tr>
  26. <tr>
  27. <!-- LEFT SIDE NAVIGATION -->
  28. <td valign="top" nowrap="true">
  29. <p><strong>Myrmidon</strong></p>
  30. <ul>
  31. <li> <a href="./index.html">Introduction</a>
  32. </li>
  33. <li> <a href="./getinvolved.html">Get Involved</a>
  34. </li>
  35. <li> <a href="./user.html">Building Myrmidon</a>
  36. </li>
  37. <li> <a href="./todo.html">Todo List</a>
  38. </li>
  39. </ul>
  40. <p><strong>User Guide</strong></p>
  41. <ul>
  42. <li> <a href="./buildfile.html">Build file</a>
  43. </li>
  44. <li> <a href="./vfs.html">Virtual File System</a>
  45. </li>
  46. <li> <a href="./ant1compat.html">Ant1 Compatibility Layer</a>
  47. </li>
  48. <li> <a href="./differences.html">Differences to Ant1</a>
  49. </li>
  50. </ul>
  51. <p><strong>Extending Ant</strong></p>
  52. <ul>
  53. <li> <a href="./task.html">Task Writers HOWTO</a>
  54. </li>
  55. <li> <a href="./classloader.html">ClassLoader HOWTO</a>
  56. </li>
  57. <li> <a href="./librarys.html">Library HOWTO</a>
  58. </li>
  59. </ul>
  60. <p><strong>Container Design</strong></p>
  61. <ul>
  62. </ul>
  63. </td>
  64. <td align="left" valign="top">
  65. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  66. <tr><td bgcolor="#525D76">
  67. <font color="#ffffff" face="arial,helvetica,sanserif">
  68. <a name="Project File"><strong>Project File</strong></a>
  69. </font>
  70. </td></tr>
  71. <tr><td>
  72. <blockquote>
  73. <p>
  74. The project file format is very similar to that of Ant 1. The root element of
  75. the project file must be a <code>&lt;project&gt;</code> element. It can
  76. take the following attributes:
  77. </p>
  78. <table>
  79. <tr>
  80. <td bgcolor="#039acc" colspan="" rowspan=""
  81. valign="top" align="left">
  82. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  83. Attribute
  84. </font>
  85. </td>
  86. <td bgcolor="#039acc" colspan="" rowspan=""
  87. valign="top" align="left">
  88. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  89. Description
  90. </font>
  91. </td>
  92. <td bgcolor="#039acc" colspan="" rowspan=""
  93. valign="top" align="left">
  94. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  95. Default Value
  96. </font>
  97. </td>
  98. </tr>
  99. <tr>
  100. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  101. valign="top" align="left">
  102. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  103. name
  104. </font>
  105. </td>
  106. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  107. valign="top" align="left">
  108. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  109. The project name.
  110. </font>
  111. </td>
  112. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  113. valign="top" align="left">
  114. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  115. The base-name of the project file, with the extension removed.
  116. </font>
  117. </td>
  118. </tr>
  119. <tr>
  120. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  121. valign="top" align="left">
  122. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  123. basedir
  124. </font>
  125. </td>
  126. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  127. valign="top" align="left">
  128. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  129. The base directory for the project. The base directory is used
  130. to resolve all relative file names used in the project file.
  131. </font>
  132. </td>
  133. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  134. valign="top" align="left">
  135. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  136. The directory containing the project file.
  137. </font>
  138. </td>
  139. </tr>
  140. <tr>
  141. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  142. valign="top" align="left">
  143. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  144. default
  145. </font>
  146. </td>
  147. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  148. valign="top" align="left">
  149. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  150. The name of the default target.
  151. </font>
  152. </td>
  153. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  154. valign="top" align="left">
  155. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  156. <code>main</code>
  157. </font>
  158. </td>
  159. </tr>
  160. <tr>
  161. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  162. valign="top" align="left">
  163. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  164. version
  165. </font>
  166. </td>
  167. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  168. valign="top" align="left">
  169. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  170. The project file version that the project is written for.
  171. </font>
  172. </td>
  173. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  174. valign="top" align="left">
  175. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  176. None, must be <code>2.0</code>
  177. </font>
  178. </td>
  179. </tr>
  180. </table>
  181. <p>
  182. A <code>&lt;project&gt;</code> element can contain the following elements,
  183. in the order given below:
  184. </p>
  185. <ul>
  186. <li><a href="#Project References"><code>&lt;projectref&gt;</code></a></li>
  187. <li><a href="#Library Imports"><code>&lt;import&gt;</code></a></li>
  188. <li><a href="#Implicit Tasks">Implicit tasks</a></li>
  189. <li><a href="#Targets"><code>&lt;target&gt;</code></a></li>
  190. </ul>
  191. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  192. <tr><td bgcolor="#828DA6">
  193. <font color="#ffffff" face="arial,helvetica,sanserif">
  194. <a name="Project References"><strong>Project References</strong></a>
  195. </font>
  196. </td></tr>
  197. <tr><td>
  198. <blockquote>
  199. <p>Project references allow the project to import, or reference, other projects.
  200. A <code>&lt;projectref&gt;</code> element takes the following attributes:</p>
  201. <table>
  202. <tr>
  203. <td bgcolor="#039acc" colspan="" rowspan=""
  204. valign="top" align="left">
  205. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  206. Attribute
  207. </font>
  208. </td>
  209. <td bgcolor="#039acc" colspan="" rowspan=""
  210. valign="top" align="left">
  211. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  212. Description
  213. </font>
  214. </td>
  215. <td bgcolor="#039acc" colspan="" rowspan=""
  216. valign="top" align="left">
  217. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  218. Default Value
  219. </font>
  220. </td>
  221. </tr>
  222. <tr>
  223. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  224. valign="top" align="left">
  225. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  226. name
  227. </font>
  228. </td>
  229. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  230. valign="top" align="left">
  231. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  232. The name to use to identify the referenced project.
  233. </font>
  234. </td>
  235. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  236. valign="top" align="left">
  237. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  238. Required
  239. </font>
  240. </td>
  241. </tr>
  242. <tr>
  243. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  244. valign="top" align="left">
  245. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  246. location
  247. </font>
  248. </td>
  249. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  250. valign="top" align="left">
  251. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  252. The path to the project file to reference.
  253. </font>
  254. </td>
  255. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  256. valign="top" align="left">
  257. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  258. Required
  259. </font>
  260. </td>
  261. </tr>
  262. </table>
  263. <p>
  264. The targets of a referenced project can be used in the <code>depends</code> list
  265. of a target in the referencing project, using the following syntax:
  266. <code><i>project-name</i>-&gt;<i>target-name</i></code>. Here is a simple example:</p>
  267. <div align="left">
  268. <table cellspacing="4" cellpadding="0" border="0">
  269. <tr>
  270. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  271. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  272. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  273. </tr>
  274. <tr>
  275. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  276. <td bgcolor="#ffffff"><pre>
  277. &lt;project version=&quot;2.0&quot;&gt;
  278. &lt;!-- Reference another project --&gt;
  279. &lt;projectref name=&quot;subproject&quot; location=&quot;subproject/build.xml&quot;/&gt;
  280. &lt;!-- Use the &quot;compile&quot; target from the referenced project --&gt;
  281. &lt;target name=&quot;main&quot; depends=&quot;subproject-&gt;compile&quot;&gt;
  282. .. do some stuff ..
  283. &lt;/target&gt;
  284. &lt;/project&gt;
  285. </pre></td>
  286. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  287. </tr>
  288. <tr>
  289. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  290. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  291. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  292. </tr>
  293. </table>
  294. </div>
  295. </blockquote>
  296. </td></tr>
  297. </table>
  298. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  299. <tr><td bgcolor="#828DA6">
  300. <font color="#ffffff" face="arial,helvetica,sanserif">
  301. <a name="Library Imports"><strong>Library Imports</strong></a>
  302. </font>
  303. </td></tr>
  304. <tr><td>
  305. <blockquote>
  306. <p>Library imports allow the project to import the tasks and data-types from an
  307. antlib. An <code>&lt;import&gt;</code> element takes the following attributes:</p>
  308. <table>
  309. <tr>
  310. <td bgcolor="#039acc" colspan="" rowspan=""
  311. valign="top" align="left">
  312. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  313. Attribute
  314. </font>
  315. </td>
  316. <td bgcolor="#039acc" colspan="" rowspan=""
  317. valign="top" align="left">
  318. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  319. Description
  320. </font>
  321. </td>
  322. <td bgcolor="#039acc" colspan="" rowspan=""
  323. valign="top" align="left">
  324. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  325. Default Value
  326. </font>
  327. </td>
  328. </tr>
  329. <tr>
  330. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  331. valign="top" align="left">
  332. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  333. library
  334. </font>
  335. </td>
  336. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  337. valign="top" align="left">
  338. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  339. The name of the library to import. The <code>ext</code> directory
  340. of the Myrmidon distribution is searched for a library file with
  341. the given name, and an <code>atl</code> extension.
  342. </font>
  343. </td>
  344. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  345. valign="top" align="left">
  346. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  347. Required
  348. </font>
  349. </td>
  350. </tr>
  351. <tr>
  352. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  353. valign="top" align="left">
  354. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  355. type
  356. </font>
  357. </td>
  358. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  359. valign="top" align="left">
  360. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  361. The type of definition to import. Values include <code>task</code>,
  362. and <code>data-type</code>.
  363. </font>
  364. </td>
  365. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  366. valign="top" align="left">
  367. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  368. None
  369. </font>
  370. </td>
  371. </tr>
  372. <tr>
  373. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  374. valign="top" align="left">
  375. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  376. name
  377. </font>
  378. </td>
  379. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  380. valign="top" align="left">
  381. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  382. The name of the type to import.
  383. </font>
  384. </td>
  385. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  386. valign="top" align="left">
  387. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  388. None
  389. </font>
  390. </td>
  391. </tr>
  392. </table>
  393. <p>
  394. If the <code>type</code> and <code>name</code> attributes are not provided,
  395. the entire contents of the antlib are imported.
  396. </p>
  397. <p>The following example import the <code>&lt;my-task&gt;</code> task from
  398. the <code>my-tasks</code> antlib.</p>
  399. <div align="left">
  400. <table cellspacing="4" cellpadding="0" border="0">
  401. <tr>
  402. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  403. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  404. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  405. </tr>
  406. <tr>
  407. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  408. <td bgcolor="#ffffff"><pre>
  409. &lt;project version=&quot;2.0&quot;&gt;
  410. &lt;!-- Import task &lt;my-task&gt; from the 'my-tasks' antlib. --&gt;
  411. &lt;import library=&quot;my-tasks&quot; type=&quot;task&quot; name=&quot;my-task&quot;/&gt;
  412. &lt;target name=&quot;main&quot;&gt;
  413. &lt;my-task some-prop=&quot;..&quot;/&gt;
  414. &lt;/target&gt;
  415. &lt;/project&gt;
  416. </pre></td>
  417. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  418. </tr>
  419. <tr>
  420. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  421. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  422. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  423. </tr>
  424. </table>
  425. </div>
  426. </blockquote>
  427. </td></tr>
  428. </table>
  429. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  430. <tr><td bgcolor="#828DA6">
  431. <font color="#ffffff" face="arial,helvetica,sanserif">
  432. <a name="Implicit Tasks"><strong>Implicit Tasks</strong></a>
  433. </font>
  434. </td></tr>
  435. <tr><td>
  436. <blockquote>
  437. <p>Implicit tasks are run before any of the project's targets are run. Any task
  438. can be used, including <code>&lt;property&gt;</code> and data-type instances.
  439. Implicit tasks can be used to initialise the project. For example:</p>
  440. <div align="left">
  441. <table cellspacing="4" cellpadding="0" border="0">
  442. <tr>
  443. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  444. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  445. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  446. </tr>
  447. <tr>
  448. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  449. <td bgcolor="#ffffff"><pre>
  450. &lt;project version=&quot;2.0&quot;&gt;
  451. &lt;property name=&quot;some-property&quot; value=&quot;some value&quot;/&gt;
  452. &lt;path id=&quot;classpath&quot;&gt;
  453. &lt;fileset dir=&quot;lib&quot;/&gt;
  454. &lt;/path&gt;
  455. &lt;log&gt;Set classpath to ${classpath}&lt;/log&gt;
  456. &lt;target name=&quot;main&quot;&gt;
  457. .. do some stuff ..
  458. &lt;/target&gt;
  459. &lt;/project&gt;
  460. </pre></td>
  461. <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  462. </tr>
  463. <tr>
  464. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  465. <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  466. <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  467. </tr>
  468. </table>
  469. </div>
  470. </blockquote>
  471. </td></tr>
  472. </table>
  473. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  474. <tr><td bgcolor="#828DA6">
  475. <font color="#ffffff" face="arial,helvetica,sanserif">
  476. <a name="Targets"><strong>Targets</strong></a>
  477. </font>
  478. </td></tr>
  479. <tr><td>
  480. <blockquote>
  481. <p>Targets have a similar format to targets in Ant 1.x, though some of the
  482. behaviour is different. A <code>&lt;target&gt;</code> element takes the
  483. following attributes:</p>
  484. <table>
  485. <tr>
  486. <td bgcolor="#039acc" colspan="" rowspan=""
  487. valign="top" align="left">
  488. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  489. Attribute
  490. </font>
  491. </td>
  492. <td bgcolor="#039acc" colspan="" rowspan=""
  493. valign="top" align="left">
  494. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  495. Description
  496. </font>
  497. </td>
  498. <td bgcolor="#039acc" colspan="" rowspan=""
  499. valign="top" align="left">
  500. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  501. Default Value
  502. </font>
  503. </td>
  504. </tr>
  505. <tr>
  506. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  507. valign="top" align="left">
  508. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  509. name
  510. </font>
  511. </td>
  512. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  513. valign="top" align="left">
  514. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  515. The name of the target.
  516. </font>
  517. </td>
  518. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  519. valign="top" align="left">
  520. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  521. Required
  522. </font>
  523. </td>
  524. </tr>
  525. <tr>
  526. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  527. valign="top" align="left">
  528. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  529. depends
  530. </font>
  531. </td>
  532. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  533. valign="top" align="left">
  534. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  535. A comma-separated list of targets that this target depends on.
  536. This list can contain targets from referenced projects.
  537. </font>
  538. </td>
  539. <td bgcolor="#a0ddf0" colspan="" rowspan=""
  540. valign="top" align="left">
  541. <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  542. None
  543. </font>
  544. </td>
  545. </tr>
  546. </table>
  547. </blockquote>
  548. </td></tr>
  549. </table>
  550. </blockquote>
  551. </td></tr>
  552. </table>
  553. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  554. <tr><td bgcolor="#525D76">
  555. <font color="#ffffff" face="arial,helvetica,sanserif">
  556. <a name="Tasks"><strong>Tasks</strong></a>
  557. </font>
  558. </td></tr>
  559. <tr><td>
  560. <blockquote>
  561. <p>
  562. Listed below are some of the current set of tasks. You can find example
  563. usages of these tasks in the sample project file <code>src/make/sample.ant</code>.
  564. </p>
  565. <h3><code>&lt;condition&gt;</code></h3>
  566. <p>Sets a property if a particular condition is true. See
  567. <a href="#Conditions">Conditions</a> for a list of available conditions.</p>
  568. <h3><code>&lt;fail&gt;</code></h3>
  569. <p>Causes the build to fail.</p>
  570. <h3><code>&lt;if&gt;</code></h3>
  571. <p>Conditionally executes a set of tasks.</p>
  572. <h3><code>&lt;load-properties&gt;</code></h3>
  573. <p>Loads a set of properties from a file.</p>
  574. <h3><code>&lt;log&gt;</code></h3>
  575. <p>Writes a log message.</p>
  576. <h3><code>&lt;property&gt;</code></h3>
  577. <p>Sets a property.</p>
  578. <h3><code>&lt;try-catch&gt;</code></h3>
  579. <p>Runs a set of tasks, with a provided error and clean-up handler.</p>
  580. <h3><code>&lt;converter-def&gt;</code></h3>
  581. <p>Register a type converter. These are used when configuring a task
  582. or data-type from attributes.</p>
  583. <h3><code>&lt;type-def&gt;</code></h3>
  584. <p>Register a task or data-type.</p>
  585. <h3><code>&lt;import&gt;</code></h3>
  586. <p>Register the contents of an antlib.</p>
  587. </blockquote>
  588. </td></tr>
  589. </table>
  590. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  591. <tr><td bgcolor="#525D76">
  592. <font color="#ffffff" face="arial,helvetica,sanserif">
  593. <a name="Conditions"><strong>Conditions</strong></a>
  594. </font>
  595. </td></tr>
  596. <tr><td>
  597. <blockquote>
  598. <p>The following conditions are available </p>
  599. <h3><code>&lt;and&gt;</code></h3>
  600. <p>Evaluates a set of nested conditions, and AND them together. Evaluation is
  601. lazy. An empty <code>&lt;and&gt;</code> condition evaluates to true.</p>
  602. <h3><code>&lt;available&gt;</code></h3>
  603. <p>Tests if a particular class or resource is available.</p>
  604. <h3><code>&lt;file-test&gt;</code></h3>
  605. <p>Tests a file against a set of <a href="vfs.html#File Selectors">file selectors</a>.</p>
  606. <h3><code>&lt;is-set&gt;</code></h3>
  607. <p>Tests whether a proeprty is set, and not set to 'false'.</p>
  608. <h3><code>&lt;or&gt;</code></h3>
  609. <p>Evaluates a set of nested conditions, and OR them together. Evaluation is
  610. lazy. An empty <code>&lt;or&gt;</code> evaluates to true.</p>
  611. <h3><code>&lt;os&gt;</code></h3>
  612. <p>Tests which operating system the build is running on.</p>
  613. <h3><code>&lt;not&gt;</code></h3>
  614. <p>Negates a nested condition.</p>
  615. </blockquote>
  616. </td></tr>
  617. </table>
  618. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  619. <tr><td bgcolor="#525D76">
  620. <font color="#ffffff" face="arial,helvetica,sanserif">
  621. <a name="File Name Mappers"><strong>File Name Mappers</strong></a>
  622. </font>
  623. </td></tr>
  624. <tr><td>
  625. <blockquote>
  626. <p>The following file name mappers are available:</p>
  627. <h3><code>&lt;chain&gt;</code></h3>
  628. <p>Applies a set of nested file name mappers to file names.</p>
  629. <h3><code>&lt;flatten&gt;</code></h3>
  630. <p>Maps all file names to a single directory.</p>
  631. <h3><code>&lt;prefix&gt;</code></h3>
  632. <p>Adds a prefix to the front of each file name.</p>
  633. <h3><code>&lt;map-extension&gt;</code></h3>
  634. <p>Changes the extension of file names.</p>
  635. </blockquote>
  636. </td></tr>
  637. </table>
  638. </td>
  639. </tr>
  640. <!-- FOOTER -->
  641. <tr><td colspan="2">
  642. <hr noshade="" size="1"/>
  643. </td></tr>
  644. <tr><td colspan="2">
  645. <div align="center"><font color="#525D76" size="-1"><em>
  646. Copyright &#169; 2000-2002, Apache Software Foundation
  647. </em></font></div>
  648. </td></tr>
  649. </table>
  650. </body>
  651. </html>
  652. <!-- end the processing -->