From 2dd5b6040858cbec29710be8e68374f46121a39a Mon Sep 17 00:00:00 2001 From: Sven Gothel Date: Mon, 19 Aug 2019 10:06:11 +0200 Subject: Bug 1363: Java 11: Aligned HowToBuild.html w/ GlueGen's updated version --- doc/HowToBuild.html | 183 +++++++++++++++++++++++++++++++--------------------- 1 file changed, 108 insertions(+), 75 deletions(-) (limited to 'doc') diff --git a/doc/HowToBuild.html b/doc/HowToBuild.html index fb93e7ee1..c03c1d74f 100644 --- a/doc/HowToBuild.html +++ b/doc/HowToBuild.html @@ -37,39 +37,25 @@ -
  • GNU Linux x86, 32- and 64-bit
    +
  • FreeBSD x86, 32- and 64-bit, ... + +
    • +
  • GNU Linux x86, 32- and 64-bit as well as Arm64, etc
    You may have to install a few developer packages ...
  • Windows/x86_64 (64-bit) +
    • +
  • CMake 3.15.2 64bit version
    • @@ -291,8 +304,28 @@ ln -s libudev.so.1 libudev.so
  • Build the source tree:
    - Open a command shell in the "gluegen/make" directory of the source tree and type "ant".
    - Then open a command shell in the "jogl/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"
+    Cg                     jogl.cg=1
+
    +
    • -
  • Test your build:
    Stay in your command shell in the "jogl/make" directory of the source tree and type "ant junit.run".
    • +
  • Test your build:
    Stay in your command shell in the "jogl/make" directory of the source tree and invoke ant with above properties or environment variables and use the target junit.run.
    • -
  • Build Javadoc:
    Stay in your command shell in the "jogl/make" directory of the source tree and type "ant javadoc.all". +
  • Build Javadoc:
    Stay in your command shell in the "jogl/make" directory of the source tree and invoke ant with above properties or environment variables and use the target javadoc.all. This will produce the end-user documentation for JOGL along with some auxiliary utility packages.
    • - Note that there are a lot of warnings produced by ANTLR about the + Note that there might be a few warnings produced by ANTLR about the C grammar and our modifications to some of the signatures of the productions; the C grammar warnings have been documented by the author of the grammar as having been investigated completely and @@ -329,7 +362,7 @@ ln -s libudev.so.1 libudev.so
  • - CharScanner; panic: ClassNotFoundException: com.sun.gluegen.cgram.CToken + CharScanner; panic: ClassNotFoundException: com.jogamp.gluegen.cgram.CToken This occurs because ANTLR was dropped into the Extensions directory of the JRE/JDK. On Windows and Linux, delete any ANTLR jars from jre/lib/ext, -- cgit v1.2.3