Added FAQs on common errors building JOGL

git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@389 232f8b59-042b-4e1e-8c03-345bb8c30851

1 files changed, 19 insertions, 0 deletions

diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html
index be17b7e95..9a5742d61 100644
--- a/doc/HowToBuild.html
+++ b/doc/HowToBuild.html
@@ -43,6 +43,25 @@ author of the grammar as having been investigated completely and
 harmless, and the warnings about our modifications are also 
 harmless. <P>
 
+<h2> Common build problems </h2>
+
+<OL>
+
+<LI> <B>Your CLASSPATH environment variable appears to be set (some JOGL classes are currently visible to the build.)</B>, and $CLASSPATH isn't set.
+
+<DL>
+<DD> An older version of JOGL was installed into the extension directory of the JDK you're using to build the current JOGL. On Windows and Linux, delete any ANTLR jars from jre/lib/ext, and on Mac OS X, delete them from /Library/Java/Extensions. It is generally not a good idea to drop JOGL directly into the extensions directory, as this can interfere with upgrades via Java Web Start.
+</DL>
+
+<LI> <B>CharScanner; panic: ClassNotFoundException: com.sun.gluegen.cgram.CToken</B>
+
+<DL>
+<DD> This occurs because ANTLR was dropped into the Extensions
+directory of the JRE/JDK. On Windows and Linux, delete any ANTLR jars from jre/lib/ext, and on Mac OS X, delete them from /Library/Java/Extensions. Use the antlr.jar property in the build.xml to point to a JRE-external location of this jar file.
+</DL>
+
+</OL>
+
 - Christopher Kline and Kenneth Russell, June 2003
 
 </body>