Added featured projects section to JOGL home page. Reorganized and

updated documentation to move certain non-essential portions of home
page into developer documentation.


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

1 files changed, 56 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.