Release notes

Author: kwart

distribution/doc/release-notes/3.1.0.md

@@ -0,0 +1,47 @@
+# Version 3.1.0
+
+Release focused on packaging — the fat jar is gone, every supported
+platform now ships a native installer with its own bundled Java
+runtime.
+
+## Highlights
+
+- **Per-platform native installers** built with `jpackage` and Azul
+  Zulu+FX 21. Each bundles its own JRE — no system Java required.
+  - **Windows x64**: SignPath-signed MSI plus a portable ZIP. The old
+    EXE installer is dropped (MSI provides the same double-click UX
+    and enterprise deployability).
+  - **Linux x64 and aarch64**: DEB, RPM, and portable ZIPs. Flatpak
+    bundles are also published per architecture.
+  - **macOS Intel and Apple Silicon**: DMGs (unsigned for now — expect
+    a Gatekeeper warning; signing / notarization is tracked for a
+    follow-up) plus portable `.app` ZIPs.
+- **Two cross-platform ZIPs** for users who already have Java 21:
+  - `jsignpdf-3.1.0-full.zip` — every dependency plus JavaFX natives
+    for all supported OS/arch combinations. A small bootstrap launcher
+    picks the matching JavaFX classifier at startup; if none is
+    available, the GUI falls back to Swing.
+  - `jsignpdf-3.1.0-minimal.zip` — no JavaFX at all. Suitable for
+    headless / CLI signing, Linux aarch64, and downstream packagers
+    (Debian, Homebrew).
+- **Fat jar dropped.** The shaded `jsignpdf-jar-with-dependencies.jar`
+  is no longer produced — the library jar published to Maven Central
+  is unchanged. The cross-platform ZIPs use `bin/jsignpdf.sh` /
+  `bin\jsignpdf.cmd` launchers (and `com.intoolswetrust.jsignpdf.Bootstrap`
+  for runtime checks + JavaFX classifier selection) instead.
+- **`jsignpdf-3.1.0-SHA256SUMS.txt`** covers every release artifact.
+
+## Notes
+
+- The CLI `usage:` line and bundled examples now use `jsignpdf` as the
+  command name (instead of `java -jar JSignPdf.jar`), matching the
+  launcher you actually invoke.
+- OpenJFX 21 does not publish a `linux-aarch64` native classifier on
+  Maven Central, so the cross-platform full ZIP on Linux aarch64
+  always falls back to the Swing UI. The Linux aarch64 DEB / RPM /
+  Flatpak builds are unaffected — their bundled Zulu+FX runtime
+  supplies JavaFX as JDK modules.
+- Tracking issue: [#391](https://github.com/intoolswetrust/jsignpdf/issues/391).
+
+Thanks to everyone who contributed code, translations, bug reports,
+and feedback!