From 3055ddbcfe6c6b34b12d306894442123ac7ef684 Mon Sep 17 00:00:00 2001 From: Sean Arms <67096+lesserwhirls@users.noreply.github.com> Date: Fri, 8 Aug 2025 08:43:50 -0600 Subject: [PATCH 1/3] Update docs for 5.9.0 release --- docs/src/site/_config.yml | 2 +- docs/src/site/pages/netcdfJava/Upgrade.md | 13 ++++++++++++- .../overview/BuildingFromSource.md | 4 ++-- .../netcdfJava_tutorial/overview/UsingNetcdfJava.md | 5 ++++- 4 files changed, 19 insertions(+), 5 deletions(-) diff --git a/docs/src/site/_config.yml b/docs/src/site/_config.yml index c43ad85e9f..a151f2d715 100644 --- a/docs/src/site/_config.yml +++ b/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 diff --git a/docs/src/site/pages/netcdfJava/Upgrade.md b/docs/src/site/pages/netcdfJava/Upgrade.md index 5c47fab717..f61be3fc25 100644 --- a/docs/src/site/pages/netcdfJava/Upgrade.md +++ b/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: diff --git a/docs/src/site/pages/netcdfJava_tutorial/overview/BuildingFromSource.md b/docs/src/site/pages/netcdfJava_tutorial/overview/BuildingFromSource.md index 75a18ba335..97027abc19 100644 --- a/docs/src/site/pages/netcdfJava_tutorial/overview/BuildingFromSource.md +++ b/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. diff --git a/docs/src/site/pages/netcdfJava_tutorial/overview/UsingNetcdfJava.md b/docs/src/site/pages/netcdfJava_tutorial/overview/UsingNetcdfJava.md index 0e7c8d44fd..1387de3817 100644 --- a/docs/src/site/pages/netcdfJava_tutorial/overview/UsingNetcdfJava.md +++ b/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 From 6ac8520ca3c7239e427cec77e985136131610511 Mon Sep 17 00:00:00 2001 From: Sean Arms <67096+lesserwhirls@users.noreply.github.com> Date: Fri, 8 Aug 2025 08:48:01 -0600 Subject: [PATCH 2/3] Release 5.9.0 --- build.gradle | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/build.gradle b/build.gradle index 801caa2530..bf9211b422 100644 --- a/build.gradle +++ b/build.gradle @@ -29,8 +29,9 @@ allprojects { // We try to follow semantic versioning, and thus we use ..- // 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' - status = 'development' + version = '5.9.0' + //status = 'development' + status= 'release' } // Matches Maven's "project.description". From e470c5eff69727bd7fbdfb083b40cb39388a94bc Mon Sep 17 00:00:00 2001 From: Sean Arms <67096+lesserwhirls@users.noreply.github.com> Date: Fri, 8 Aug 2025 09:02:09 -0600 Subject: [PATCH 3/3] Begin work on 5.9.1-SNAPSHOT --- build.gradle | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/build.gradle b/build.gradle index bf9211b422..7dc36f8bc4 100644 --- a/build.gradle +++ b/build.gradle @@ -29,9 +29,9 @@ allprojects { // We try to follow semantic versioning, and thus we use ..- // 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' - //status = 'development' - status= 'release' + version = '5.9.1-SNAPSHOT' + status = 'development' + //status= 'release' } // Matches Maven's "project.description".