From c16d5225feac73340c9a6545bd0beb7355dc716d Mon Sep 17 00:00:00 2001
From: brutzman <brutzman@nps.edu>
Date: Tue, 12 Oct 2021 09:27:36 -0700
Subject: [PATCH] Netbeans 12.5 OK, but openjdk-16 still required due to
 reflection-access problems

---
 developers.html | 33 +++++++++++++++++----------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/developers.html b/developers.html
index bc7dedb8cc..84e7935c68 100644
--- a/developers.html
+++ b/developers.html
@@ -844,17 +844,18 @@ Note that the -d switch is necessary for domain users.
       </p>
       
       <!--
+      -->
         <hr />
         <p>
               <span style="color:darkorange"><b>Developers warning:</b></span>
-              OpenJDK <code style="color:darkgreen"><b>jdk-16.0.2</b></code>
+              OpenJDK <code style="color:darkgreen"><b>jdk-16.0.2</b></code> and <code style="color:darkgreen"><b>jdk-17</b></code>
               
               <blockquote>
                 <a href="https://jdk.java.net/16/release-notes" target="_blank">JDK 16.0.2 Release Notes</a> 
                 describes a significant new strictness in Java handling of reflection.
                 We have found that this can lead to mysterious showstopper exceptions caused by supporting libraries.
                 We are currently holding stable at OpenJDK <code style="color:darkgreen"><b>jdk-16</b></code>
-                until we can implement better application protections.
+                until we can implement better application protections.  Further JDK documentation details:
               </blockquote>
               <blockquote>
                     JEP 396: Strongly Encapsulate JDK Internals by Default (JDK-8256299)
@@ -865,7 +866,6 @@ Note that the -d switch is necessary for domain users.
               </blockquote>
         </p>
         <hr />
-      -->
 
       <p>
           To configure Java on your development system:
@@ -908,11 +908,11 @@ Note that the -d switch is necessary for domain users.
               or
               -->
               <br />
-              &nbsp;&nbsp;&nbsp;&nbsp; <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\openjdk\jdk-16.0.2</b></code> &nbsp;&nbsp;&nbsp; # OpenJDK, or
+              &nbsp;&nbsp;&nbsp;&nbsp; <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\openjdk\jdk-16</b></code> &nbsp;&nbsp;&nbsp; # OpenJDK, or
               <br />
               <!--&nbsp;&nbsp;&nbsp;&nbsp; <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk-14</b></code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # Oracle JDK
               <br />-->
-              &nbsp;&nbsp;&nbsp;&nbsp; <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk1.8.0_221</b></code> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # Oracle JDK
+              &nbsp;&nbsp;&nbsp;&nbsp; <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk1.8.0_221</b></code>   &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; # Oracle JDK
               <br />
               and (usually inserted at the beginning of an existing PATH, if it already exists)
               <br />
@@ -932,9 +932,9 @@ Note that the -d switch is necessary for domain users.
               <pre>
 $<b> java -version</b> &nbsp;&nbsp; # OpenJDK&nbsp;16
 
-openjdk version "16.0.2" 2021-07-20
-OpenJDK Runtime Environment (build 16.0.2+7-67)
-OpenJDK 64-Bit Server VM (build 16.0.2+7-67, mixed mode, sharing)
+openjdk version "16" 2021-03-16
+OpenJDK Runtime Environment (build 16+36-2231)
+OpenJDK 64-Bit Server VM (build 16+36-2231, mixed mode, sharing)
 </pre>
           			</li>
           			<li>
@@ -1533,13 +1533,13 @@ need to be connected to the NPS intranet.
           <li>
               Includes
               <a href="https://blogs.apache.org/netbeans" target="_blank">Blog</a>,
