From b507a0d7669dfbdd58e5c5de3370d4ea9e559b8a Mon Sep 17 00:00:00 2001
From: Chris Smowton <chris@smowton.net>
Date: Tue, 18 Mar 2025 15:43:46 +0000
Subject: [PATCH] Add change notes for recent Java changes

---
 java/ql/lib/change-notes/2025-03-18-cyclic-types.md   | 4 ++++
 java/ql/lib/change-notes/2025-03-18-gradle-fixes.md   | 4 ++++
 java/ql/lib/change-notes/2025-03-18-maven-enforcer.md | 4 ++++
 3 files changed, 12 insertions(+)
 create mode 100644 java/ql/lib/change-notes/2025-03-18-cyclic-types.md
 create mode 100644 java/ql/lib/change-notes/2025-03-18-gradle-fixes.md
 create mode 100644 java/ql/lib/change-notes/2025-03-18-maven-enforcer.md

diff --git a/java/ql/lib/change-notes/2025-03-18-cyclic-types.md b/java/ql/lib/change-notes/2025-03-18-cyclic-types.md
new file mode 100644
index 00000000000..15734999bb0
--- /dev/null
+++ b/java/ql/lib/change-notes/2025-03-18-cyclic-types.md
@@ -0,0 +1,4 @@
+---
+category: fix
+---
+* Java extraction no longer freezes for a long time or times out when using libraries that feature expanding cyclic generic types. For example, this was known to occur when using some classes from the Blazebit Persistence library.
diff --git a/java/ql/lib/change-notes/2025-03-18-gradle-fixes.md b/java/ql/lib/change-notes/2025-03-18-gradle-fixes.md
new file mode 100644
index 00000000000..2def03388fc
--- /dev/null
+++ b/java/ql/lib/change-notes/2025-03-18-gradle-fixes.md
@@ -0,0 +1,4 @@
+---
+category: fix
+---
+* Java build-mode `none` no longer fails when a required version of Gradle cannot be downloaded using the `gradle wrapper` command, such as due to a firewall. It will now attempt to use the system version of Gradle if present, or otherwise proceed without detailed dependency information.
diff --git a/java/ql/lib/change-notes/2025-03-18-maven-enforcer.md b/java/ql/lib/change-notes/2025-03-18-maven-enforcer.md
new file mode 100644
index 00000000000..549862da7ba
--- /dev/null
+++ b/java/ql/lib/change-notes/2025-03-18-maven-enforcer.md
@@ -0,0 +1,4 @@
+---
+category: minorAnalysis
+---
+* Java extraction is now able to download Maven 3.9.x if a Maven Enforcer Plugin configuration indicates it is necessary. Maven 3.8.x is still preferred if the enforcer-plugin configuration (if any) permits it.