doc

Author: scivision

Readme.md

@@ -38,14 +38,13 @@ The
 [API listing](https://geospace-code.github.io/matlab-stdlib/)
 "backend" column tells which functions have selectable backend implementations.
 By default, when the "backend" is not specified to a function having selectable backend, the algorithm searches for the first available backend and uses that.
-The user can specify the backend as listed in the API for those functions by specifying say "java" etc. as available per-function.
-Normally the user does not specify the backend as we prioritize faster backends.
+
 
 * [.NET](https://www.mathworks.com/help/matlab/call-net-from-matlab.html)
   * Windows: all supported Matlab releases
   * Linux / macOS: R2024b and newer
 * [Java](./Readme_java.md): all supported Matlab releases
-* [Perl](https://www.mathworks.com/help/matlab/ref/perl.html):  Matlab R2018a and newer. This uses a system() call to Perl, which is bundled with Matlab on Windows and generally available on Linux and macOS
+* [Perl](https://www.mathworks.com/help/matlab/ref/perl.html):  Matlab R2018a and newer. This uses a system() call to Perl.
 * [Python](https://www.mathworks.com/help/matlab/call-python-libraries.html): Matlab R2022b and newer. `stdlib.has_python` checks that the Python version set by `pyenv()` is compatible with the Matlab release.
 * System shell calls: all supported Matlab releases. As a backup when the platform doesn't have the primary (faster) methods available, the system shell can be called for some functions.
 

Readme_java.md

@@ -1,7 +1,9 @@
 # Using Java in standard library for Matlab
 
-Java is not required for this project, but some functions are implemented with an optional Java backend.
-They are tested with and should work with Java versions 8, 11, 17, 21, and more.
+Java-based functions should work with any
+[Java version compatible with the Matlab release](https://www.mathworks.com/support/requirements/openjdk.html).
+Matlab in general does not bundle Java from the factory installation, but Java may have been installed by a system administrator.
+One cannot assume that Java will or will not be present on a given Matlab installation.
 
 Matlab's
 [Java language interface](https://www.mathworks.com/help/matlab/using-java-libraries-in-matlab.html)
@@ -12,7 +14,7 @@ Our optional Java backend functions use only factory Java class--no third-party
 
 ## Java backend diagnostic functions
 
-Tell JVM version:
+Tell Java Virtual Machine (JVM) version:
 
 ```matlab
 version("-java")
@@ -51,13 +53,11 @@ As general information (not used by Matlab-stdlib), non-factory Java classes can
 ## Configure Matlab JVM
 
 The Matlab Java interface is like other Matlab external languages such as Python.
-The Matlab default
+Matlab
 [JVM can be configured](https://www.mathworks.com/help/matlab/matlab_external/configure-your-system-to-use-java.html)
 to a compatible Java library by using the
 [jenv](https://www.mathworks.com/help/matlab/ref/jenv.html)
 Matlab function.
-Matlab vs. Java
-[version compatibility table](https://www.mathworks.com/support/requirements/openjdk.html).
 
 For example, to use the
 [JDK 17 on macOS](https://www.oracle.com/java/technologies/downloads/#jdk17-mac)
@@ -81,7 +81,7 @@ winget install Microsoft.OpenJDK.11
 ```
 
 To
-[revert back to the factory JRE](https://www.mathworks.com/help/matlab/ref/matlab_jenv.html)
+[revert back to the default JRE](https://www.mathworks.com/help/matlab/ref/matlab_jenv.html)
 if Matlab can't start or has problems, from system Terminal (not within Matlab):
 
 ```sh