Merge pull request #1472 from Unidata/5.9.0

Release 5.9.0

Author: lesserwhirls

build.gradle

@@ -29,8 +29,9 @@ allprojects {
   // We try to follow semantic versioning, and thus we use <major>.<minor>.<patch>-<prerelease version>
   // <prerelease version> may be SNAPSHOT, alphax, betax, etc.
   // Note - if bumping to a new major or minor version, be sure to update the docs
-  version = '5.9.0-SNAPSHOT'
+  version = '5.9.1-SNAPSHOT'
   status = 'development'
+  //status= 'release'
 }
 
 // Matches Maven's "project.description".

docs/src/site/_config.yml

@@ -2,7 +2,7 @@
 theme: unidata-jekyll-theme
 
 # this will appear in an HTML meta tag, sidebar, and perhaps elsewhere
-docset_version: 5.9 (dev)
+docset_version: 5.9
 
 # this appears on the top navigation bar next to the home button
 topnav_title: netCDF-Java

docs/src/site/pages/netcdfJava/Upgrade.md

@@ -1,6 +1,6 @@
 ---
 title: Upgrading to netCDF-Java version 5.x
-last_updated: 2021-06-02
+last_updated: 2025-08-08
 sidebar: netcdfJavaTutorial_sidebar
 toc: false
 permalink: upgrade.html
@@ -34,6 +34,17 @@ As such, we no longer utilize WebStart.
 
 ## netCDF-Java API Changes (5.9.x)
 
+Point release notes:
+* [5.9.0](https://github.com/Unidata/netcdf-java/releases/tag/v5.9.0){:target="_blank"} (_2025-08-08_)
+
+The 5.9.x includes bug fixes around zarr support, scaling of projection parameters, and setting of the library path for the netCDF-C library.
+Additionally, udunits grammar code is now generated at build time, HTTP errors when disambiguating http/https locations has been improved, and scanning for filter providers is done once during initialization.
+Finally, several third party libraries have been upgraded.
+Please see the release notes on GitHub for more details on additions, enhancements, and bug fixes.
+
+Note: we are looking to update the minimum version of the JVM we support for the project (currently Java 8).
+Please consider taking a moment to participate in the [poll on GitHub](https://github.com/Unidata/netcdf-java/discussions/1468){:target="_blank"}.
+
 ## netCDF-Java API Changes (5.8.x)
 
 Point release notes:

docs/src/site/pages/netcdfJava_tutorial/overview/BuildingFromSource.md

@@ -1,6 +1,6 @@
 ---
 title: Building From Source
-last_updated: 2020-04-06
+last_updated: 2025-08-08
 sidebar: netcdfJavaTutorial_sidebar
 permalink: building_from_source.html
 toc: false
@@ -52,7 +52,7 @@ The uber jars, such as `toolsUI.jar` and `netcdfAll.jar`, will be found in `buil
 
 ## Publishing
 
-NetCDF-Java is comprised of several modules, many of which you can use within your own projects, as described [here](using_netcdf_java_artifacts.html).
+NetCDF-Java comprises several modules, many of which you can use within your own projects, as described [here](using_netcdf_java_artifacts.html).
 At Unidata, we publish the artifacts that those modules generate to our Nexus repository.
 
 However, it may happen that you need artifacts for the in-development version of netCDF-Java in your local branch, which we usually don’t upload to Nexus.

docs/src/site/pages/netcdfJava_tutorial/overview/UsingNetcdfJava.md

@@ -1,6 +1,6 @@
 ---
 title: Using netCDF-Java Maven Artifacts
-last_updated: 2019-07-23
+last_updated: 2025-08-08
 sidebar: netcdfJavaTutorial_sidebar
 permalink: using_netcdf_java_artifacts.html
 toc: false
@@ -31,6 +31,8 @@ repositories {
 }
 ~~~
 
+For maximum compatibility, please include the Unidata repository after any other repositories, including maven central.
+
 Next, select modules based on the functionality you need.
 In the minimal case, you’ll just want `cdm-core` and a logger.
 `cdm` implements the CDM data model and allows you to read NetCD-3 files (and a number of other file types).
@@ -144,6 +146,7 @@ Otherwise, libaec will need to be installed and reachable in your system library
 This is the appropriate option if you’re not using a dependency management tool like Maven or Gradle and you don’t care about jar size or compatibility with other libraries. Simply include netcdfAll-${netcdfJavaVersion}.jar on the classpath when you run your program.
 You’ll also need a logger.
 Currently, the netcdfAll jar does not include `cdm-s3` due to the size of the AWS S3 SDK dependency, and does not include the `libaec-native` (native library binaries for libaec).
+The netcdfAll jar can be found at https://downloads.unidata.ucar.edu, or (starting with `5.9.0`) on the [GitHub release page](https://github.com/Unidata/netcdf-java/releases).
 
 ## Logging