diff --git a/docs/manual/OptionalTasks/jjtree.html b/docs/manual/OptionalTasks/jjtree.html
index 15b224231..51b74d56f 100644
--- a/docs/manual/OptionalTasks/jjtree.html
+++ b/docs/manual/OptionalTasks/jjtree.html
@@ -186,10 +186,356 @@ Example
This invokes JJTree on grammar file src/Parser.jjt, writing the generated
grammar file, Parser.jj, file to build/src. The grammar option NODE_USES_PARSER
is set to true when invoking JJTree.
+
+
+
Command Line JJTree options
+ and Generated Files (working directory: /tmp ) |
+ Ant 1.5.3 versus command line | +Ant 1.6 versus command line | +
jjtree grammar.jjt + /tmp/grammar.jj + /tmp/<generated>.java+ |
+ Same | +Same | +
jjtree relative/grammar.jjt + /tmp/grammar.jj + /tmp/<generated>.java+ |
+ +/tmp/relative/grammar.jj +/tmp/relative/<generated>.java+ |
+ Same | +
jjtree /tmp/absolute/grammar.jjt + /tmp/grammar.jj + /tmp/<generated>.java+ |
+ +/tmp/absolute/grammar.jj +/tmp/absolute/<generated>.java+ |
+ Same | +
jjtree -OUTPUT_DIRECTORY:relative grammar.jjt + /tmp/relative/grammar.jj + /tmp/relative/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_DIRECTORY:relative relative/grammar.jjt + /tmp/relative/grammar.jj + /tmp/relative/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_DIRECTORY:relative /tmp/absolute/grammar.jjt + /tmp/relative/grammar.jj + /tmp/relative/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_DIRECTORY:/tmp/absolute/ grammar.jjt + /tmp/absolute/grammar.jj + /tmp/absolute/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_DIRECTORY:/tmp/absolute/ relative/grammar.jjt + /tmp/absolute/grammar.jj + /tmp/absolute/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_DIRECTORY:/tmp/absolute/ /tmp/absolute/grammar.jjt + /tmp/absolute/grammar.jj + /tmp/absolute/<generated>.java+ |
+ Same | +Same | +
jjtree -OUTPUT_FILE:output.jj grammar.jjt + /tmp/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj relative/grammar.jjt + /tmp/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj /tmp/absolute/grammar.jjt + /tmp/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:relative grammar.jjt + /tmp/relative/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:relative relative/grammar.jjt + /tmp/relative/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:relative /tmp/absolute/grammar.jjt + /tmp/relative/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ grammar.jjt + /tmp/absolute/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ relative/grammar.jjt + /tmp/absolute/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ /tmp/absolute/grammar.jjt + /tmp/absolute/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj relative/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj /tmp/absolute/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:relative grammar.jjt + /tmp/relative/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:relative relative/grammar.jjt + /tmp/relative/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:relative /tmp/absolute/grammar.jjt + /tmp/relative/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ grammar.jjt + /tmp/absolute/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ relative/grammar.jjt + /tmp/absolute/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ /tmp/absolute/grammar.jjt + /tmp/absolute/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj relative/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj /tmp/absolute/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:D:/tmp/subdir/output.jj grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Not Supported *) | +
jjtree -OUTPUT_FILE:D:/tmp/subdir/output.jj relative/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Not Supported *) | +
jjtree -OUTPUT_FILE:D:/tmp/subdir/output.jj /tmp/absolute/grammar.jjt + /tmp/subdir/output.jj + /tmp/<generated>.java+ |
+ Not Supported | +Not Supported *) | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:relative grammar.jjt + /tmp/relative/tmp/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:relative relative/grammar.jjt + /tmp/relative/tmp/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:relative /tmp/absolute/grammar.jjt + /tmp/relative/tmp/subdir/output.jj + /tmp/relative/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ grammar.jjt + /tmp/absolute/tmp/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ relative/grammar.jjt + /tmp/absolute/tmp/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
jjtree -OUTPUT_FILE:/tmp/subdir/output.jj -OUTPUT_DIRECTORY:/tmp/absolute/ /tmp/absolute/grammar.jjt + /tmp/absolute/tmp/subdir/output.jj + /tmp/absolute/<generated>.java+ |
+ Not Supported | +Same | +
*) Footnote: When running JJTree with the Ant taskdesk jjtree the option -OUTPUT_DIRECTORY
must always
+be set, because the project's basedir and the ant working directory might differ. So even if you don't specify the jjtree taskdef
+outputdirectory JJTree will be called with the -OUTPUT_DIRECTORY
set to the project's basedirectory.
+But when the -OUTPUT_DIRECTORY
is set, the -OUTPUT_FILE
setting is handled as if relative to this
+-OUTPUT_DIRECTORY
. Thus when the -OUTPUT_FILE
is absolute or contains a drive letter we have a
+problem.
+Therefore absolute outputfiles (when the outputdirectory isn't specified) are made relative to the default directory.
+And for this reason outputfiles that contain a drive letter can't be supported.
By the way: specifying a drive letter in the -OUTPUT_FILE
when the -OUTPUT_DIRECTORY
is set, also
+results in strange behavior when running JJTree from the command line.
Copyright © 2001-2003 Apache Software Foundation. All rights Reserved.
+ + +