[Jython-checkins] CVS: jython/Doc compile.ht,2.1,2.2

[Finn B. <bc...@us...>]

Update of /cvsroot/jython/jython/Doc
In directory usw-pr-cvs1:/tmp/cvs-serv22486

Modified Files:
	compile.ht 
Log Message:
Added more infor about tools and our build process.



Index: compile.ht
===================================================================
RCS file: /cvsroot/jython/jython/Doc/compile.ht,v
retrieving revision 2.1
retrieving revision 2.2
diff -C2 -r2.1 -r2.2
*** compile.ht	2000/11/12 22:22:06	2.1
--- compile.ht	2001/02/07 09:32:11	2.2
***************
*** 12,25 ****
  mind.</P>
  
! <P>Some of the sources in the org.python.parser package are generated 
  from python.jtt file by the JavaCC parser generator. If you need to 
  make changes to the grammar file you will need to download this 
! <A HREF="http://www.metamata.com/javacc/">JavaCC</A> too. The generated
! files are also in the distribution, so usually this is not necessary.
  
  <P>To regenerate the parser from the grammar, run jjtree on python.jjt, 
  and then run javacc on the resulting python.jj. This should produce all
  of the required source files to build the org.python.parser package.
  
  <P>If you have further interest in the Jython source and Jython's 
  continued development, you can read the archives for the 
--- 12,52 ----
  mind.</P>
  
! <ul>
! <li>The source directories from CVS or the nightly buils contain both 
! makefiles and a build.xml file. Only the build.xml is updated at this time.
! We are using ant-1.2 to compile the sources and create the .jar file.
! <p>
! 
! <li>Some of the sources in the org.python.parser package are generated 
  from python.jtt file by the JavaCC parser generator. If you need to 
  make changes to the grammar file you will need to download this 
! JavaCC. The generated files are also in the distribution, so usually
! this is not necessary.
  
  <P>To regenerate the parser from the grammar, run jjtree on python.jjt, 
  and then run javacc on the resulting python.jj. This should produce all
  of the required source files to build the org.python.parser package.
+ The build.xml file already contain the needed entries to run the JavaCC
+ program when the python.jjt is modified.
+ <p>
+ 
+ <li>The source directories contain several files that require Java2. These
+ files are normally easily recoqnizable because they have the number "2"
+ in their name.
+ 
+ <P>When compiling jython with Java1 compiler (like the JDK1.1), these
+ java2 files can be safely ignored. Jython will work even when these classes
+ files are missing.
+ The build.xml file have a conditional check and will not try to compile
+ the Java2 sources when using a Java1 compiler.
+ <p>
+ 
+ <li>One of the sources depends on the servlet classes and can only compile
+ when servlet.jar is included on the classpath. Again, the build.xml have
+ a conditional check and will not compile the PyServlet class if the 
+ servlet classes isn't available during compilation.
  
+ </ul>
+ 
  <P>If you have further interest in the Jython source and Jython's 
  continued development, you can read the archives for the 
***************
*** 32,35 ****
  
  <hr>
! <sup>1</sup>JavaCC version 2.0 is used to create the generated sources
! included with the distribution.
--- 59,68 ----
  
  <hr>
! 
! Suggested tools and support software:
! 
! <ul>
! <li> <A HREF="http://www.metamata.com/javacc/">JavaCC 2.0</A>
! <li> <A HREF="http://jakarta.apache.org/ant/">Ant 1.2</A>
! <li> <A HREF="http://java.sun.com/products/servlet/index.html">Servlet classes</A>
! </ul>
\ No newline at end of file