About this was updated

monkstone · monkstone · commit 52b53bf4cefe · 2020-04-09T09:04:29.000+01:00
diff --git a/_java/JRubyArt_propane.md b/_java/JRubyArt_propane.md
@@ -9,9 +9,14 @@ Prior to jdk9 there were no specific recommendations, linux user probably used v
 
 ## Stock OpenJDK on linux
 
-Currently, doesn't work with OpenGL (missing linker?).
+May not work with OpenGL (missing linker?). Diagnostic error message:-
 
-## AdoptOpenJDK
+```bash
+ld.so: dl-lookup.c: 111: check_match: Assertion `version->filename == NULL || ! _dl_name_match_p (version->filename, map)'
+
+```
+
+## AdoptOpenJDK (Recommended version 12+)
 
 The development version of vanilla processing is using this version and I think it is a good choice, however to confuse matters it comes in several flavours. Vanilla processing is using the variant with a `hotspot` jvm, which is a good starting point. The ruby-processing group will be pleased to hear about anyone experimenting with the `OpenJ9` jvm.
 
@@ -27,12 +32,8 @@ The development version of vanilla processing is using this version and I think
 
 [Windows 64](https://adoptopenjdk.net/installation.html#x64_win-jdk)
 
-### Azul OpenJDK
-
-This is just another possibility but untested with ruby-processing projects.
-
-[Link](https://www.azul.com/get-openjdk-support/)
-
+### OpenJ9 jdk12+
 
+Is an excellent alternative (jdk14 version has been tested on linux)
 
-The illegal reflective access warnings warnings re-jogl can be suppressed, but will disappear with jogl-2.4.0.
+Use the latest versions of PiCrate, propane and JRubyArt to avoid reflective access warnings (you may need to define JAVA_HOME to get rid off the JRuby warnings).
diff --git a/_java/raspberry.md b/_java/raspberry.md
@@ -15,56 +15,7 @@ sudo apt-get install openjdk-8-jdk
 
 ## Raspbian Buster Release
 
-As of writing java does not come pre-installed with Buster, we strongly recommend that you install stock OpenJDK8 distribution.
+The latest version of PiCrate works well with stock java install (jdk11) on Raspbian Buster.
 
-```bash
-sudo apt-get install openjdk-8-jdk
-```
-
-You should avoid installing the default openjdk-11-jdk, since it probably wont perform as well, and lead to complications (lots of warning messages etc). If you still want to use openjdk11, it is recommended that you install the [jruby-launcher][jruby] gem.
-
-## Oracle jdk8 for Arm
-
-Is still available for personal use, but it is a bit of hassle to install:-
-
-1. [download]
-2. Untar to say `/opt` folder
-
-  ```bash
-  cd /opt
-  sudo tar xzvf ~/Downloads/*.tar.gz
-  ```
-
-3. Install and configure using `update-alternatives`
-
-  ```bash
-  sudo update-alternatives --install /usr/bin/java java /opt/jdk1.8.0_231/jre/bin/jar 100
-  sudo update-alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_231/bin/javac 100
-  sudo update-alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_231/bin/jar 100
-  ```
-
-  configure
-
-  ```bash
-  sudo update-alternatives --config java
-  sudo update-alternatives --config javac
-  sudo update-alternatives --config jar
-  ```
-
-  edit `~/.profile`
-
-  ```bash
-  export JAVA_HOME=/opt/jdk1.8.0_231
-  ```
-
-  install jruby-launcher gem
-
-  ```bash
-  sudo jgem install jruby-launcher
-  ```
-
-  `Building native extensions. This could take a while... Successfully installed jruby-launcher-1.1.10-java 1 gem installed`
-
-[jruby]:{{ site.github.url }}/jruby/raspberry
 
-[download]: https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
+You will need to define JAVA_HOME for jdk11+ to avoid reflective access warnings with JRuby.
diff --git a/_jruby/JRubyArt.md b/_jruby/JRubyArt.md
@@ -6,7 +6,7 @@ permalink: /jruby/JRubyArt/
 
 # Recommended JRuby Install For JRubyArt
 
-The preferred JRubyArt setup requires that you do a system install of JRuby. You should install java before attempting to install JRuby.
+The preferred JRubyArt setup requires that you do a system install of JRuby. You should install java before attempting to install JRuby. Install at least version 9.2.11.1.
 
 # Alternative Setup For JRubyArt
 
diff --git a/_jruby/propane.md b/_jruby/propane.md
@@ -4,36 +4,4 @@ title: Installing JRuby for propane
 permalink: /jruby/propane/
 ---
 
-An installed version of JRuby is an absolute pre-requisite for installing propane, but you should [install java][java] first.
-
-### Installing jruby-launcher
-
-It is recommended that you install the jruby-launcher (for optimised performance and suppression of illegal reflective access by jruby warning).
-
-You should set the `JAVA_HOME` environmental variable before installing gem, and use JRuby version you want to use with propane (preferably latest available).
-
-## Debian linux
-
-First set the `JAVA_HOME` environmental variable, you can do this by editing the `~/.profile` file:-
-
-```bash
-echo "export JAVA_HOME=/opt/jdk13 >> ~/.profile" # wherever
-```
-then
-```bash
-source ~/.profile # to use the edited ~/.profile in current shell
-```
-
-## Other linux
-
-First set the `JAVA_HOME` environmental variable, you can do this by editing the `~/.bashrc` file:-
-
-```bash
-echo "export JAVA_HOME=/opt/jdk13 >> ~/.bashrc" # wherever
-```
-then
-```bash
-source ~/.bashrc # to use the edited ~/.bashrc in current shell
-```
-
-[java]:{{ site.github.url }}/java/JRubyArt_propane
+An installed version of JRuby is an absolute pre-requisite for installing propane, but you should [install java][java] first. Requirements as JRubyArt, without JRuby-Complete option.
diff --git a/_jruby/raspberry.md b/_jruby/raspberry.md
@@ -8,18 +8,18 @@ permalink: /jruby/raspberry
 
 ## Download
 
-Download the latest JRuby release [here][download]. You could use `wget` (substituting latest version for for `9.2.11.0`):-
+Download the latest JRuby release [here][download]. You could use `wget` (substituting latest version for for `9.2.11.1`):-
 
-`wget https://repo1.maven.org/maven2/org/jruby/jruby-dist/9.2.11.0/jruby-dist-9.2.11.0-bin.tar.gz`
+`wget https://repo1.maven.org/maven2/org/jruby/jruby-dist/9.2.11.1/jruby-dist-9.2.11.1-bin.tar.gz`
 
 ## Install
 
 ```bash
 cd /opt
-sudo tar xzvf ~/jruby-dist-9.2.11.0-bin.tar.gz # or ~/Downloads/...
-sudo update-alternatives --install /usr/bin/jruby jruby /opt/jruby-9.2.11.0/bin/jruby 100
-sudo update-alternatives --install /usr/bin/jgem jgem /opt/jruby-9.2.11.0/bin/jgem 100
-sudo update-alternatives --install /usr/bin/jirb jirb /opt/jruby-9.2.11.0/bin/jirb 100
+sudo tar xzvf ~/jruby-dist-9.2.11.1-bin.tar.gz # or ~/Downloads/...
+sudo update-alternatives --install /usr/bin/jruby jruby /opt/jruby-9.2.11.1/bin/jruby 100
+sudo update-alternatives --install /usr/bin/jgem jgem /opt/jruby-9.2.11.1/bin/jgem 100
+sudo update-alternatives --install /usr/bin/jirb jirb /opt/jruby-9.2.11.1/bin/jirb 100
 ```
 
 ## Update
@@ -57,16 +57,4 @@ echo "export PATH=\"\${PATH}:\${GEM_PATH}/bin\"" >> ~/.profile
 
 You need to do this to use gem executables.
 
-## Installing/Updating jruby-launcher gem
-
-First set the `JAVA_HOME` environmental variable, you can do this by editing the `~/.profile` file:-
-
-```bash
-echo "export JAVA_HOME=/usr/lib/jvm/java-8-openjdk >> ~/.profile"
-source ~/.profile # to use the edited ~/.profile in current shell
-sudo jgem install jruby-launcher # NB: you do need sudo access here
-```
-
-Above assumes you are using `java-8-openjdk` on Buster, adjust for your setup. We do not currently recommend using `java-11-openjdk`, but if you are there is even more reason to install the `jruby-launcher` gem as it suppresses illegal-reflective access warning from `JRuby` (but not from the jogl jars)
-
 [download]: https://www.jruby.org/download
diff --git a/_projects/jruby_art.md b/_projects/jruby_art.md
@@ -8,7 +8,7 @@ keywords: 'propane, JRubyArt'
 
 ### Java
 
-Unlike vanilla processing, we do not distribute a java environment with our projects. It is quite possible that Oracle jdk8 will work best with JRubyArt 1.7.0 and below, and Oracle jdk12 will work best with JRubyArt-2.2.0+ but they have not been tested. It seem that not all OpenJDK distributions are equal, if you are lucky the one installed on your system will work for you (jdk8 for JRubyArt-1.7.0 and jdk11+ for JRubyArt-2.2.0+). If you have linker problems with opengl sketches we strongly recommend you use [AdoptOpenJDK][adopt] binaries.
+We strongly recommend you use [AdoptOpenJDK][adopt] binaries.
 
 ### JRuby
 
@@ -88,7 +88,7 @@ end
 
 ### class_sketch.rb
 
-An explicitly class wrapped sketch can actually be run directly with `jruby`, but you should prefer [propane][propane] for that. Another reason to favour [propane][propane] is if the `glsl` sketch worked before processing-3.3.7 and hasn't worked since (PGraphicsOpenGL.java and PShapeOpenGL.java were reverted to earlier versions of in propane).
+An explicitly class wrapped sketch can actually be run directly with `jruby`, but you should prefer [propane][propane] for that.
 
 ```ruby
 # frozen_string_literal: false
diff --git a/_projects/projects.md b/_projects/projects.md
@@ -6,15 +6,15 @@ keywords: 'projects, propane, JRubyArt, toxicgem, atom-k9, language-jruby-art, p
 
 # JRubyArt
 
-The natural successor to ruby-processing, equivalent processing-4.0 and jruby-9.2.11.0, since version 2.0 does not require vanilla processing install. Executable `k9`. Can work without jruby install (using jruby-complete.jar). Features a --watch (-w) mode, where sketch will reload on saved changes. Supports `bare` sketches (like vanilla processing)
+The natural successor to ruby-processing, equivalent processing-4.0 and jruby-9.2.11.1, since version 2.0 does not require vanilla processing install. Executable `k9`. Can work without jruby install (using jruby-complete.jar). Features a --watch (-w) mode, where sketch will reload on saved changes. Supports `bare` sketches (like vanilla processing)
 
 # propane
 
-An alternative ruby-processing implementation, for processing-3.3.7+ and jruby-9.2.7.0, does not require vanilla processing install, does require jruby install. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
+An alternative ruby-processing implementation, for processing-4.0+ and jruby-9.2.11.1+, does not require vanilla processing install, does require jruby install. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
 
 # PiCrate
 
-An experimental ruby-processing implementation, for processing-3.3.7 and jruby-9.2.7.0, targeting linux and the raspberrypi. Executable `jruby`. Should be be easier to convert into an exportable app, no reliance on vanilla processing install. Only supports class wrapped sketches.
+Similar to propane but tuned for Buster distro on RaspberryPI.
 
 # pbox2d
 
diff --git a/_projects/propane.md b/_projects/propane.md
@@ -8,7 +8,7 @@ keywords: propane, propane
 
 ### Java ###
 
-Unlike vanilla processing, we do not distribute a java environment with our projects. It is quite possible that Oracle jdk8 will work best with propane 2.9.1 and below, and Oracle jdk12 will work best with propane-3.4.0+ but they have not been tested. It seem that not all OpenJDK distributions are equal, if you are lucky the one installed on your system will work for you (jdk8 for propane-2.9.1 and jdk11+ for propane-3.4.0). If you have linker problems with opengl sketches we recommend you use [AdoptOpenJDK][adopt] binaries.
+We recommend you use [AdoptOpenJDK][adopt] binaries.
 
 ### JRuby ###
 
diff --git a/about.md b/about.md
@@ -8,19 +8,21 @@ permalink: /about/
 
 The ruby-processing group exists to collect together projects that support creating and running processing sketches in ruby. It is also designed to hide the inevitably high [bus factor][bus] of what is an essentially **one man band**, but I am trying hard to make it otherwise (including evolving the code). You could play your part...
 
-There are three main projects [JRubyArt][jruby_art], [PiCrate] and [propane], [JRubyArt][jruby_art] is the closest to the original ruby-processing and provides a ruby implementation that approximates to the latest [vanilla processing][processing] (but can be configured to not require a jruby install).
+There are three main projects [JRubyArt][jruby_art], [PiCrate][picrate] and [propane][propane]:-
 
-[Propane] is a configuration free, complete version of ruby-processing (_does not require installed vanilla processing_) that depends on an installed jruby (_is slightly more experimental however since a modified PApplet is required with jdk9+ propane may take over in future_). Since propane-3.2.0, propane is compiled with jdk11, and thus jdk11 is a requirement.
+ [JRubyArt][jruby_art] is the closest to the original [ruby-processing][ruby-processing] and provides a ruby implementation that approximates to the latest [vanilla processing][processing] (but can be configured to not require a jruby install). However unlike [ruby-processing][ruby-processing] it does not require a vanilla processing install.
 
-[PiCrate] is a standalone version targetting the [RaspberryPI][rpi], but it can be developed and run 64 bit linux.
+[Propane][propane] is a configuration free, complete version of ruby-processing (_does not require installed vanilla processing_) that depends on an installed jruby (_is slightly more experimental however since a modified PApplet is required with jdk9+ propane may take over in future_). Since propane-3.2.0, propane is compiled with jdk11, and thus jdk11 is a requirement.
+
+[PiCrate][picrate] is a standalone version targetting the [RaspberryPI][rpi], but it can be developed and run 64 bit linux.
 
 Other projects include the pbox2d gem (a gem wrapper around [jbox2d]), toxiclibs gem (a gem wrapper around [toxiclibs]) and geomerative gem (a gem wrapper around [geomerative]).
 
 Not forgetting the atom editor projects [atom-k9] and [language-jruby-art][language]
 
-## Martin Prout
+## About Me
 
-First degree was BSc hons Biochemistry from University of Surrey, I went on to specialize in xenobiotic metabolism (at first drugs, then industrial chemicals and pesticides). I later studied for a computer science degree with the Open University (BSc hons 2:1 but completed insufficient specific modules to be a named degree), course included some smalltalk but mainly java. Subsequently I dabbled a bit with C++, perl python, and even lisp, but got hooked on ruby, particulary ruby-processing. OS experience Windows-98 up to Windows-XP and mainly linux since 2004 (tried gentoo, fedora, even pardus) now using exclusively Archlinux and Mint (Debian). Since November 2012 I have been sole developer/maintainer of [ruby-processing] (_did update for processing-2.0_), and I have since developed JRubyArt and propane (_for processing-3.0+_) and ensured that jruby-9.2.0.0+ (with support from jruby group) continues to work with ruby-processing, and its descendants. More recently got RaspberryPI 3B+ and RaspberryPI 4 to let me check my PiCrate gem (processing in ruby on the PI).
+My first degree was BSc hons Biochemistry from University of Surrey, I went on to specialize in xenobiotic metabolism (at first drugs, then industrial chemicals and pesticides). I later studied for a computer science degree with the Open University (BSc hons 2:1 but completed insufficient specific modules to be a named degree), course included some smalltalk but mainly java. Subsequently I dabbled a bit with C++, perl python, and even lisp, but got hooked on ruby, particulary ruby-processing. OS experience Windows-98 up to Windows-XP and mainly linux since 2004 (tried gentoo, fedora, even pardus) now using exclusively Archlinux and Mint (Debian). Since November 2012 I have been sole developer/maintainer of [ruby-processing] (_did update for processing-2.0_), and I have since developed JRubyArt and propane (_for processing-3.0+_) and ensured that jruby-9.2.0.0+ (with support from jruby group) continues to work with ruby-processing, and its descendants. More recently got RaspberryPI 3B+ and RaspberryPI 4 to let me check my PiCrate gem (processing in ruby on the PI).
 
 Personally I can't understand why processing group spawned p5*js (javascript is just horrible), but I learned sufficient to develop atom packages [atom-k9] and [language-jruby-art][language] for JRubyArt / propane.
 
