summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/HowToBuild.html59
-rw-r--r--doc/userguide/index.html13
2 files changed, 69 insertions, 3 deletions
diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html
index 76564edd8..8fab8bdbf 100644
--- a/doc/HowToBuild.html
+++ b/doc/HowToBuild.html
@@ -8,9 +8,62 @@
<h1>How to build the JOGL OpenGL binding for Java</h1>
<hr>
-Here are the steps that are required in order to build the JOGL
-OpenGL binding from a fresh copy of the source distribution:
-
+<P>
+
+The following are the supported build environments and
+platforms for JOGL. All require the <a
+href="http://www.antlr.org/">ANTLR</a> parser generator and the <a
+href="http://ant.apache.org/">Ant</a> build system version 1.6 or
+later to be installed. </p>
+
+<ul>
+<li> Solaris/SPARC and Solaris/x86, 32- and 64-bit
+ <ul>
+ <li> <a href="http://www.sun.com/software/solaris/">Solaris 8 or later</a> </li>
+ <li> <a href="http://www.sun.com/software/products/studio/">Sun ONE Studio 8 Compiler Collection or later</a> </li>
+ <li> <a href="http://www.sun.com/software/graphics/opengl/">Sun OpenGL for Solaris</a> (or <a href="http://www.mesa3d.org/">Mesa</a> for Solaris 9 x86) </li>
+ <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+ </ul>
+</li>
+<li> Linux/x86, 32- and 64-bit
+ <ul>
+ <li> Red Hat Linux 7.3 or later </li>
+ <li> GCC </li>
+ <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+ </ul>
+</li>
+<li> Macintosh PowerPC or Intel
+ <ul>
+ <li> Mac OS X 10.3 (note: will not work with earlier releases) </li>
+ <li> GCC </li>
+ <li> <a href="http://www.apple.com/java/">Java 1.4.2 or later for Mac OS X</a> </li>
+ </ul>
+</li>
+<li> Windows/x86 (32-bit currently, but 64-bit is known to work)
+ <ul>
+ <li> Windows 2000 or later </li>
+ <li> Microsoft Visual C++ 6.0 or later, or <a href="http://www.mingw.org/">MinGW</a> compilers </li>
+ <li> <a href="http://java.sun.com/j2se/1.4.2/">Sun JDK 1.4.2 or later</a> </li>
+ </ul>
+</li>
+</ul>
+
+<P>
+
+Additional platforms such as FreeBSD and HP/UX are handled by the
+build system, but are not officially supported.
+
+</P>
+
+<P>
+Here are the steps that are required in order to build the JOGL OpenGL
+binding from a fresh copy of the source distribution, which can be
+obtained either from <a
+href="https://jogl.dev.java.net/source/browse/jogl/">CVS</a> or a <a
+href="https://jogl.dev.java.net/servlets/ProjectDocumentList">release
+build</a>.
+
+</P>
<OL>
<LI> <B>Install the JDK:</B> <br> the JOGL build requires JDK 1.4.2 or later. On AMD64 platforms such as Linux/AMD64, Solaris/AMD64 and Windows/AMD64, the build requires the Sun JDK 5.0 or later, as the 1.4.2 releases did not have an AMD64-specific JVM. On these platforms, it is also currently necessary to have e.g. <code>bin/amd64/java</code> in your PATH, although from a technical standpoint this could be worked around in the build process.
<LI> <B>Install Ant:</B> <br> Download and unpack the latest version of Ant from <a href="http://ant.apache.org/">http://ant.apache.org</a> and add the <code>bin/</code> subdirectory to your PATH environment variable.
diff --git a/doc/userguide/index.html b/doc/userguide/index.html
index b3d1e408d..62011901a 100644
--- a/doc/userguide/index.html
+++ b/doc/userguide/index.html
@@ -14,6 +14,7 @@
<LI> Overview
<LI> Developing with JOGL
<UL>
+ <LI> Building the source tree
<LI> Local installation for development
<LI> Java Web Start integration
<LI> Applet support
@@ -86,6 +87,18 @@ the JSR has not yet been produced.
<H2> Developing with JOGL </H2>
+<H3> Building the source tree </H3>
+
+<P>
+
+Most developers using JOGL will download the most current <a
+href="https://jogl.dev.java.net/servlets/ProjectDocumentList">release
+build</a>. Separate instructions are available on how to <a
+href="https://jogl.dev.java.net/unbranded-source/browse/*checkout*/jogl/doc/HowToBuild.html?rev=HEAD&amp;content-type=text/html">build
+the source tree</a>.
+
+</P>
+
<H3> Local installation for development </H3>
<P>