conor 01/02/13 05:29:40 Modified: docs/manual/OptionalTasks Tag: ANT_13_BRANCH mparse.html Log: Updated MParse documentation Submitted by: Stephane Bailliez Revision Changes Path No revision No revision 1.1.2.2 +52 -18 jakarta-ant/docs/manual/OptionalTasks/mparse.html Index: mparse.html =================================================================== RCS file: /home/cvs/jakarta-ant/docs/manual/OptionalTasks/mparse.html,v retrieving revision 1.1.2.1 retrieving revision 1.1.2.2 diff -u -r1.1.2.1 -r1.1.2.2 --- mparse.html 2001/02/13 09:40:12 1.1.2.1 +++ mparse.html 2001/02/13 13:29:39 1.1.2.2 @@ -1,16 +1,20 @@ + -JavaCC Task +MParse Task -

MParse

+

MParse

+

by

+

Requirements

-

This task requires Metamata Development environment 1.1. It does not work as -is with the latest 2.0 version freely available at Metamata.

+

This task requires Metamata Development environment 2.0 freely available at Metamata.

Description

Invokes the Metamata MParse compiler @@ -51,32 +55,62 @@ Yes - workingdir + verbose - The temporary directory used by MParse. + Enable all messages - Yes + No + + + debugparser + + Enables parser debugging + + No + + + debugscanner + + Enables scanner debugging + + No - cleanuphack - Remove the stale file as well as the intermediate Sun + cleanup + Remove the intermediate Sun JavaCC file created during the transformation of the grammar file. - No. Default to false. + No. Default to false + + maxmemory + Set the maximum memory for the JVM. this is a convenient + way to set the -mx or -Xmx argument. + No +

Nested elements

-

userclasspath

-

 The userclasspath element is required and represents a PATH like +

jvmarg

+

Additional parameters may be passed to the VM via nested <jvmarg> +attributes. <jvmarg> allows all attributes described in Command +line arguments.

+

classpath

+

Sets class path (also source path unless one explicitly set). Overrides +METAPATH/CLASSPATH environment variables.  The classpath element represents a PATH like +structure.

+

sourcepath

+

Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like structure.

Example

-
  <mparse target="src/Parser.jj" metamatahome="c:/metamata" workingdir="c:/tmp">
  -    <userclasspath>
  -      <pathelement location="./lib/dependency.jar"/>
  -    </userclasspath>
  +
  <mparse target="c:/metamata/examples/parseexamples/javagrammars/singlefile/JavaParser.jj"
  +          metamatahome="c:/metamata" cleanup="true">
  +    <classpath>
  +      <pathelement location="c:/metamata/examples/"/>
  +    </classpath>
     </mparse>

- This invokes Metamata MParse installed in c:/metamata on a grammar file src/Parser.jj -with a working directory in c:/tmp and a specific classpath + This invokes Metamata MParse installed in c:/metamata on one of the grammar file +example (JavaParser.jj) + and cleans up the intermediate Sun JavaCC file.