youys
/
ant
Not watched
1
0
Fork 1
Code
Releases 0 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
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.
Tree: a62c18b465
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'a62c18b465'
${ noResults }
ant/docs/manual/OptionalTasks/jjtree.html

542 lines
15 kB
Raw Blame History 

  1. <!doctype html public "-//w3c//dtd html 4.0 transitional//en">

  2. <html>

  3. <head>

  4.    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

  5.    <meta http-equiv="Content-Language" content="en-us">

  6.    <title>JJTree Task</title>

  7. </head>

  8. <body>

  9. 

  10. <h2>

  11. <a NAME="jjtree"></a>JJTree</h2>

  12. 

  13. <h3>

  14. Description</h3>

  15. <p>Invokes the <a href="http://javacc.dev.java.net/">JJTree</a> preprocessor

  16. for the JavaCC compiler compiler. It inserts parse tree building actions

  17. at various places in the JavaCC source that it generates. The output of

  18. JJTree is run through JavaCC to create the parser.

  19. <p>To use the jjtree task, set the <i>target</i> attribute to the name

  20. of the JJTree grammar file to process. You also need to specify the directory

  21. containing the JavaCC installation using the <i>javacchome</i> attribute,

  22. so that ant can find the JavaCC classes. Optionally, you can also set the

  23. <i>outputdirectory</i>

  24. to write the generated JavaCC grammar and node files to a specific directory.

  25. Otherwise jjtree writes the generated JavaCC grammar and node files to the directory

  26. containing the JJTree grammar file. As an extra option, you can also set the

  27. <i>outputfile</i> to write the generated JavaCC grammar file to a specific (directory and) file.

  28. Otherwise jjtree writes the generated JavaCC grammar file as the JJTree

  29. grammar file with a suffix .jj.</p>

  30. <p>This task only invokes JJTree if the grammar file is newer than the

  31. generated JavaCC file.</p>

  32. 

  33. <h3>Parameters</h3>

  34. 

  35. <table BORDER CELLSPACING=0 CELLPADDING=2 >

  36. <tr>

  37. <td VALIGN=TOP><b>Attribute</b></td>

  38. 

  39. <td VALIGN=TOP><b>Description</b></td>

  40. 

  41. <td ALIGN=CENTER VALIGN=TOP><b>Required</b></td>

  42. </tr>

  43. 

  44. <tr>

  45. <td VALIGN=TOP>target</td>

  46. 

  47. <td VALIGN=TOP>The jjtree grammar file to process.</td>

  48. 

  49. <td ALIGN=CENTER VALIGN=TOP>Yes</td>

  50. </tr>

  51. 

  52. <tr>

  53. <td VALIGN=TOP>javacchome</td>

  54. 

  55. <td VALIGN=TOP>The directory containing the JavaCC distribution.</td>

  56. 

  57. <td ALIGN=CENTER VALIGN=TOP>Yes</td>

  58. </tr>

  59. 

  60. <tr>

  61. <td VALIGN=TOP>outputdirectory</td>

  62. 

  63. <td VALIGN=TOP>The directory to write the generated JavaCC grammar and node files to.

  64. If not set, the files are written to the directory containing the grammar file.&nbsp;</td>

  65. 

  66. <td ALIGN=CENTER VALIGN=TOP>No</td>

  67. </tr>

  68. 

  69. <tr>

  70. <td VALIGN=TOP>outputfile</td>

  71. 

  72. <td VALIGN=TOP>The file to write the generated JavaCC grammar file

  73. to. If not set, the file is written with the same name as the JJTree

  74. grammar file but with a the suffix <code>.jj</code>.  This is a

  75. filename relative to <em>outputdirectory</em> if specified, the

  76. project's basedir.</td>

  77. 

  78. <td ALIGN=CENTER VALIGN=TOP>No</td>

  79. </tr>

  80. 

  81. <tr>

  82. <td VALIGN=TOP>buildnodefiles</td>

  83. 

  84. <td VALIGN=TOP>Sets the BUILD_NODE_FILES grammar option. This is a boolean

  85. option.</td>

  86. 

  87. <td ALIGN=CENTER VALIGN=TOP>No</td>

  88. </tr>

  89. 

  90. <tr>

  91. <td VALIGN=TOP>multi</td>

  92. 

  93. <td VALIGN=TOP>Sets the MULTI grammar option. This is a boolean option.</td>

  94. 

  95. <td ALIGN=CENTER VALIGN=TOP>No</td>

  96. </tr>

  97. 

  98. <tr>

  99. <td VALIGN=TOP>nodedefaultvoid</td>

  100. 

  101. <td VALIGN=TOP>Sets the NODE_DEFAULT_VOID grammar option. This is a boolean

  102. option.</td>

  103. 

  104. <td ALIGN=CENTER VALIGN=TOP>No</td>

  105. </tr>

  106. 

  107. <tr>

  108. <td VALIGN=TOP>nodefactory</td>

  109. 

  110. <td VALIGN=TOP>Sets the NODE_FACTORY grammar option. This is boolean option.</td>

  111. 

  112. <td ALIGN=CENTER VALIGN=TOP>No</td>

  113. </tr>

  114. 

  115. <tr>

  116. <td VALIGN=TOP>nodescopehook</td>

  117. 

  118. <td VALIGN=TOP>Sets the NODE_SCOPE_HOOK grammar option. This is a boolean

  119. option.</td>

  120. 

  121. <td ALIGN=CENTER VALIGN=TOP>No</td>

  122. </tr>

  123. 

  124. <tr>

  125. <td VALIGN=TOP>nodeusesparser</td>

  126. 

  127. <td VALIGN=TOP>Sets the NODE_USES_PARSER grammar option. This is a boolean

  128. option.</td>

  129. 

  130. <td ALIGN=CENTER VALIGN=TOP>No</td>

  131. </tr>

  132. 

  133. <tr>

  134. <td VALIGN=TOP>static</td>

  135. 

  136. <td VALIGN=TOP>Sets the STATIC grammar option. This is a boolean option.</td>

  137. 

  138. <td ALIGN=CENTER VALIGN=TOP>No</td>

  139. </tr>

  140. 

  141. <tr>

  142. <td VALIGN=TOP>visitor</td>

  143. 

  144. <td VALIGN=TOP>Sets the VISITOR grammar option. This is a boolean option.</td>

  145. 

  146. <td ALIGN=CENTER VALIGN=TOP>No</td>

  147. </tr>

  148. 

  149. <tr>

  150. <td VALIGN=TOP>nodepackage</td>

  151. 

  152. <td VALIGN=TOP>Sets the NODE_PACKAGE grammar option. This is a string option.</td>

  153. 

  154. <td ALIGN=CENTER VALIGN=TOP>No</td>

  155. </tr>

  156. 

  157. <tr>

  158. <td VALIGN=TOP>visitorexception</td>

  159. 

  160. <td VALIGN=TOP>Sets the VISITOR_EXCEPTION grammar option. This is a string

  161. option.</td>

  162. 

  163. <td ALIGN=CENTER VALIGN=TOP>No</td>

  164. </tr>

  165. 

  166. <tr>

  167. <td VALIGN=TOP>nodeprefix</td>

  168. 

  169. <td VALIGN=TOP>Sets the NODE_PREFIX grammar option. This is a string option.</td>

  170. 

  171. <td ALIGN=CENTER VALIGN=TOP>No</td>

  172. </tr>

  173. </table>

  174. 

  175. <h3>

  176. Example</h3>

  177. 

  178. <blockquote>

  179. <pre>&lt;jjtree&nbsp;

  180. &nbsp;&nbsp;&nbsp; target="src/Parser.jjt"&nbsp;

  181. &nbsp;&nbsp;&nbsp; outputdirectory="build/src"

  182. &nbsp;&nbsp;&nbsp; javacchome="c:/program files/JavaCC"&nbsp;

  183. &nbsp;&nbsp;&nbsp; nodeusesparser="true"

  184. /&gt;</pre>

  185. </blockquote>

  186. This invokes JJTree on grammar file src/Parser.jjt, writing the generated

  187. grammar file, Parser.jj, file to build/src. The grammar option NODE_USES_PARSER

  188. is set to true when invoking JJTree.

  189. <br>

  190. 

  191. <h3>Comparison output locations between command line JJTree and different Ant taskdef versions</h3>

  192. 

  193. <table cellpadding="3" border="1">

  194. <tr>

  195.   <td><b>Command Line JJTree options</b>

  196.     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<i>and Generated Files</i> (working directory: <code>/tmp</code>)</td>

  197.   <td><b>Ant 1.5.3</b> versus command line</td>

  198.   <td><b>Ant 1.6</b> versus command line</td>

  199. </tr>

  200. <tr>

  201.   <td><pre><b>jjtree  grammar.jjt</b>

  202.     /tmp/grammar.jj

  203.     /tmp/&lt;generated&gt;.java</pre>

  204.   </td>

  205.   <td>Same</td>

  206.   <td>Same</td>

  207. </tr>

  208. <tr>

  209.   <td><pre><b>jjtree  relative/grammar.jjt</b>

  210.     /tmp/grammar.jj

  211.     /tmp/&lt;generated&gt;.java</pre>

  212.   </td>

  213.   <td><pre>

  214. /tmp/relative/grammar.jj

  215. /tmp/relative/&lt;generated&gt;.java</pre>

  216.   </td>

  217.   <td>Same</td>

  218. </tr>

  219. <tr>

  220.   <td><pre><b>jjtree  /tmp/absolute/grammar.jjt</b>

  221.     /tmp/grammar.jj

  222.     /tmp/&lt;generated&gt;.java</pre>

  223.   </td>

  224.   <td><pre>

  225. /tmp/absolute/grammar.jj

  226. /tmp/absolute/&lt;generated&gt;.java</pre>

  227.   </td>

  228.   <td>Same</td>

  229. </tr>

  230. <tr>

  231.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:relative  grammar.jjt</b>

  232.     /tmp/relative/grammar.jj

  233.     /tmp/relative/&lt;generated&gt;.java</pre>

  234.   </td>

  235.   <td>Same</td>

  236.   <td>Same</td>

  237. </tr>

  238. <tr>

  239.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:relative  relative/grammar.jjt</b>

  240.     /tmp/relative/grammar.jj

  241.     /tmp/relative/&lt;generated&gt;.java</pre>

  242.   </td>

  243.   <td>Same</td>

  244.   <td>Same</td>

  245. </tr>

  246. <tr>

  247.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:relative  /tmp/absolute/grammar.jjt</b>

  248.     /tmp/relative/grammar.jj

  249.     /tmp/relative/&lt;generated&gt;.java</pre>

  250.   </td>

  251.   <td>Same</td>

  252.   <td>Same</td>

  253. </tr>

  254. <tr>

  255.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:/tmp/absolute/  grammar.jjt</b>

  256.     /tmp/absolute/grammar.jj

  257.     /tmp/absolute/&lt;generated&gt;.java</pre>

  258.   </td>

  259.   <td>Same</td>

  260.   <td>Same</td>

  261. </tr>

  262. <tr>

  263.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:/tmp/absolute/  relative/grammar.jjt</b>

  264.     /tmp/absolute/grammar.jj

  265.     /tmp/absolute/&lt;generated&gt;.java</pre>

  266.   </td>

  267.   <td>Same</td>

  268.   <td>Same</td>

  269. </tr>

  270. <tr>

  271.   <td><pre><b>jjtree  -OUTPUT_DIRECTORY:/tmp/absolute/  /tmp/absolute/grammar.jjt</b>

  272.     /tmp/absolute/grammar.jj

  273.     /tmp/absolute/&lt;generated&gt;.java</pre>

  274.   </td>

  275.   <td>Same</td>

  276.   <td>Same</td>

  277. </tr>

  278. <tr>

  279.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  grammar.jjt</b>

  280.     /tmp/output.jj

  281.     /tmp/&lt;generated&gt;.java</pre>

  282.   </td>

  283.   <td>Not Supported</td>

  284.   <td>Same</td>

  285. </tr>

  286. <tr>

  287.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  relative/grammar.jjt</b>

  288.     /tmp/output.jj

  289.     /tmp/&lt;generated&gt;.java</pre>

  290.   </td>

  291.   <td>Not Supported</td>

  292.   <td>Same</td>

  293. </tr>

  294. <tr>

  295.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  /tmp/absolute/grammar.jjt</b>

  296.     /tmp/output.jj

  297.     /tmp/&lt;generated&gt;.java</pre>

  298.   </td>

  299.   <td>Not Supported</td>

  300.   <td>Same</td>

  301. </tr>

  302. <tr>

  303.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:relative  grammar.jjt</b>

  304.     /tmp/relative/output.jj

  305.     /tmp/relative/&lt;generated&gt;.java</pre>

  306.   </td>

  307.   <td>Not Supported</td>

  308.   <td>Same</td>

  309. </tr>

  310. <tr>

  311.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:relative  relative/grammar.jjt</b>

  312.     /tmp/relative/output.jj

  313.     /tmp/relative/&lt;generated&gt;.java</pre>

  314.   </td>

  315.   <td>Not Supported</td>

  316.   <td>Same</td>

  317. </tr>

  318. <tr>

  319.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:relative  /tmp/absolute/grammar.jjt</b>

  320.     /tmp/relative/output.jj

  321.     /tmp/relative/&lt;generated&gt;.java</pre>

  322.   </td>

  323.   <td>Not Supported</td>

  324.   <td>Same</td>

  325. </tr>

  326. <tr>

  327.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  grammar.jjt</b>

  328.     /tmp/absolute/output.jj

  329.     /tmp/absolute/&lt;generated&gt;.java</pre>

  330.   </td>

  331.   <td>Not Supported</td>

  332.   <td>Same</td>

  333. </tr>

  334. <tr>

  335.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  relative/grammar.jjt</b>

  336.     /tmp/absolute/output.jj

  337.     /tmp/absolute/&lt;generated&gt;.java</pre>

  338.   </td>

  339.   <td>Not Supported</td>

  340.   <td>Same</td>

  341. </tr>

  342. <tr>

  343.   <td><pre><b>jjtree  -OUTPUT_FILE:output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  /tmp/absolute/grammar.jjt</b>

  344.     /tmp/absolute/output.jj

  345.     /tmp/absolute/&lt;generated&gt;.java</pre>

  346.   </td>

  347.   <td>Not Supported</td>

  348.   <td>Same</td>

  349. </tr>

  350. <tr>

  351.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  grammar.jjt</b>

  352.     /tmp/subdir/output.jj

  353.     /tmp/&lt;generated&gt;.java</pre>

  354.   </td>

  355.   <td>Not Supported</td>

  356.   <td>Same</td>

  357. </tr>

  358. <tr>

  359.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  relative/grammar.jjt</b>

  360.     /tmp/subdir/output.jj

  361.     /tmp/&lt;generated&gt;.java</pre>

  362.   </td>

  363.   <td>Not Supported</td>

  364.   <td>Same</td>

  365. </tr>

  366. <tr>

  367.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  /tmp/absolute/grammar.jjt</b>

  368.     /tmp/subdir/output.jj

  369.     /tmp/&lt;generated&gt;.java</pre>

  370.   </td>

  371.   <td>Not Supported</td>

  372.   <td>Same</td>

  373. </tr>

  374. <tr>

  375.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:relative  grammar.jjt</b>

  376.     /tmp/relative/subdir/output.jj

  377.     /tmp/relative/&lt;generated&gt;.java</pre>

  378.   </td>

  379.   <td>Not Supported</td>

  380.   <td>Same</td>

  381. </tr>

  382. <tr>

  383.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:relative  relative/grammar.jjt</b>

  384.     /tmp/relative/subdir/output.jj

  385.     /tmp/relative/&lt;generated&gt;.java</pre>

  386.   </td>

  387.   <td>Not Supported</td>

  388.   <td>Same</td>

  389. </tr>

  390. <tr>

  391.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:relative  /tmp/absolute/grammar.jjt</b>

  392.     /tmp/relative/subdir/output.jj

  393.     /tmp/relative/&lt;generated&gt;.java</pre>

  394.   </td>

  395.   <td>Not Supported</td>

  396.   <td>Same</td>

  397. </tr>

  398. <tr>

  399.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  grammar.jjt</b>

  400.     /tmp/absolute/subdir/output.jj

  401.     /tmp/absolute/&lt;generated&gt;.java</pre>

  402.   </td>

  403.   <td>Not Supported</td>

  404.   <td>Same</td>

  405. </tr>

  406. <tr>

  407.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  relative/grammar.jjt</b>

  408.     /tmp/absolute/subdir/output.jj

  409.     /tmp/absolute/&lt;generated&gt;.java</pre>

  410.   </td>

  411.   <td>Not Supported</td>

  412.   <td>Same</td>

  413. </tr>

  414. <tr>

  415.   <td><pre><b>jjtree  -OUTPUT_FILE:subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  /tmp/absolute/grammar.jjt</b>

  416.     /tmp/absolute/subdir/output.jj

  417.     /tmp/absolute/&lt;generated&gt;.java</pre>

  418.   </td>

  419.   <td>Not Supported</td>

  420.   <td>Same</td>

  421. </tr>

  422. <tr>

  423.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  grammar.jjt</b>

  424.     /tmp/subdir/output.jj

  425.     /tmp/&lt;generated&gt;.java</pre>

  426.   </td>

  427.   <td>Not Supported</td>

  428.   <td>Same</td>

  429. </tr>

  430. <tr>

  431.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  relative/grammar.jjt</b>

  432.     /tmp/subdir/output.jj

  433.     /tmp/&lt;generated&gt;.java</pre>

  434.   </td>

  435.   <td>Not Supported</td>

  436.   <td>Same</td>

  437. </tr>

  438. <tr>

  439.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  /tmp/absolute/grammar.jjt</b>

  440.     /tmp/subdir/output.jj

  441.     /tmp/&lt;generated&gt;.java</pre>

  442.   </td>

  443.   <td>Not Supported</td>

  444.   <td>Same</td>

  445. </tr>

  446. <tr>

  447.   <td><pre><b>jjtree  -OUTPUT_FILE:<i><u>D:</u></i>/tmp/subdir/output.jj  grammar.jjt</b>

  448.     /tmp/subdir/output.jj

  449.     /tmp/&lt;generated&gt;.java</pre>

  450.   </td>

  451.   <td>Not Supported</td>

  452.   <td>Not Supported *)</td>

  453. </tr>

  454. <tr>

  455.   <td><pre><b>jjtree  -OUTPUT_FILE:<i><u>D:</u></i>/tmp/subdir/output.jj  relative/grammar.jjt</b>

  456.     /tmp/subdir/output.jj

  457.     /tmp/&lt;generated&gt;.java</pre>

  458.   </td>

  459.   <td>Not Supported</td>

  460.   <td>Not Supported *)</td>

  461. </tr>

  462. <tr>

  463.   <td><pre><b>jjtree  -OUTPUT_FILE:<i><u>D:</u></i>/tmp/subdir/output.jj  /tmp/absolute/grammar.jjt</b>

  464.     /tmp/subdir/output.jj

  465.     /tmp/&lt;generated&gt;.java</pre>

  466.   </td>

  467.   <td>Not Supported</td>

  468.   <td>Not Supported *)</td>

  469. </tr>

  470. <tr>

  471.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:relative  grammar.jjt</b>

  472.     /tmp/relative/tmp/subdir/output.jj

  473.     /tmp/relative/&lt;generated&gt;.java</pre>

  474.   </td>

  475.   <td>Not Supported</td>

  476.   <td>Same</td>

  477. </tr>

  478. <tr>

  479.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:relative  relative/grammar.jjt</b>

  480.     /tmp/relative/tmp/subdir/output.jj

  481.     /tmp/relative/&lt;generated&gt;.java</pre>

  482.   </td>

  483.   <td>Not Supported</td>

  484.   <td>Same</td>

  485. </tr>

  486. <tr>

  487.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:relative  /tmp/absolute/grammar.jjt</b>

  488.     /tmp/relative/tmp/subdir/output.jj

  489.     /tmp/relative/&lt;generated&gt;.java</pre>

  490.   </td>

  491.   <td>Not Supported</td>

  492.   <td>Same</td>

  493. </tr>

  494. <tr>

  495.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  grammar.jjt</b>

  496.     /tmp/absolute/tmp/subdir/output.jj

  497.     /tmp/absolute/&lt;generated&gt;.java</pre>

  498.   </td>

  499.   <td>Not Supported</td>

  500.   <td>Same</td>

  501. </tr>

  502. <tr>

  503.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  relative/grammar.jjt</b>

  504.     /tmp/absolute/tmp/subdir/output.jj

  505.     /tmp/absolute/&lt;generated&gt;.java</pre>

  506.   </td>

  507.   <td>Not Supported</td>

  508.   <td>Same</td>

  509. </tr>

  510. <tr>

  511.   <td><pre><b>jjtree  -OUTPUT_FILE:/tmp/subdir/output.jj  -OUTPUT_DIRECTORY:/tmp/absolute/  /tmp/absolute/grammar.jjt</b>

  512.     /tmp/absolute/tmp/subdir/output.jj

  513.     /tmp/absolute/&lt;generated&gt;.java</pre>

  514.   </td>

  515.   <td>Not Supported</td>

  516.   <td>Same</td>

  517. </tr>

  518. </table>

  519. 

  520. <p>*) <u>Footnote</u>: When running JJTree with the Ant taskdef <i>jjtree</i> the option <code>-OUTPUT_DIRECTORY</code> must always 

  521. be set, because the project's basedir and the ant working directory might differ. So even if you don't specify the jjtree taskdef 

  522. <i>outputdirectory</i> JJTree will be called with the <code>-OUTPUT_DIRECTORY</code> set to the project's basedirectory. 

  523. But when the <code>-OUTPUT_DIRECTORY</code> is set, the <code>-OUTPUT_FILE</code> setting is handled as if relative to this 

  524. <code>-OUTPUT_DIRECTORY</code>. Thus when the <code>-OUTPUT_FILE</code> is absolute or contains a drive letter we have a 

  525. problem. 

  526. Therefore absolute <i>outputfile</i>s (when the <i>outputdirectory</i> isn't specified) are made relative to the default directory.

  527. And for this reason <i>outputfile</i>s that contain a drive letter can't be supported.</p>

  528. 

  529. <p>By the way: specifying a drive letter in the <code>-OUTPUT_FILE</code> when the <code>-OUTPUT_DIRECTORY</code> is set, also 

  530. results in strange behavior when running JJTree from the command line.</p>

  531. 

  532. <br>

  533. <hr>

  534. <p align="center">Copyright &copy; 2001-2004 The Apache Software Foundation. All rights

  535. Reserved.</p>

  536. 

  537. 

  538. 

  539. </body>

  540. </html>