From 0f370707ed27dff495c5d091d284f7a006cb28a0 Mon Sep 17 00:00:00 2001 From: Sven Gothel Date: Sun, 18 Aug 2019 04:38:49 +0200 Subject: Bug 1363: Java 11: Java version must be 11 or greater; Fix HowToBuild: Give detailed build commandline. --- doc/HowToBuild.html | 33 ++++++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 7 deletions(-) (limited to 'doc') diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html index 52cc66f..daf980f 100644 --- a/doc/HowToBuild.html +++ b/doc/HowToBuild.html @@ -5,7 +5,7 @@ - How to build JOGL + How to build GlueGen
@@ -202,7 +202,7 @@ apt-get install lib32z1 lib32ncurses5 gcc-multilib lib32gcc1 lib32gomp1 lib32itm

Build Steps

- Here are the steps that are required in order to build JOGL. + Here are the steps that are required in order to build GlueGen.

    @@ -226,7 +226,7 @@ apt-get install lib32z1 lib32ncurses5 gcc-multilib lib32gcc1 lib32gomp1 lib32itm
  1. Unset your CLASSPATH environment variable:
    - The Ant build requires that the JOGL jars not be visible on the classpath. On Unix, type + The Ant build requires that the GlueGen jars not be visible on the classpath. On Unix, type unsetenv CLASSPATH into a csh or tcsh shell, or unset CLASSPATH into a Bourne shell. On Windows, type set CLASSPATH= into a command prompt.
    2. @@ -236,13 +236,32 @@ apt-get install lib32z1 lib32ncurses5 gcc-multilib lib32gcc1 lib32gomp1 lib32itm copy gluegen/make/gluegen.properties into your home directory (pointed to by the Java system property user.home).
  2. Build the source tree:
    - Open a command shell in the "gluegen/make" directory of the source tree and type "ant". + Open a command shell in the "gluegen/make" directory of the source tree and invoke ant + with the given properties as follows + 
    +    cd /home/dude/projects/jogamp/gluegen/make/
+    ant -Dtarget.sourcelevel=1.8 -Dtarget.targetlevel=1.8 -Dtarget.rt.jar=/your/openjdk8/lib/rt.jar
+
    + Alternatively you can also use environment variables instead of properties + 
    +    export SOURCE_LEVEL=1.8
+    export TARGET_LEVEL=1.8
+    export TARGET_RT_JAR=/your/openjdk8/lib/rt.jar
+    ant
+
    + Optionally you can also set certain build features via properites or environment variables + 
    +    Feature                Property                          or Environment Variable
+    developer-zip-archive: build.archiveon=true                 BUILD_ARCHIVE=true
+    Native Debug Code:     c.compiler.debug=true
+    Java Debug Code:       javacdebuglevel="source,lines,vars"
+
    3. -
  3. Test your build:
    Stay in your command shell in the "gluegen/make" directory of the source tree and type "ant junit.run".
    4. +
  4. Test your build:
    Stay in your command shell in the "gluegen/make" directory of the source tree and invoke ant with above properties or environment variables and use the target junit.run.
    5. -
  5. Build Javadoc:
    Stay in your command shell in the "gluegen/make" directory of the source tree and type "ant javadoc". - This will produce the end-user documentation for JOGL along with some auxiliary utility packages. +
  6. Build Javadoc:
    Stay in your command shell in the "gluegen/make" directory of the source tree and invoke ant with above properties or environment variables and use the target javadoc. + This will produce the end-user documentation for GlueGen along with some auxiliary utility packages.
-- cgit v1.2.3