diff options
author | Kevin Rushforth <[email protected]> | 2004-06-10 02:02:27 +0000 |
---|---|---|
committer | Kevin Rushforth <[email protected]> | 2004-06-10 02:02:27 +0000 |
commit | f8baa17730b88f85087fe1121a4af5e3f4d92ec2 (patch) | |
tree | cbda5a1bbcaf1044241f56fa210564edaecbefc9 | |
parent | a60025b9d3a01edd83a36a6d88b27ae4b8749fba (diff) |
Updated build instructions
git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@10 ba19aa83-45c5-6ac9-afd3-db810772062c
-rw-r--r-- | README-build.html | 263 | ||||
-rw-r--r-- | www/build-instr.html | 42 | ||||
-rw-r--r-- | www/index.html | 11 |
3 files changed, 187 insertions, 129 deletions
diff --git a/README-build.html b/README-build.html index 09eedad..b04c086 100644 --- a/README-build.html +++ b/README-build.html @@ -1,5 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> - +<html> +<head> <!-- /* * $RCSfile$ @@ -13,135 +14,151 @@ * $State$ */ --> - -<html> -<head> - - <meta content="text/html; charset=ISO-8859-1" - http-equiv="content-type"> - <title>README-build</title> + <meta http-equiv="content-type" + content="text/html; charset=ISO-8859-1"> + <title>README-build: build instructions for the j3d-core project</title> </head> - <body> - <span style="font-weight: bold; text-decoration: underline;">Building the -Java 3D Packages<br> - <br> - </span>To build the Java 3D packages, you must have the following three CVS<br> - repositories:<br> - <br> - j3d-core<br> - j3d-core-utils<br> - vecmath<br> - <br> - NOTE: these three top-level directories must be named exactly as shown<br> - above and they must be sibling directories.<br> - <br> - NOTE: you must first build the javax.vecmath pacakge before building<br> - the Java 3D core and utilities packages. See the <a - href="../vecmath/README-build.html">README-build.html</a><br> - file in the "vecmath" directory for instructions.<br> - <span style="font-weight: bold; text-decoration: underline;"><br> - <br> - System Requirements<br> - <br> - </span>The following operating environments have been tested:<br> - +<body> +<h3><span style="font-weight: bold; text-decoration: underline;">Building +the Java 3D Packages</span></h3> +<p><span style="text-decoration: underline;"><span + style="font-weight: bold;"></span></span><span + style="font-weight: bold; text-decoration: underline;"> </span>To +build the Java 3D packages, you must have the following three CVS +repositories:<br> +</p> +<ul> + <li>j3d-core<br> + </li> + <li>j3d-core-utils<br> + </li> + <li>vecmath<br> + </li> +</ul> +<p>These three top-level directories must be named exactly as +shown above and they must be sibling directories.<br> +</p> +<p>NOTE: you must first build the javax.vecmath package before building +the Java 3D core and utilities packages. See the <a + href="../vecmath/README-build.html">README-build.html</a> file in the +"vecmath" directory for instructions.<br> +</p> +<h3><span style="font-weight: bold; text-decoration: underline;"></span><span + style="text-decoration: underline;">System Requirements</span></h3> +<p><span style="font-weight: bold; text-decoration: underline;"></span></p> +<p><span style="font-weight: bold; text-decoration: underline;"></span>The +following operating environments have been tested:<br> +</p> +<ul> + <li>Solaris: Sparc (Ultra60 or better) running Solaris 9 with Forte C +compiler version 6.2 or GNU gcc version 3.3.2</li> + <li>Linux: i386/i586 running SuSE 9 or RedHat 9.0</li> + <li>Windows: Windows/XP with Microsoft Visual C++ 6.0 or the gcc that +comes with <a href="http://www.mingw.org">MinGW version 3.1.0-1</a> +(Windows 2000 should work, but is untested)<br> + </li> +</ul> +<p> The following software must be installed:<br> +</p> +<ul> + <li><a href="http://java.sun.com/j2se">JDK 1.4.2 </a><br> + </li> + <li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1</a><br> + </li> + <li>C Compiler (Either one of the following depending on the platform)<br> + </li> + <ul> + <li>Solaris:<br> + </li> + <ul> + <li>Sun ONE Studio 8 (formerly Forte Tools)'s Compiler or GNU +Compiler Collection, <a href="http://gcc.gnu.org">GCC version 3.3.2</a><br> + </li> + </ul> + <li>Linux:<br> + </li> + <ul> + <li>GNU Compiler Collection, <a href="http://gcc.gnu.org">GCC +version 3.2.2</a><br> + </li> + </ul> + <li>Windows<br> + </li> + <ul> + <li>Microsoft Visual C++ 6.0 or later or GNU Compiler +Collection, GCC version 3.2.3 that comes with<a + href="http://www.mingw.org"> MinGW version 3.1.0-1</a><span + style="font-weight: bold; text-decoration: underline;"><br> + </span></li> + </ul> + </ul> +</ul> +<h3><span style="font-weight: bold; text-decoration: underline;">Building +Java 3D</span></h3> +<p><span style="font-weight: bold; text-decoration: underline;"></span><span + style="font-weight: bold; text-decoration: underline;"></span>Before +you start building, your PATH must include the +following directories: +</p> +<ul> + <li><ant-root-dir>/bin<br> + </li> + <li><jdk-root-dir>/bin<br> + </li> + <li><compiler-root-dir>/bin<br> + </li> +</ul> +<p>The default target, jar-opt, creates an optimized jar files +and native libraries. +</p> +<p>Steps: +</p> <ul> - <li>Solaris: Sparc (Ultra60 or better) running Solaris 9 with Forte C compiler -version 6.2 or GNU gcc version 3.3.2</li> - <li>Linux: i386/i586 running SuSE 9 or RedHat 9.0</li> - <li>Windows: Windows/XP with Microsoft Visual C++ 6.0 or the gcc that comes -with <a href="http://www.mingw.org">MinGW version 3.1.0-1</a> (Windows 2000 -should work, but is untested)<br> - </li> - + <code> cd <java3d-root-dir>/j3d-core<br> +ant</code> </ul> - The following software must be installed:<br> - +<p>The above steps build both the Java and native code for +javax.media.j3d and com.sun.j3d.* +packages. +</p> +<p>The build will be placed in j3d-core/build/<platform>/opt +where <platform> is determined from the <code>ant +echo</code> command: +</p> <ul> - <li><a href="http://java.sun.com/j2se">JDK 1.4.2 </a> <br> - </li> - <li><a href="http://jakarta.apache.org/ant">Apache Ant 1.6.1 </a> - <br> - </li> - <li>C Compiler (Either one of the following depending on the platform) </li> - + <code>ant echo</code> </ul> - -<div style="margin-left: 40px;">- Solaris <br> - Sun ONE Studio 8 (formerly Forte Tools)'s Compiler or GNU Compiler Collection, -<a href="http://gcc.gnu.org">GCC version 3.3.2</a> <br> - <br> - </div> - -<div style="margin-left: 40px;">- Linux<br> - GNU Compiler Collection, <a href="http://gcc.gnu.org">GCC version 3.2.2</a> -<br> - </div> - <br> - -<div style="margin-left: 40px;">- Windows<br> - </div> - -<div style="margin-left: 40px;">Microsoft Visual C++ 6.0 or later or GNU Compiler -Collection, GCC version 3.2.3 that comes with<br> - </div> - -<div style="margin-left: 40px;"><a href="http://www.mingw.org">MinGW version -3.1.0-1</a> <br> - </div> - <br> - <br> - <span style="font-weight: bold; text-decoration: underline;">Building Java -3D</span><br> - Before you start building, please check that your PATH must include the following -directories:<br> - . <ant-root-dir>/bin<br> - . <jdk-root_dir>/bin<br> - . <compiler-root-dir>/bin<br> - <br> - The default target, jar-opt, creates an optimized jar files and native -libraries.<br> - <br> - Steps:<br> - <br> - cd <java3d-root-dir>/j3d-core<br> - ant<br> - <br> - The above steps build both the Java and native code for javax.media.j3d and -com.sun.j3d.* packages. <br> - <br> - The build will be placed in j3d-core/build/<platform>/opt where <platform> -is determined from the ant echo command:<br> - "ant echo".<br> - <br> - To see other targets that are available, type "ant -projecthelp". Note -that ant must be run from the top-level directory.<br> - <br> - The default compiler for native code compilation is set to "gcc". This value -is set in the <a href="build.properties">build.properties</a> file located +To see other targets that are available, type "ant +-projecthelp". Note that ant must be run from the top-level +directory. +<p>The default compiler for native code compilation is set to "gcc". +This +value is set in the <a href="build.properties">build.properties</a> +file located in the j3d-core directory. The compiler property is "build.comp".<br> - <br> - On a Solaris platform with Forte compiler installed, build.comp can -be set to "forte". On a Windows platform installed Visual C++, build.properties +</p> +<p>On a Solaris platform with Forte compiler installed, +build.comp +can be set to "forte". On a Windows platform installed Visual C++, +build.properties can be set to "vc".<br> - <br> - SPECIAL: For Windows platform only, the property "build.rend" in build.properties -can be modified to use "d3d" (Direct3D API for rendering) besides the default -value "ogl".<br> - <br> - NOTE: You can also modify the properties through ant property command options +</p> +<p>NOTE: For Windows platform only, the property "build.rend" in +build.properties can be modified to use "d3d" (Direct3D API for +rendering) besides the default value "ogl".<br> +</p> +<p>NOTE: You can also modify the properties through ant property +command +options e.g. "ant -Dbuild.comp=forte"<br> - <br> - <br> - <span style="font-weight: bold; text-decoration: underline;">Running Java -3D</span><br> - <br> - To run Java 3D, please refer to j3d-examples/<a - href="../j3d-examples/README-build.html">README-build.html</a> for details -building Java 3D example programs. <br> - <br> - <br> - <br> - <br> +</p> +<h3><span style="font-weight: bold; text-decoration: underline;">Running +Java 3D</span></h3> +<p>To run Java 3D, please refer to <a + href="../j3d-examples/README-build.html">README-build.html</a> in +j3d-examples for +details +building Java 3D example programs.<br> +</p> </body> </html> diff --git a/www/build-instr.html b/www/build-instr.html new file mode 100644 index 0000000..cb0e0f9 --- /dev/null +++ b/www/build-instr.html @@ -0,0 +1,42 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> + <meta content="text/html; charset=ISO-8859-1" + http-equiv="content-type"> + <title>j3d-core download and building instructions</title> + <meta content="Kevin Rushforth" name="author"> +</head> +<body> +<h3>Instructions for downloading and building j3d-core +</h3> +<p>To +build the Java 3D packages, you must checkout the following three +CVS +repositories:<br> +</p> +<ul> + <li>j3d-core</li> + <li>j3d-core-utils</li> + <li>vecmath</li> +</ul> +<p>These three top-level directories must be named exactly as +shown above and they must be sibling directories. To ensure this, run +the cvs checkout command for each of the respositories from the same +parent +directory. For example:<br> +</p> +<ul> + <code>cd <cvs-root-dir></code><br> + <code>cvs checkout vecmath</code><br> + <code>cvs checkout j3d-core</code><br> + <code>cvs checkout j3d-core-utils</code> +</ul> +<p>After you have downloaded the three respositories, follow the +instructions in the README-build.html +files in the +"vecmath" and "j3d-core" directories. If you wish to browse the +README.html file on-line before you checkout the sources, you can +browse the <a href="../source/browse/j3d-core/">CVS sources</a> and +click on the latest revision of README-build.html.</p> +</body> +</html> diff --git a/www/index.html b/www/index.html index f6dc051..a532009 100644 --- a/www/index.html +++ b/www/index.html @@ -1,8 +1,8 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> - <meta content="text/html; charset=ISO-8859-1" - http-equiv="content-type"> + <meta http-equiv="content-type" + content="text/html; charset=ISO-8859-1"> <title>The Java 3D API Core</title> </head> <body> @@ -17,10 +17,9 @@ Java 3D core utilities), and <a href="http://j3d-examples.dev.java.net/">j3d-examples</a> (the Java 3D example programs). The vecmath and j3d-core-utils projects are required -to build j3d-core. Refer to the <a - href="../source/browse/j3d-core/README-build.html?rev=1.1&content-type=htm">build -instructions</a> for -more information.</p> +to build j3d-core. Refer to the <a href="build-instr.html">download +and build +instructions</a> for information on downloading and building j3d-core.</p> <h3>License</h3> <p>The source code for the core Java 3D API reference implementation is available for research use |