Merge pull request #3225 from jimklimov/FTY-remerge-20251220

FTY remerge from master as of 2025-12-18

Author: jimklimov

.github/workflows/01-make-dist.yml

@@ -50,6 +50,15 @@ jobs:
       with:
         fetch-depth: 0
         fetch-tags: true
+        # NOTE: pull_request_target protects us by using the workflow definition
+        # from target branch (so trusted operations like artifact management can
+        # be used), but it also uses the code from that branch too, so fix it back.
+        # Maybe use "github.event.pull_request.merge_commit_sha" instead?.. though
+        # it may be null if the PR is not mergeable or is still checked for that,
+        # or may return the commit for PREVIOUS pushed iteration's merge to target.
+        # See more ideas in https://github.com/actions/checkout/issues/518 :
+        ref: "${{ github.event.pull_request.number > 0 && github.event.pull_request.head.sha || github.ref_name }}"
+        persist-credentials: false
 
     # https://github.com/marketplace/actions/substitute-string
     # See also examples in https://github.com/dhimmel/dump-actions-context/

Makefile.am

@@ -84,6 +84,11 @@ SUBDIRS_ALL_LIBS_LOCAL = \
 # (which used to cause us a lot of headache, building same things twice at
 # the same time).
 
+# For the intents and purposes of recursive-make calls, we have built
+# or updated include/nut_version.h before other targets in all-recursive
+### MAINTAINER_GENERATE_HEADER_DEBUG = yes
+### export NUT_VERSION_H_GENERATED = true
+
 #all all-recursive all-am-local all-local: all-fanout-maybe
 all-recursive: all-fanout-maybe
 
@@ -105,7 +110,10 @@ all-fanout-maybe:
 			if [ x"$(SUBDIR_MAKE_VERBOSE)" != x0 ] ; then \
 				echo "  SUBDIR-MAKE	$@: implement optimization for parallel make as 'make all-fanout-subdirs'" ; \
 			fi ; \
-			$(MAKE) $(AM_MAKEFLAGS) all-fanout-subdirs ;; \
+			$(MAKE) $(AM_MAKEFLAGS) all-fanout-subdirs || exit ; \
+			if [ x"$(SUBDIR_MAKE_VERBOSE)" != x0 ] ; then \
+				echo "  SUBDIR-MAKE	$@: optimization for parallel make as 'make all-fanout-subdirs' finished; now automake rules can follow up with default implementation of 'all-recursive' and/or 'all' (may try to regenerate some files again; should keep existing results though)" ; \
+			fi ;; \
 		*) \
 			if [ x"$(SUBDIR_MAKE_VERBOSE)" != x0 ] ; then \
 				echo "  SUBDIR-MAKE	$@: skip optimization for parallel make - we seem to run sequentially now, seen MAKEFLAGS='$(MAKEFLAGS)' AM_MAKEFLAGS='$(AM_MAKEFLAGS)'" ; \
@@ -123,10 +131,10 @@ all-fanout-maybe:
 # FIXME: Alas, we still tend to step on our toes when making everything at
 # once from scratch, so still do benefit from pre-making the libraries:
 all-fanout-staged:
-	+$(MAKE) $(AM_MAKEFLAGS) all/include
-	+$(MAKE) $(AM_MAKEFLAGS) all/common
-	+$(MAKE) $(AM_MAKEFLAGS) all-fanout-libs
-	+$(MAKE) $(AM_MAKEFLAGS) all-fanout-subdirs
+	+$(MAKE) $(AM_MAKEFLAGS) NUT_VERSION_H_GENERATED=false all/include
+	+$(MAKE) $(AM_MAKEFLAGS) NUT_VERSION_H_GENERATED=true all/common
+	+$(MAKE) $(AM_MAKEFLAGS) NUT_VERSION_H_GENERATED=true all-fanout-libs
+	+$(MAKE) $(AM_MAKEFLAGS) NUT_VERSION_H_GENERATED=true all-fanout-subdirs
 
 all-fanout-subdirs: $(SUBDIRS_ALL_RECURSIVE)
 