-              <a href="https://netbeans.apache.org/download/nb123/index.html" target="_NetBeans">NetBeans&nbsp;12.4&nbsp;features</a>,
+              <a href="https://netbeans.apache.org/download/nb123/index.html" target="_NetBeans">NetBeans&nbsp;12.5&nbsp;features</a>,
               <a href="https://netbeans.apache.org/kb/docs/java" target="_NetBeans">tutorials</a>,
               <a href="https://netbeans.apache.org/community" target="_NetBeans">Community</a>,
               <a href="https://netbeans.apache.org/participate" target="_NetBeans">Participate</a>,
               <a href="https://netbeans.apache.org/help" target="_NetBeans">Get Help</a>,
               <a href="https://netbeans.apache.org/plugins" target="_NetBeans">Plugins</a>,
-              <a href="https://bits.netbeans.org/12.4/javadoc" target="_NetBeans">Documentation</a> and
+              <a href="https://bits.netbeans.org/12.5/javadoc" target="_NetBeans">Documentation</a> and
               <a href="https://netbeans.apache.org/wiki/index.asciidoc" target="_NetBeans">Developers wiki</a>.
           </li>
           <li>
@@ -1600,7 +1600,7 @@ need to be connected to the NPS intranet.
               <code><b>NETBEANS_HOME/etc/netbeans.conf</b></code>
               locations in the NetBeans installation directory tree:
               <br />
-              <code style="color:darkgreen"><b>C:\Program&nbsp;Files\NetBeans12.4\netbeans\etc\netbeans.conf</b></code> (default user settings)
+              <code style="color:darkgreen"><b>C:\Program&nbsp;Files\NetBeans12.5\netbeans\etc\netbeans.conf</b></code> (default user settings)
               <br />
               or, for older versions of NetBeans,
               <br />
@@ -1626,7 +1626,7 @@ need to be connected to the NPS intranet.
               &nbsp;&nbsp;&nbsp;&nbsp;<code style="color:darkgreen"><b>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</b></code>
           </li>
           <li>
-              <i>Tomcat support under Netbeans 12.4 and OpenJDK&nbsp;16.</i> 
+              <i>Tomcat support under Netbeans 12.5 and OpenJDK&nbsp;16.</i> 
               Append the following property to
               <code>netbeans_default_options</code> environment variable:
               <br />
@@ -2460,10 +2460,11 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre>
       </p>
       <ul>
           <li>
+              TODO confirm/omit.
               There is a
-              <a href="https://issues.apache.org/jira/plugins/servlet/mobile#issue/NETBEANS-5602">Netbeans 12.4 problem with Tomcat</a>
+              <a href="https://issues.apache.org/jira/plugins/servlet/mobile#issue/NETBEANS-5602">Netbeans 12.3 problem with Tomcat</a>
               that should be fixed by
-              <a href="https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+12.4">Netbeans 12.4</a>,
+              <a href="https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+12.5">Netbeans 12.4</a>,
               appearing in late May according to the
               <a href="https://cwiki.apache.org/confluence/display/NETBEANS/Release+Schedule">Release Schedule</a>.
           </li>
@@ -2691,7 +2692,7 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre>
 
       <blockquote style="background-color: palegreen">
           <i>Updated!</i>
-          Xj3D is upgraded to latest Java 16 (OpenJDK&nbsp;16.0.2) and moved to
+          Xj3D is upgraded to latest stable Java 16 (OpenJDK&nbsp;16, not 16.0.2 or 17) and moved to
           <a href="https://gitlab.nps.edu/Savage/xj3d" target="_blank">https://gitlab.nps.edu/Savage/xj3d</a>.
           <br />
           <i>Status:</i> 
@@ -3084,7 +3085,7 @@ which can lead to the Internet of Things becoming the Web of Things. </i>
             <a href="https://savage.nps.edu/developers.html">https://savage.nps.edu/developers.html</a>
         </blockquote>
         <blockquote>
-            Revised 13 September 2021.
+            Revised 12 October 2021.
         </blockquote>
 
         <p>
-- 
GitLab