aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKenneth Russel <[email protected]>2005-09-30 15:58:07 +0000
committerKenneth Russel <[email protected]>2005-09-30 15:58:07 +0000
commit79bd75920f2e77d076acfebc20c0c8d5a529c3ca (patch)
tree8e1f99a6c0543b0186875426d0c1145468be1486
parent7bccc77fd8885dcd92c16313e84ccbe315c2a616 (diff)
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
-rw-r--r--doc/HowToBuild.html19
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>