@@ -190,12 +198,12 @@ SUBDIR_TGT_RULE = ( \
 	[ x"$${TGT-}" != x ] || TGT="`echo '$@' | awk -F/ '{print $$1}'`" ; \
 	[ x"$${DIR-}" != x ] || DIR="`echo '$@' | sed 's,^[^/]*/,,'`" ; \
 	if [ x"$(SUBDIR_MAKE_VERBOSE)" != x0 ] ; then \
-		echo "  SUBDIR-MAKE	STARTING: 'make $$TGT' in $$DIR ..." ; \
+		echo "  SUBDIR-MAKE	STARTING $@: 'make $${SUBDIR_TGT_MAKEFLAGS-} $$TGT' in $$DIR ..." ; \
 	fi ; \
 	cd "$(abs_builddir)/$${DIR}" && \
 	$(MAKE) $(AM_MAKEFLAGS) $${SUBDIR_TGT_MAKEFLAGS-} "$${TGT}" || { RES=$$?; echo "  SUBDIR-MAKE	FAILURE: 'make $$TGT' in $$DIR" >&2 ; exit $$RES ; } ; \
 	if [ x"$(SUBDIR_MAKE_VERBOSE)" != x0 ] ; then \
-		echo "  SUBDIR-MAKE	SUCCESS: 'make $$TGT' in $$DIR" ; \
+		echo "  SUBDIR-MAKE	SUCCESS  $@: 'make $${SUBDIR_TGT_MAKEFLAGS-} $$TGT' in $$DIR" ; \
 	fi ; \
 	)
 
