Add 1.9.22 release notes

Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>

diff --git a/docs/release/README-1.9.22.adoc b/docs/release/README-1.9.22.adoc
new file mode 100644 (file)
index 0000000..efde205
--- /dev/null
+++ b/docs/release/README-1.9.22.adoc
@@ -0,0 +1,78 @@
+= AspectJ 1.9.22
+
+// AspectJ_JDK_Update: Each a.b.c release needs a new release notes document. For a.b.c.d minors, the existing a.b.c
+// document can be updated. After copying this document, remove the comment from the previous one.
+
+_© Copyright 2024 Contributors. All rights reserved._
+
+_Release info: 1.9.22 available 23-Mar-2024_
+
+Please note that Bugzilla for issue management is deprecated and new issues should be filed as
+https://github.com/eclipse-aspectj/aspectj/issues/new[GitHub issues]. The list of issues addressed for 1.9.22 can be
+found here:
+
+* https://github.com/eclipse-aspectj/aspectj/issues?q=is%3Aissue+is%3Aclosed++milestone%3A1.9.22[GitHub 1.9.22]
+* https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.22[Bugzilla 1.9.22]
+
+== New features
+
+AspectJ 1.9.22 supports https://openjdk.java.net/projects/jdk/22/[Java 22], its final and preview features, such as:
+
+* JEP 456: Unnamed Variables & Patterns
+* JEP 459: String Templates (Second Preview)
+* JEP 463: Implicitly Declared Classes and Instance Main Methods (Second Preview)
+* JEP 447: Statements before super(...) (Preview)
+
+The following Java 22 features are API or JVM only, therefore irrelevant for the compiler and should just work
+out of the box:
+
+* JEP 423: Region Pinning for G1
+* JEP 454: Foreign Function & Memory API
+* JEP 458: Launch Multi-File Source-Code Programs
+* JEP 462: Structured Concurrency (Second Preview)
+* JEP 464: Scoped Values (Second Preview)
+* JEP 457: Class-File API (Preview)
+* JEP 461: Stream Gatherers (Preview)
+* JEP 460: Vector API (Seventh Incubator)
+
+== Improvements
+
+* No major improvements
+
+== Other changes and bug fixes
+
+* No major bug fixes
+
+== AspectJ usage hints
+
+[[ajc_build_system_requirements]]
+=== AspectJ compiler build system requirements
+
+Since 1.9.21, the AspectJ compiler `ajc` (contained in the `aspectjtools` library) no longer works on JDKs 11 to 16. The
+minimum compile-time requirement is now JDK 17 due to upstream changes in the Eclipse Java Compiler (subset of JDT
+Core), which AspectJ is a fork of. You can still compile to legacy target versions as low as Java 1.3 when compiling
+plain Java code or using plain Java ITD constructs which do not require the AspectJ runtime `aspectjrt`, but the
+compiler itself needs JDK 17+. Just like in previous AspectJ versions, both the runtime `aspectjrt` and the load-time
+weaver `aspectjweaver` still only require JRE 8+.
+
+History: Since 1.9.8, the AspectJ compiler ajc needed JDK 11+, before then JDK 8+.
+
+[[ltw_java_16]]
+=== Use LTW on Java 16+
+
+**Since AspectJ 1.9.21.1, using `--add-opens` is no longer necessary!** The additional JVM command-line option was
+necessary for LTW on JRE 16+ in all AspectJ versions up to 1.9.21. Since AspectJ 1.9.21.1, the LTW agent uses an
+alternative approach for defining new classes during weaving, which works without `--add-opens` - at least for now, i.e.
+JDKs 8 to 22. There still is no canonical solution, because link:https://bugs.openjdk.org/browse/JDK-8200559[JDK-8200559]
+is still unresolved since 2018.
+
+[[compile_with_preview]]
+=== Compile with Java preview features
+
+For features marked as preview on a given JDK, you need to compile with `ajc --enable-preview` and run with
+`java --enable-preview` on that JDK.
+
+Please note, that you cannot run code compiled with preview features on any other JDK than the one used for compilation.
+For example, records compiled with preview on JDK 15 cannot be used on JDK 16 without recompilation. This is a JVM
+limitation unrelated to AspectJ. Also, e.g. sealed classes are preview-1 on JDK 15 and preview-2 on JDK 16. You still
+need to recompile, no matter what.