From 9131c030bd77797b3593dee984ac75821055a44d Mon Sep 17 00:00:00 2001 From: Alexander Kriegisch Date: Fri, 4 Jun 2021 10:08:54 +0700 Subject: [PATCH] Add release notes for 1.9.7 Signed-off-by: Alexander Kriegisch --- docs/dist/doc/README-197.html | 120 ++++++++++++++++++++++++++++++++++ docs/dist/doc/index.html | 1 + 2 files changed, 121 insertions(+) create mode 100644 docs/dist/doc/README-197.html diff --git a/docs/dist/doc/README-197.html b/docs/dist/doc/README-197.html new file mode 100644 index 000000000..2316ab580 --- /dev/null +++ b/docs/dist/doc/README-197.html @@ -0,0 +1,120 @@ + + + + +AspectJ 1.9.7 Readme + + + + +

+ +

AspectJ 1.9.7

+ +

+ AspectJ (binaries, source code, documentation) is now distributed under the + Eclipse Public License v 2.0. +

+ +

New features

+ +

+ AspectJ 1.9.7 supports Java 15 & + Java 16 and their respective final and review features: +

text blocks (final 15)
records (preview 15, final 16)
instanceof pattern matching (preview 15, final 16)
hidden classes (final 15)
sealed classes (preview 15, preview 16)

+ 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. +

+ 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): +

+ +

Using LTW on Java 16+

+ +

+ Please note that if you want to use load-time weaving on Java 16+, the weaving agent collides with + JEP 396 (Strongly Encapsulate JDK Internals by Default). Therefore, + you need to set the JVM parameter --add-opens java.base/java.lang=ALL-UNNAMED in order to enable aspect + weaving. This is due to the fact that the weaver uses internal APIs for which we have not found an adequate + replacement yet when defining classes in different classloaders. +

+ +

Organisational and internal changes

+ +

+ For AspectJ 1.9.7, we implemented a lot of internal changes concerning the build and release process, most of which + are not visible in the product itself but will help us to more easily maintain and release the product in the future + and more easily on-boarding new developers or contributors. For example: +

The main repository has been moved to GitHub, i.e. you can + open bug reports, feature requests and pull requests there now.
The Maven build has been improved, i.e. it is now easier to build and contribute to the product. Developers can + just import the Maven project and no longer depend on Eclipse to build and test AspectJ, but can e.g. also use + IntelliJ IDEA.
Continuous integration builds now run on GitHub for different JDK versions, also for pull requests. I.e. both + maintainers and contributors get to know if their changes break any tests.
We can build releases and deploy them directly to Sonatype OSSRH (snapshots) or Maven Central (releases) with + Maven now, i.e. it should be much easier in the future to publish development versions in order to enable users to + re-test fixed bugs or try new features.
All tests are portable now, i.e. they correctly run on Windows, too. This enables developers and contributors to make + a choice if they want to work on Linux or on Windows.

+ +

Other changes and bug fixes

+ +

Remove legacy JRockit support.
Support Windows 10 and Windows Server 2016/2019 in installer. Those versions were not detected until now, which + led to bogus Windows batch files forwarding only 9 AJC parameters to the Java process via + %1 %2 %3 %4 %5 %6 %7 %8 %9 instead of %*.
AJdoc (AspectJ's javadoc generator add-on for aspects) now supports the JDK 16 javadoc generator.
Fix serialVersionUID initialization for Java 9+
AJC (AspectJ Compiler) usage texts sometimes used to be printed twice and they were printed too often, e.g. on + top of every compile error. This has been fixed. Furthermore, the partly outdated usage text is now basically the + same as ECJ (Eclipse Java Compiler), which AJC is a fork of, plus AspectJ-specific additions which are added during + runtime.
Source and javadoc JARs distributed together with the AspectJ artifacts on Maven Central are now more accurate and + more complete with regard to what is included (ASM, JDT Core) and how package names have been relocated.
Fix sample code formatting issues (indentation) throughout the documentation.

+ +

+ Available: 1.9.7 available ##-###-2021 +

+ + + + diff --git a/docs/dist/doc/index.html b/docs/dist/doc/index.html index f8309f335..8192f36ac 100644 --- a/docs/dist/doc/index.html +++ b/docs/dist/doc/index.html @@ -138,6 +138,7 @@ README's Changes and porting guide for AspectJ + 1.9.7, 1.9.6, 1.9.5, 1.9.4, -- 2.39.5