@@ -207,7 +215,8 @@ SUBDIR_TGT_RULE = ( \
 
 ### Delivers: nut_version.h
 all-libs-local/include:
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=false; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Delivers: libcommon.la libcommonclient.la libcommonstr.la libcommonstrjson.la
 ###           (consume only one of these at a time!)
@@ -216,7 +225,8 @@ all-libs-local/include:
 ### Requires-ext: include/nut_version.h
 ### Requires-int: libparseconf.la libcommonclient.la
 all-libs-local/common: all-libs-local/include
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Delivers: libupsclient.la libnutclient.la libnutclientstub.la
 ### Delivers: libupsclient-version.h
@@ -226,7 +236,8 @@ all-libs-local/common: all-libs-local/include
 ### Requires-ext: common/libparseconf.la
 ### Requires-int: libupsclient.la
 all-libs-local/clients: all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Delivers: libdummy.la libdummy_serial.la libdummy_upsdrvquery.la
 ### Delivers: libdummy_mockdrv.la libserial-nutscan.la
@@ -236,7 +247,8 @@ all-libs-local/clients: all-libs-local/common
 ### Requires-int: libdummy.la libdummy_upsdrvquery.la
 ### Requires-int: libdummy_serial.la
 all-libs-local/drivers: all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Delivers: libdriverstubusb.la
 ### LIB-Requires-ext: #COMMENTED-AWAY# common/libcommon.la
@@ -245,7 +257,8 @@ all-libs-local/drivers: all-libs-local/common
 ### Requires-ext: drivers/libdummy_mockdrv.la
 ### Requires-int: libdriverstubusb.la
 all-libs-local/tests: all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Delivers: generated sources and/or headers for nut-scanner
 ### No dependencies: actually runs as part of autogen.sh but may be
@@ -265,7 +278,8 @@ all-libs-local/tools:
 ###       however does directly use libupsclient-version.h
 ###       for hints to find it at run-time
 all-libs-local/tools/nut-scanner: all-libs-local/drivers all-libs-local/common all-libs-local/clients all-libs-local/tools
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 # Handle all SUBDIRS_ALL_RECURSIVE in a way that dependencies can be specified,
 # and portably to different make program implementations. Note we may revisit
@@ -282,13 +296,16 @@ all-recursive/data:
 	+@$(SUBDIR_TGT_RULE)
 
 all/include: all-libs-local/include
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 prep-src-docs/docs/man:
-	+@SUBDIR_TGT_MAKEFLAGS='MAINTAINER_DOCS_PREP_MAN_DELAY=3'; export SUBDIR_TGT_MAKEFLAGS; $(SUBDIR_TGT_RULE)
+	+@SUBDIR_TGT_MAKEFLAGS='MAINTAINER_DOCS_PREP_MAN_DELAY=3'; export SUBDIR_TGT_MAKEFLAGS; \
+	  $(SUBDIR_TGT_RULE)
 
 prep-src-docs/docs:
-	+@DOCS_NO_MAN=true; export DOCS_NO_MAN; $(SUBDIR_TGT_RULE)
+	+@DOCS_NO_MAN=true; export DOCS_NO_MAN; \
+	  $(SUBDIR_TGT_RULE)
 
 all/docs/man: prep-src-docs/docs/man
 	+@$(SUBDIR_TGT_RULE)
@@ -325,15 +342,17 @@ all-recursive/docs: all/docs all/docs/man
 
 ### Requires-int: libparseconf.la libcommonclient.la
 all/common: all/include all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Requires-ext: common/libcommon.la common/libcommonclient.la
 ### Requires-ext: common/libparseconf.la
 ### Requires-ext: common/libcommonversion.la
 ### Requires-ext: common/libcommonstrjson.la
 ### Requires-int: libupsclient.la
 all/clients: all/common all-libs-local/clients
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### Summary of drivers/ subdir dependencies:
 ### Requires-ext: common/libcommon.la common/libparseconf.la
@@ -356,7 +375,8 @@ if SOME_DRIVERS
 # in the default list - FIXME: configure.ac could tell us, so
 # we could provide it for tests/NIT anyway...)
 all/drivers: all-libs-local/clients all-libs-local/common all-libs-local/drivers
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 all-drivers: all/drivers
 else !SOME_DRIVERS
@@ -368,18 +388,22 @@ else !SOME_DRIVERS
 # should depend on both "dummy-ups" and the rest in so constrained
 # "all/drivers". This allows to ultimately not order one after another.
 dummy-ups$(EXEEXT)/drivers: all-libs-local/clients all-libs-local/common all-libs-local/drivers
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 all/drivers: all/common all-libs-local/drivers
-	+@SUBDIR_TGT_MAKEFLAGS='NUTSW_DRIVERLIST_DUMMY_UPS=dummy'; export SUBDIR_TGT_MAKEFLAGS; $(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  SUBDIR_TGT_MAKEFLAGS='NUTSW_DRIVERLIST_DUMMY_UPS=dummy'; export SUBDIR_TGT_MAKEFLAGS; \
+	  $(SUBDIR_TGT_RULE)
 
 all-drivers: dummy-ups$(EXEEXT)/drivers all/drivers
 endif !SOME_DRIVERS
 
 ### Requires-ext: common/libcommon.la common/libparseconf.la
 ### Requires-ext: common/libcommonversion.la
 all/server: all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### LIB-Requires-ext: drivers/libserial-nutscan.la
 ### LIB-Requires-ext: common/libnutwincompat.la common/libcommonstr.la
@@ -389,18 +413,21 @@ all/server: all-libs-local/common
 all/tools/nut-scanner: all-libs-local/include all-libs-local/common \
 	all-libs-local/drivers all-libs-local/clients \
 	all-libs-local/tools/nut-scanner
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 # only libnutscan is needed for nutconf,
 # but we do wholesale subdir all-libs-local at the moment...
 ### Requires-ext: common/libcommon.la common/libnutconf.la
 ### Requires-ext: common/libcommonversion.la
 ### Requires-ext: tools/nut-scanner/libnutscan.la
 all/tools/nutconf: all-libs-local/tools/nut-scanner all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 all-recursive/tools: all/tools/nutconf all/tools/nut-scanner
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 # Prereqs for NIT are runnable upsd, upsc, upsmon, dummy-ups, sample configs...
 # For the actual "make check-NIT" runs - also python scripts and/or compiled
@@ -410,32 +437,38 @@ all-recursive/tools: all/tools/nutconf all/tools/nut-scanner
 # But then we should also consider what is enabled by configure and what is not.
 # Maybe we are doing a quick build not to be tested at all? :-/
 all/tests/NIT: all/clients all/server all-drivers all-recursive/tools all-recursive/data
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 ### LIB-Requires-ext: #COMMENTED-AWAY# common/libcommon.la
 ### Requires-ext: common/libcommon.la common/libnutconf.la
 ### Requires-ext: clients/libnutclient.la clients/libnutclientstub.la
 ### Requires-ext: drivers/libdummy_mockdrv.la
 ### Requires-int: libdriverstubusb.la
 all/tests: all-libs-local/tests all-libs-local/drivers all-libs-local/common all-libs-local/clients
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 all-recursive/tests: all/tests/NIT all/tests
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 if HAVE_MINGW_RESGEN
 if HAVE_WINDOWS
 ### Requires-ext: common/libcommon.la
 ### Requires-ext: common/libcommonversion.la
 all/scripts/Windows: all-libs-local/common
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 else !HAVE_WINDOWS
 all/scripts/Windows:
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 endif !HAVE_WINDOWS
 else !HAVE_MINGW_RESGEN
 all/scripts/Windows:
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 endif !HAVE_MINGW_RESGEN
 
 # May rely on dstate.o as well as common libs
@@ -448,10 +481,12 @@ if WITH_REGENERATE_DMF_NUTSCAN
 DMF_DEP_NUTSCAN += all-libs-local/tools/nut-scanner
 endif WITH_REGENERATE_DMF_NUTSCAN
 all/scripts/DMF: all-libs-local/drivers all-libs-local/common $(DMF_DEP_NUTSCAN)
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 all-recursive/scripts: all/scripts/Windows all/scripts/DMF
-	+@$(SUBDIR_TGT_RULE)
+	+@NUT_VERSION_H_GENERATED=true; export NUT_VERSION_H_GENERATED; \
+	  $(SUBDIR_TGT_RULE)
 
 # ----------------------------------------------------------------------
 # flags to pass to ./configure when calling "make distcheck" and "make
@@ -1588,6 +1623,7 @@ install-win-bundle-thirdparty:
 	 if test -n "$$ARCH" ; then export ARCH ; fi ; \
 	 DESTDIR='$(DESTDIR)' ; export DESTDIR ; \
 	 (  cd '$(DESTDIR)' || exit ; \
+	    GREP=$(GREP)' EGREP='$(EGREP)' \
 	    DESTDIR="" '$(abs_top_srcdir)/scripts/Windows/dllldd.sh' dllldddir . \
 	    | while read D ; do \
 	        echo "   DLL->bin       $$D" 2>&1 ; \
@@ -1596,6 +1632,7 @@ install-win-bundle-thirdparty:
 	 ) || exit ; \
 	 (  if test x"$(bindir)" = x"$(sbindir)" ; then exit 0 ; fi ; \
 	    cd '$(DESTDIR)/$(sbindir)' || exit ; \
+	    GREP=$(GREP)' EGREP='$(EGREP)' \
 	    '$(abs_top_srcdir)/scripts/Windows/dllldd.sh' dllldddir . \
 	    | while read D ; do \
 	        echo "   DLL->sbin      $$D" 2>&1 ; \
@@ -1605,6 +1642,7 @@ install-win-bundle-thirdparty:
 	 (  if test x"$(driverexecdir)" = x"$(bindir)" ; then exit 0 ; fi ; \
 	    if test x"$(driverexecdir)" = x"$(sbindir)" ; then exit 0 ; fi ; \
 	    cd '$(DESTDIR)/$(driverexecdir)' || exit ; \
+	    GREP=$(GREP)' EGREP='$(EGREP)' \
 	    '$(abs_top_srcdir)/scripts/Windows/dllldd.sh' dllldddir . \
 	    | while read D ; do \
 	        echo "   DLL->drv       $$D" 2>&1 ; \
@@ -1616,6 +1654,7 @@ install-win-bundle-thirdparty:
 	    if test x"$(cgiexecdir)" = x"$(sbindir)" ; then exit 0 ; fi ; \
 	    if test x"$(driverexecdir)" = x"$(cgiexecdir)" ; then exit 0 ; fi ; \
 	    cd '$(DESTDIR)/$(cgiexecdir)' || exit ; \
+	    GREP=$(GREP)' EGREP='$(EGREP)' \
 	    '$(abs_top_srcdir)/scripts/Windows/dllldd.sh' dllldddir . \
 	    | while read D ; do \
 	        echo "   DLL->cgi       $$D" 2>&1 ; \
@@ -1627,6 +1666,7 @@ install-win-bundle-thirdparty:
 	    if test x"$(libexecdir)" = x"$(driverexecdir)" ; then exit 0 ; fi ; \
 	    if test x"$(libexecdir)" = x"$(cgiexecdir)" ; then exit 0 ; fi ; \
 	    cd '$(DESTDIR)/$(libexecdir)' || exit ; \
+	    GREP=$(GREP)' EGREP='$(EGREP)' \
 	    '$(abs_top_srcdir)/scripts/Windows/dllldd.sh' dllldddir . \
 	    | while read D ; do \
 	        echo "   DLL->libexec   $$D" 2>&1 ; \

NEWS.adoc

@@ -55,10 +55,15 @@ https://github.com/networkupstools/nut/milestone/12
      stable name as a default implementation). Drivers united by `main.c`
      framework introduced a `upsdrv_tweak_prognames()` hook method to let
      them manipulate the array of `prognames[]` aliases. [PR #3101]
+   * USB drivers could truncate strings received from devices as a fallout
+     of PR #2604 merged in NUT v2.8.3; this should now be fixed. [PR #3211,
+     issue #3201]
    * `libusb0` and `libusb1` integrations now try both "Resource Descriptor
      Length" values they could identify on some devices: sometimes the first
      (or otherwise preferred) option may be not the correct one, so try the
      other too. [issue #3136]
+   * Improved high-verbosity debug tracing of NUT `libhid` and `usbhid-ups`
+     to help make sense of data processing issues (HID paths, strings). [#3201]
    * For state tree methods, introduced `difftime_st_tree_timespec()` to
      abstract platform-dependent definitions of `st_tree_timespec_t`. [PR #3156]
    * Introduced global variables for last changed timestamp and value of
@@ -75,6 +80,9 @@ https://github.com/networkupstools/nut/milestone/12
      systemd watchdog situation once, will not spam more about it" even if
      those "logged" messages were at an invisible verbosity level. [issue #3157,
      PR #3151]
+   * Revised detection of (relative) paths to program and configuration files
+     near the currently running program in NUT for Windows builds. [issues #3207,
+     #3063, #3065, #3219]
 
  - `asem`, `bestfortress`, `bestuferrups`, `bicker_ser`, `everups`, `metasys`,
    `masterguard`, `mge-utalk`, `oneac`, `phoenixcontact_modbus`, `pijuice`,
@@ -87,6 +95,9 @@ https://github.com/networkupstools/nut/milestone/12
    * Abandoned use of obsolete `gethostbyname()` in favour of `getaddrinfo()`.
      Extended to be IPv6-capable along the way. [#1209]
 
+ - Introduced a new NUT driver named `meanwell_ntu` which provides support for
+   the Mean Well NTU series hybrid inverter and UPS units. [PR #3206]
+
  - `nhs_ser` driver updates:
    * Driver source code includes a table to map baud rates (defined by the OS
      as C macros) to numbers and strings more useful to the driver program.
@@ -292,6 +303,10 @@ several `FSD` notifications into one executed action. [PR #3097]
      provided 'confargs' etc.) [#3140]
    * Added configure script options for 'libregex' tuning, just so it is on par
      with our other optional dependencies. [#3140]
+   * Changed `--enable-extapi-enphase` to not default to `auto` and then get
+     installed on every system capable of using it; this is a niche capability
+     for users of specific devices via a cloud portal. [follow-up to PR #2813
+     for issue #2807]
 
  - Fixed CI recipes for PyPI publication of PyNUT(Client) module to also
    include the source distribution (was posted for NUT v2.8.1 and v2.8.2
@@ -352,6 +367,20 @@ several `FSD` notifications into one executed action. [PR #3097]
    syntax is not supported everywhere (or the `!` operator generally).
    [#3099, #1660]
 
+ - Revised `tools/gitlog2version.sh` helper script (logic added into
+   a new `tools/semver-compare.sh`) with a mode to expand NUT SEMVER
+   components into wide zero-padded numbers, so it is easier to
+   alphanumerically compare different releases regardless of version
+   component lengths in digits (and differences in their amounts). You can
+   request an inverse operation with `NUT_VERSION_STRIP_LEADING_ZEROES=true`.
+   Added tests to cover different shell interpreter platforms (piggy-back
+   on the `tests/nut-driver-enumerator-test.sh` script), and made sure
+   that outputs of legacy-mode processing (with `NUT_VERSION_DEFAULT`
+   string provided by caller or saved in a tarball) are consistent with
+   git-mode. The new `tools/semver-compare.sh` helper can be used directly
+   to expand and strip version strings, sort and compare multiple versions
+   as one simple operation. [issue #3055, PRs #3213, #3217]
+
  - The NUT Integration Testing suite (NIT) script, if started as `root`,
    can now consult its run-time situation vs. `BUILTIN_RUN_AS_USER` and
    `BUILTIN_RUN_AS_GROUP` environment variables, and if those accounts