diff --git a/developers.html b/developers.html index a1bea76ad5199f89058151ee741e1ba7a22b7f2b..cab93beeac3b39bc048337158b72684ceaa0dbf4 100644 --- a/developers.html +++ b/developers.html @@ -388,7 +388,8 @@ Apache Ant(TM) version 1.10.11 compiled on July 10 2021 <li> <a name="inetutils"></a> <a href="http://ras52-tech.blogspot.com/2007/01/telnet-on-cygwin.html">Telnet and other networking clients</a> - are in the <i>Net/inetutils</i> package + are in the <i>Net/inetutils</i> package. + See the <a href="#telnet">telnet</a> section for further guidance. </li> <!-- <li> @@ -842,13 +843,14 @@ Note that the -d switch is necessary for domain users. Java is the primary programming language used in Savage projects. </p> + <!-- <hr /> <p> <span style="color:darkorange"><b>Developers warning:</b></span> - OpenJDK <code style="color:darkgreen"><b>jdk-16.0.1</b></code> + OpenJDK <code style="color:darkgreen"><b>jdk-16.0.2</b></code> <blockquote> - <a href="https://jdk.java.net/16/release-notes" target="_blank">JDK 16.0.1 Release Notes</a> + <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> @@ -863,6 +865,7 @@ Note that the -d switch is necessary for domain users. </blockquote> </p> <hr /> + --> <p> To configure Java on your development system: @@ -905,11 +908,11 @@ Note that the -d switch is necessary for domain users. or --> <br /> - <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\openjdk\jdk-16</b></code> # OpenJDK + <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\openjdk\jdk-16.0.2</b></code> # OpenJDK, or <br /> - <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk-14</b></code> # Oracle JDK - <br /> - <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk1.8.0_221</b></code> # Oracle JDK + <!-- <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk-14</b></code> # Oracle JDK + <br />--> + <code style="color:darkgreen"><b>JAVA_HOME=C:\Program Files\Java\jdk1.8.0_221</b></code> # Oracle JDK <br /> and (usually inserted at the beginning of an existing PATH, if it already exists) <br /> @@ -917,8 +920,10 @@ Note that the -d switch is necessary for domain users. </li> <li> <span style="color:darkorange"><b>Developers warning:</b></span> - ensure that external or automatic installation of Java JRE does not prepend a different Java PATH value, - effectively overriding the intended developmental JDK of interest. + ensure that external or automatic installation of Java JRE does not prepend a different Java path, + effectively overriding the intended developmental JDK of interest. If a different version of Java is active, + also check order of entries in the + <a href="images/Windows10EnvironmentVariablesPathJAVA_HOME.png">system <code>PATH</code> environment variable</a>. </li> <li> Test what version of Java is actually installed and configured for your operating system via console command line. Examples: @@ -927,10 +932,9 @@ Note that the -d switch is necessary for domain users. <pre> $<b> java -version</b> # OpenJDK 16 -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) - +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) </pre> </li> <li> @@ -944,15 +948,25 @@ Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode) </li> </ul> </li> + <li> + <a href="https://docs.oracle.com/en/java/javase/16" target="_blank">JDK 16 Javadoc Documentation</a> + is useful. + <!-- + <a href="https://docs.oracle.com/javase/8/docs/api" target="_blank">Java 8 Javadoc</a> + is also online.--> + </li> <li> <a href="https://www.oracle.com/java/technologies/javase-downloads.html" target="_blank">Javadoc Documentation Download</a> for local use is available on the Oracle Java SE Downloads page. Extract the <code style="color:darkgreen"><b>docs</b></code> directory tree provided by the .zip into the directory containing the corresponding version of Java. + (Note that OpenJDK Javadoc + <!-- <a href="https://www.oracle.com/java/technologies/javase-jdk14-doc-downloads.html" target="_blank">OpenJDK Java 15 Javadoc</a> --> + uses the same javadoc as Oracle Javadoc.) </li> <li> - Summaries of Java language feature improvements: + Java language feature summaries: <a href="https://openjdk.java.net/projects/jdk/16" target="_blank">JDK 16</a>, <a href="https://openjdk.java.net/projects/jdk/15" target="_blank">JDK 15</a>, <a href="https://openjdk.java.net/projects/jdk/14" target="_blank">JDK 14</a>, @@ -962,37 +976,6 @@ Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode) <a href="https://openjdk.java.net/projects/jdk/10" target="_blank">JDK 10</a> and <a href="https://openjdk.java.net/projects/jdk9" target="_blank">JDK 9</a>. </li> - <li> - <a href="https://docs.oracle.com/en/java/javase/16" target="_blank">JDK 16 Javadoc Documentation</a> - is useful. - <a href="https://docs.oracle.com/javase/8/docs/api" target="_blank">Java 8 Javadoc</a> - is also online. - </li> - <ul> - <li> - (Note that OpenJDK Javadoc - <!-- <a href="https://www.oracle.com/java/technologies/javase-jdk14-doc-downloads.html" target="_blank">OpenJDK Java 15 Javadoc</a> --> - uses the same javadoc as Oracle Javadoc.) - </li> - </ul> - <li> - For JDK 1.8 (but not later), - <a href="https://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 Download</a> - is needed to support various builds - (link also found at bottom of JavaSE downloads page). - <ul> - <li> Extract the contents (including README.txt) for inclusion in the JDK development build, for example - <br /> - <code style="color:darkgreen"><b>C:\Program Files\Java\jdk1.8.0_221\jre\lib\security</b></code></li> - <li> - <a href="https://download.oracle.com/javase/8/docs/technotes/guides/security">Java(TM) Cryptography Architecture (JCA) Reference Guide</a> - </li> - <li> - <a href="https://www.oracle.com/technetwork/java/javase/tech/index-jsp-136007.html">Java SE Security</a> - has more information about JCE and the Java SE Security Model. - </li> - </ul> - </li> <li> Be sure to similarly configure <a href="#Ant">Ant</a> and @@ -1001,19 +984,21 @@ Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode) </li> </ul> - <p>Additional Java resources:</p> + <p>Additional, older Java resources:</p> <ul> <li> <a href="https://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html">Javadoc Tool</a> page provides guidance on how to write correct, effective Java documentation. </li> + <!-- <li> - You can also visit the + To check a web browser, visit the <a href="https://www.java.com/en/download/installed.jsp" target="_blank">Verify Java Version</a> page, which detects which version of Java is installed in your Web browser. This may be a different version (for example, JRE version 1.7.*) without interfering with the command-line PATH version used for development. </li> + --> <li> If desired, developers can choose among multiple versions of Java platforms in NetBeans via the menu Tools > Java Platforms. Over years of practice, we earlier @@ -1037,6 +1022,24 @@ Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode) <a href=" https://www.web3d.org/x3d/content/examples/images/JavaControlPanelSecurityExceptionSiteList.png">Java Control Panel Security Exception Site List</a> (<a href="https://www.java.com/en/download/exception_sitelist.jsp">documentation</a>). </li> + <li> + For JDK 1.8 (but not later), + <a href="https://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 Download</a> + is needed to support various builds + (link also found at bottom of JavaSE downloads page). + <ul> + <li> Extract the contents (including README.txt) for inclusion in the JDK development build, for example + <br /> + <code style="color:darkgreen"><b>C:\Program Files\Java\jdk1.8.0_221\jre\lib\security</b></code></li> + <li> + <a href="https://download.oracle.com/javase/8/docs/technotes/guides/security">Java(TM) Cryptography Architecture (JCA) Reference Guide</a> + </li> + <li> + <a href="https://www.oracle.com/technetwork/java/javase/tech/index-jsp-136007.html">Java SE Security</a> + has more information about JCE and the Java SE Security Model. + </li> + </ul> + </li> </ul> <!-- =========================================================== --> @@ -2333,11 +2336,6 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> modern operating systems typically require specific configuration action to enable it. </p> <ul> - <li> - Authoritative reference: - <a href="https://tools.ietf.org/html/rfc854">RFC 854, TELNET PROTOCOL SPECIFICATION</a>, - default port 23. - </li> <li> System configuration changes typically require administrator permissions. </li> @@ -2366,7 +2364,16 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> Many ad hoc tools also exist (with lesser security) such as <a href="https://brew.sh" target="_blank">brew</a>. </li> - </ul> + <li> + Helpful reference: + <a href="https://www.telnet.org/htm/faq.htm">telnet FAQ</a>. + </li> + <li> + Authoritative reference: + <a href="https://tools.ietf.org/html/rfc854">RFC 854, TELNET PROTOCOL SPECIFICATION</a>, + default port 23. + </li> + </ul> <!-- =========================================================== --> @@ -2676,7 +2683,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 16.0.1) and moved to + Xj3D is upgraded to latest Java 16 (OpenJDK 16.0.2) and moved to <a href="https://gitlab.nps.edu/Savage/xj3d" target="_blank">https://gitlab.nps.edu/Savage/xj3d</a>. <br /> <i>Status:</i> @@ -3069,7 +3076,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 23 July 2021. + Revised 24 July 2021. </blockquote> <p>