Attachment 51858 Details for Bug 160683 – update to generateParser.html

[patch] update to generateParser.html

patch-generateParser (text/plain), 5.34 KB, created by Perry James

on 2006-10-12 11:05:10 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Perry James

Created: 2006-10-12 11:05:10 EDT

Size: 5.34 KB

patch

obsolete

>### Eclipse Workspace Patch 1.0
>#P jdt-core-home
>Index: howto/generate parser/generateParser.html
>===================================================================
>RCS file: /cvsroot/eclipse/jdt-core-home/howto/generate parser/generateParser.html,v
>retrieving revision 1.6
>diff -u -r1.6 generateParser.html
>--- howto/generate parser/generateParser.html	26 Sep 2006 07:58:10 -0000	1.6
>+++ howto/generate parser/generateParser.html	12 Oct 2006 14:54:48 -0000
>@@ -29,7 +29,7 @@
> <tr>
> 	<td ALIGN=RIGHT VALIGN=TOP WIDTH="2%"><img SRC="http://dev.eclipse.org/images/Adarrow.gif" NOSAVE BORDER=0 height=16 width=16></td>
> 	<td WIDTH="98%">Where to get the grammar 
>-	<blockquote>The latest grammar is always located in the <code>java_1_5.g</code> file. Go to the org.eclipse.jdt.core plugins
>+	<blockquote>The latest grammar is always located in the <code>java_1_5.g</code> file. (N.B.: Older versions of the grammar, such as java_1_4.g are not supported and are no longer functional.) Go to the org.eclipse.jdt.core plugins
> 	directory (eclipse\plugins\org.eclipse.jdt.core where eclipse is the root of your eclipse installation) and open the 
> 	grammar directory. Then search for the java_1_5.g file inside the
> 	folder grammar. Then copy its contents from: 
>@@ -40,7 +40,8 @@
> -- need a carriage return after the $end
> </PRE>
> 	into a file called java.g. It is important to add a carriage return at the end of the last line.
>-	You can save this file where you want, we will assume from thereon you saved it in <code>d:\temp\</code>.
>+	You can save this file where you want, we will assume from thereon you saved it in <code>d:\temp\</code>. 
>+	Also make sure that the file has Unix-style end-of-line characters (i.e., not those of MS-DOS), as the parser generator is quite picky about this.
> 	</blockquote>
> 	
> 	</td>
>@@ -49,7 +50,7 @@
> 	<td ALIGN=RIGHT VALIGN=TOP WIDTH="2%"><img SRC="http://dev.eclipse.org/images/Adarrow.gif" NOSAVE BORDER=0 height=16 width=16></td>
> 	<td WIDTH="98%">What to do with these files and update the parser class... 
> 	<blockquote>
>-Assuming, the LPG executable (<code>lpg.exe</code> or <code>jikespg.exe</code>) is located inside <code>d:\lpg</code>.
>+Assuming the LPG executable (<code>lpg.exe</code> or <code>jikespg.exe</code>) is located in <code>d:\lpg</code>.
> <ol>
> <li>First in a console, run:
> <PRE>
>@@ -128,25 +129,25 @@
> 
> Escaped symbol $error is an invalid C variable.
> </PRE>
>- It can be quite different if the output changed since the version 2.30 of lpg. The important part is: 
>+ It can be quite different if the output changed since version 2.30 of LPG. The important part is: 
> <blockquote>This grammar is LALR(1).</blockquote>
>- This creates in the current directory some java source files and information files.
>+ This creates some java source files and information files in the current directory.
> <blockquote><table BORDER=1 CELLSPACING=2 CELLPADDING=10>
> <tr>
> <th VALIGN=top align=left>java.l</th>
>- <td VALIGN=top>Information generated by lpg/jikespg. Enumarate all the states created for the automaton, etc.</td>
>+ <td VALIGN=top>Log information generated by lpg/jikespg. Enumarates all the states created for the automaton, etc.</td>
> </tr>
> <tr>
> <th VALIGN=top align=left>JavaAction.java</th>
>- <td>It contains the method consumeRule(int) of the class org.eclipse.jdt.internal.compiler.parser.Parser that handles all semantic actions dispatches.</td>
>+ <td>Contains the method consumeRule(int) of class org.eclipse.jdt.internal.compiler.parser.Parser, which handles all semantic action dispatches.</td>
> </tr>
> <tr>
> <th VALIGN=top align=left>javahdr.java</th>
>- <td>This files is used to generate the resources files.</td>
>+ <td>Used to generate the resources files.</td>
> </tr>
> <tr>
> <th VALIGN=top align=left>javadcl.java</th>
>- <td>This files is used to generate the resources files.</td>
>+ <td>Used to generate the resources files.</td>
> </tr>
> <tr>
> <th VALIGN=top align=left>javasym.java</th>
>@@ -167,8 +168,9 @@
> <ol>
> <li>Copy the contents of the JavaAction.java file into the consumeRule(int) method of the org.eclipse.jdt.internal.compiler.parser.Parser class.
> </li>
>- <li>The class org.eclipse.jdt.internal.compiler.parser.ParserBasicInformation needs to be updated with the content of the file javadef.java. Don't copy the 
>+ <li>The class org.eclipse.jdt.internal.compiler.parser.ParserBasicInformation needs to be updated with the contents of the file javadef.java. Don't copy the 
> interface name. Simply copy the field declarations. The actual source of this class will guide you.</li>
>+ <li>Similarly, update the class org.eclipse.jdt.internal.compiler.parser.TerminalTokens with the contents of the file javasym.java.
> <li>The last step is to update the resource files: 
> Copy the jdtcore.jar file in d:\temp. Compile this <A HREF="UpdateParserFiles.java">source</A> inside d:\temp. You will have a file UpdateParserFiles.class.
> Then run the following command-line:

Actions: View | Diff

Attachments on bug 160683: 51858