jvanzyl 00/10/26 21:44:28 Added: src/java/org/apache/velocity/runtime/parser BUILD_README.txt Log: Notes on the current parser build process. Revision Changes Path 1.1 jakarta-velocity/src/java/org/apache/velocity/runtime/parser/BUILD_README.txt Index: BUILD_README.txt =================================================================== Quick Note: ----------- The parser is a 'special' piece of the build tree - currently it doesn't behave as everything else due to javacc and the package layout. 1) The build script in this directory will take care of the simple case when the parser is modified via Parser.jjt. It runs 'jjtree' on Parser.jjt to make the AST nodes (which are then deleted later - more on this in a bit) and creates Parser.jj for javacc. 2) Javacc is then run on Parser.jj to make Parser.java, which will be compiled like any other piece of java source via build-velocity.sh (or whatever follows.) 3) In the event that something 'serious' changes, such as an AST node is created or altered, it must be *manually* moved to the node subdirectory, and have it's package declaration fixed. This should be an extremely rare event at this point and will change with javacc 2.0. -gmj
