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

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