From ad52b3d900d7185dd8a7056f70a942affd374d11 Mon Sep 17 00:00:00 2001 From: Kenneth Russel Date: Mon, 14 Jul 2003 10:01:41 +0000 Subject: Updated jogl build documentation for Ant build. Deleted now-obsolete Makefiles and redundant gl.c and similar files from platform-specific stub_includes directories; the latter have been moved to stub_includes/common. git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@22 232f8b59-042b-4e1e-8c03-345bb8c30851 --- doc/HowToBuild.html | 27 +++++++++++---------------- 1 file changed, 11 insertions(+), 16 deletions(-) (limited to 'doc') diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html index 33a2feafb..69a3df2ad 100644 --- a/doc/HowToBuild.html +++ b/doc/HowToBuild.html @@ -12,27 +12,24 @@ Here are the steps that are required in order to build the Jogl OpenGL binding from a fresh copy of the source distribution:
    +
  1. Install Ant:
    Download and unpack Ant 1.5.3 from http://ant.apache.org and add the bin/ subdirectory to your PATH environment variable.
  2. Install ANTLR:
    Download and unpack ANTLR 2.7.2 from http://www.antlr.org. -
  3. Set your CLASSPATH environment variable:
    Add the ANTLR jar file to your classpath. +
  4. Unset your CLASSPATH environment variable:
    The Ant build requires that the Jogl jars not be visible on the classpath. On Unix, type unsetenv CLASSPATH into a csh or tcsh shell, or set CLASSPATH=; export CLASSPATH into a Bourne shell. On Windows, type set CLASSPATH= into a command prompt. -
  5. Set the JAVA_HOME environment variable:
    Create an environment variable named JAVA_HOME and set it to point to the root of your Java SDK. +
  6. Edit host.properties:
    Change any settings in the make/host.properties file that are necessary, in particular the location of the ANTLR jar file (typically $HOME/antlr-2.7.2/antlr.jar). -
  7. Install GNU Make: To confirm that it is installed, run "make -v"; you should see some output that starts with "GNU Make version" and then a version number. +
  8. Build the source tree:
    Open a command shell in the "make" directory of the source tree and type "ant [target]", where [target] is one of linux, macosx, solaris, win32.vc6, win32.vc7, or win32.mingw. -
  9. Build the source tree:
    You can do this by opening a command shell in the "make" directory of the source tree and typing "make PLATFORM COMPILER_OPTIONS". PLATFORM, COMPILER_OPTIONS are as follows: -
      -
    • PLATFORM This must be one of "win32", "x11", or "macosx". "win32" will build the code for 32-bit Microsoft Windows operating systems, "x11" will build for Linux or Sun Solaris, and "macosx" will build for Apple MacOS X. -
    • COMPILER_OPTIONS This is currently only needed when "win32" is specified. COMPILER_OPTIONS must be one of "VC6=1" or "VC7=1"; choosing the former will invoke the Microsoft Visual C++ 6.0 compiler, and the latter option will invoke the Microsoft Visual C++ 7 (Visual Studio .NET) compiler. These are the two compilers currently supported by Jogl on Win32. +
    • The win32 targets require one of Microsoft Visual C++ 6, 7 (Visual Studio .NET) or the free MinGW (http://www.mingw.org/) compilers to be installed. Choose the appropriate target for the compiler desired. +
    • An experimental binding to the high-level Cg language by NVidia corporation can be generated by specifying -Djogl.cg=1 to ant; e.g. ant -Djogl.cg=1 win32.vc6. Currently the Cg binding has only been tested on Windows, though in theory it should build and run on Linux and Mac OS X with appropriate modification of the host.properties file.
    -
  10. Add Jogl to your CLASSPATH:
    To be able to use Jogl, you must add the build process Java bytecode output directory (/build/classes) to your CLASSPATH environment variable. -
  11. Add Jogl to your PATH:
    To be able to use Jogl, you must also add the build process JNI code library directory (/build/obj) to your PATH. -
  12. Test if everything's working:
    To test if everything went well, you should build the "Gears.java" demo in the "/demos/gears" directory. Run "javac Gears.java" and then "java Gears"; you should see some spinning 3D gears appear in a window. -
  13. Build Javadoc:
    "make doc" will produce the end-user documentation for Jogl along with some auxiliary utility packages. "make devdoc" will produce the developers' documentation, including that for the GlueGen tool. +
  14. Add Jogl to your CLASSPATH:
    To be able to use Jogl once built, you must add the build process' resulting jogl.jar (/build/jogl.jar) to your CLASSPATH environment variable. +
  15. Add Jogl to your PATH:
    To be able to use Jogl once built, you must also add the build process JNI code library directory (/build/obj) to your PATH. + +
  16. Test if everything's working:
    To test if everything went well, you should check out the source code for the jogl-demos project (available at http://jogl-demos.dev.java.net/), build the demos using the supplied instructions, and run the Gears demo ("java demos.gears.Gears"). +
  17. Build Javadoc:
    "ant javadoc" will produce the end-user documentation for Jogl along with some auxiliary utility packages. The developers' documentation, including that for the GlueGen tool, can be generated for your current platform using one of the following commands: "ant javadoc.dev.win32", "ant javadoc.dev.x11", or "ant javadoc.dev.macosx". (The javadoc for the Cg binding can be built by inserting -Djogl.cg=1 into the command line as above.)
Note that there are a lot of warnings produced by ANTLR about the @@ -44,7 +41,5 @@ harmless.

- Christopher Kline and Kenneth Russell, June 2003 - - -- cgit v1.2.3