diff options
Diffstat (limited to 'docs/release/README-1.9.20.adoc')
| -rw-r--r-- | docs/release/README-1.9.20.adoc | 25 |
1 files changed, 15 insertions, 10 deletions
diff --git a/docs/release/README-1.9.20.adoc b/docs/release/README-1.9.20.adoc index 51b9033e9..d44769238 100644 --- a/docs/release/README-1.9.20.adoc +++ b/docs/release/README-1.9.20.adoc @@ -1,4 +1,9 @@ -== AspectJ 1.9.20.1 += AspectJ 1.9.20 + +:doctype: book +:leveloffset: +1 + += AspectJ 1.9.20.1 _© Copyright 2023 Contributors. All rights reserved._ @@ -16,7 +21,7 @@ This is a bugfix release for 1.9.20, fixing two problems: The list of issues addressed for 1.9.20.1 can be found https://github.com/eclipse/org.aspectj/issues?q=is%3Aissue+is%3Aclosed++milestone%3A1.9.20.1[here]. -== AspectJ 1.9.20 += AspectJ 1.9.20 _© Copyright 2023 Contributors. All rights reserved._ @@ -30,7 +35,7 @@ here: * https://github.com/eclipse/org.aspectj/issues?q=is%3Aissue+is%3Aclosed++milestone%3A1.9.20.1[GitHub 1.9.20.1] * 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.20[Bugzilla 1.9.20] -=== New features +== New features AspectJ 1.9.20 supports https://openjdk.java.net/projects/jdk/20/[Java 20] and its final, preview and incubator features, such as: @@ -45,7 +50,7 @@ some open issues concerning Java 20 preview feature support, see the list in https://github.com/eclipse/org.aspectj/issues/184#issuecomment-1272254940[this comment]. AJC therefore inherits the same problems for the specific cases described in the linked issues. -=== Improvements +== Improvements * Since Java 9 and the introduction of the Java Module System, the upstream Eclipse Java Compiler (ECJ) and Eclipse Java Development Tools (JDT) had gone through some internal changes, enabling both the compiler and the IDE to handle new @@ -58,7 +63,7 @@ problems for the specific cases described in the linked issues. matching has been improved considerably. You can find some examples https://github.com/eclipse-aspectj/aspectj/tree/master/tests/bugs1920/github_24[here]. -=== Code examples +== Code examples You can find some sample code in the AspectJ test suite under the respective AspectJ version in which the features were first supported (possibly as JVM preview features): @@ -74,14 +79,14 @@ first supported (possibly as JVM preview features): concurrency features elsewhere, e.g. in the corresponding JEPs. In AspectJ, they should just work transparently like any other Java API. -=== Other changes and bug fixes +== Other changes and bug fixes * About a dozen bugs have been fixed, some of them quite old. See "list of issues addressed" further above and follow the link to GitHub to find out if your issue is among them. -=== AspectJ usage hints +== AspectJ usage hints -==== AspectJ compiler build system requirements +=== AspectJ compiler build system requirements Since 1.9.8, the AspectJ compiler `ajc` (contained in the `aspectjtools` library) no longer works on JDKs 8 to 10. The minimum compile-time requirement is now JDK 11 due to upstream changes in the Eclipse Java Compiler (subset of JDT @@ -90,7 +95,7 @@ plain Java code or using plain Java ITD constructs which do not require the Aspe compiler itself needs JDK 11+. Just like in previous AspectJ versions, both the runtime `aspectjrt` and the load-time weaver `aspectjweaver` still only require JRE 8+. -==== Use LTW on Java 16+ +=== Use LTW on Java 16+ Please note that if you want to use load-time weaving on Java 16+, the weaving agent collides with https://openjdk.java.net/jeps/396[JEP 396 (Strongly Encapsulate JDK Internals by Default)]. Therefore, you need to set @@ -98,7 +103,7 @@ the JVM parameter `--add-opens java.base/java.lang=ALL-UNNAMED` in order to enab fact that the weaver uses internal APIs for which we have not found an adequate replacement yet when defining classes in different classloaders. -==== Compile with Java preview features +=== 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. |