From e16efa31d44591dd2a14e552a1fd71cd809d42a0 Mon Sep 17 00:00:00 2001 From: Alexander Kriegisch Date: Fri, 8 Oct 2021 10:55:37 +0200 Subject: [PATCH] Add AspectJ 1.9.8 release notes Signed-off-by: Alexander Kriegisch --- docs/dist/doc/README-197.html | 4 +- docs/dist/doc/README-198.html | 105 +++++++++++++++++++++++++++++++++ docs/dist/doc/index.html | 107 +++++++++++++++++----------------- 3 files changed, 161 insertions(+), 55 deletions(-) create mode 100644 docs/dist/doc/README-198.html diff --git a/docs/dist/doc/README-197.html b/docs/dist/doc/README-197.html index 734882597..0b39b40cb 100644 --- a/docs/dist/doc/README-197.html +++ b/docs/dist/doc/README-197.html @@ -26,7 +26,7 @@

Please note that going forward Bugzilla for issue management is deprecated and new issues should be filed as GitHub issues. - The list of issues addressed for 1.9.7 can be found + The list of issues addressed for 1.9.7 can be found here for Bugzilla and here for GitHub issues.

@@ -35,7 +35,7 @@

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

text blocks (final 15)

AspectJ 1.9.8 Readme

AspectJ 1.9.8

+ Please note that Bugzilla for issue management is deprecated and new issues should be filed as + GitHub issues. + The list of issues addressed for 1.9.8 can be found + here for Bugzilla + and here for GitHub issues. +

New features

+ AspectJ 1.9.8 supports Java 17 and its final and preview + features, such as: +

sealed classes (final in Java 17, previews in Java 15, 16 and AspectJ 1.9.7)
pattern matching for switch

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

+ Furthermore, the --release N compiler option for correct cross-compilation to previous JDK bytecode + API + versions is now supported by AJC. Previously, the option existed (inherited by ECJ) but did not work correctly. +

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

+ + Cross-compilation to legacy JDK + : + An example class which only works correctly on JDK 8 when compiled with --release 8 due to API changes in + the JDK. Simply -source 8 -target 8 would not be enough in this case.
+ + Pattern matching for switch + +

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

Other changes and bug fixes

+ The AspectJ compiler no longer works on JDK 8-10. The minimum compile-time requirement for AspectJ is JDK 11 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, but the compiler itself (and probably also the load-time + weaver) needs JDK 11. +
Document build profiles and properties in docs/developer/BUILD.md
Add a guide for setting up an AspectJ development environment in docs/developer/IDE.md
Allowed JAR saving if -proceedOnError is specified

+ Available: 1.9.8 available DD-MMM-2021 +

AspectJ Documentation and Resources

AspectJ ^tm - is a seamless aspect-oriented extension to + is a seamless aspect-oriented extension to Java^tm. - The compiler and development tools are available under + The compiler and development tools are available under an open-source license, require Java 1.3 to run, and produce - code that runs in JDK 1.1 and later VM's. + code that runs in JDK 1.1 and later VM's. For the latest materials, see http://eclipse.org/aspectj. Not all of these materials have been updated for AspectJ 5. @@ -21,28 +21,28 @@ - @@ -54,37 +54,37 @@
AspectJ documentation

Section Contents

docs - FAQ, + FAQ, Quick Reference (AspectJ 5), - Quick Reference (1.2.1), + Quick Reference (1.2.1), AspectJ 5 Developer's Notebook, - programming, - development and - problem diagnosis guides, + programming, + development and + problem diagnosis guides, API and example code.
distributions +
distributions AspectJ; - development environment support for - Eclipse + development environment support for + Eclipse and - JDeveloper. + JDeveloper.

resources aosd.net; AspectJ project the bug db, - and mailing lists for + and mailing lists for users and developers.

- + - - - @@ -100,13 +100,13 @@ - @@ -114,10 +114,10 @@ - @@ -137,7 +137,8 @@ - @@ -215,8 +216,8 @@ -
Documentation Description
Documentation Description

AspectJ 5 Quick Reference This is a four-page quick reference for the AspectJ 5 language. + This is a four-page quick reference for the AspectJ 5 language.

AspectJ Quick Reference This is a two-page quick reference for the AspectJ language. + This is a two-page quick reference for the AspectJ language.

AspectJ 5 Developer's Notebook (printable html) This describes the changes to the AspectJ language and tools introduced - in the AspectJ 5 Development Kit. These changes are additive, and are not yet + in the AspectJ 5 Development Kit. These changes are additive, and are not yet reflected in the programming guide or quick reference.

Programming Guide (printable html) This introduces AOP and the AspectJ language. + This introduces AOP and the AspectJ language. Getting Started describes basic semantics, and shows development- and production-time applications. The AspectJ Language - describes join points, pointcuts, advice, and introduction, all features new to AOP. - Examples walks you through the + describes join points, pointcuts, advice, and introduction, all features new to AOP. + Examples walks you through the examples included with the documentation, and there are two short chapters on useful Idioms and a few Pitfalls @@ -92,7 +92,7 @@ the Quick Reference summarizes AspectJ syntax, the Language Semantics - best describes AspectJ usage, and + best describes AspectJ usage, and Implementation Notes describes how the current version is limited to code the compiler controls.
Development Environment Guide
- + (printable html) This is a guide to + This is a guide to ajc, the command-line compiler; ajbrowser, the stand-alone - GUI for compiling and viewing crosscutting structure; + GUI for compiling and viewing crosscutting structure; and the Ant tasks for building AspectJ programs.
Problem Diagnosis Guide
- + (printable html) This has a guide to + This has a guide to the various features available such as messages and trace to help you both solve problems with you own programs and report bugs to the AspectJ team.
README's Changes and porting guide for AspectJ + Changes and porting guide for AspectJ + 1.9.8, 1.9.7, 1.9.6, 1.9.5, @@ -196,7 +197,7 @@
Examples AspectJ code to demonstrate some language features and implement - JavaBean properties, the Observer pattern, a tracing library, + JavaBean properties, the Observer pattern, a tracing library, and a game application where aspects handle display updating.

AspectJ source code Source code for AspectJ is available - under the open-source + Source code for AspectJ is available + under the open-source Eclipse Public License v 2.0 license from the Git repositories for the AspectJ project. See the @@ -250,9 +251,9 @@
Other AspectJ resources
- + -
Resources Description
Resources Description
Mail lists +
Mail lists AspectJ users discuss tips and @@ -262,14 +263,14 @@ AspectJ developers discuss issues with developing the AspectJ tools on - aspectj-dev@eclipse.org. + aspectj-dev@eclipse.org. To get occasional emails about AspectJ releases - and relevant events, subscribe to + and relevant events, subscribe to aspectj-announce@eclipse.org. - To view list archives or subscribe to the list, go to + To view list archives or subscribe to the list, go to the AspectJ home page. - To find archived emails, use the Eclipse site + To find archived emails, use the Eclipse site search page.

Bug database @@ -288,15 +289,15 @@ Bugs all users should know about are flagged with the "info" keyword. - See the + See the - FAQ entry for instructions on submitting compiler bugs. + FAQ entry for instructions on submitting compiler bugs.

http://aosd.net - the AOSD web site This site has discussion and announcements related to - aspect-oriented software development (AOSD) in general. + aspect-oriented software development (AOSD) in general. Use announce@aosd.net to get and publish notices about AOSD workshops, conferences, and technology releases. @@ -309,39 +310,39 @@
Suggested paths for those new to AspectJ

- To learn the AspectJ language, read the + To learn the AspectJ language, read the Programming Guide, keeping the Semantics appendix nearby as the best reference for AspectJ usage. Focus initially on the join point model and pointcuts, concepts AOP adds to OOP. - To read about how the examples work, + To read about how the examples work, see the Examples section in the Programming Guide. - View and navigate the crosscutting structure using + View and navigate the crosscutting structure using AJDT; if you can't use Eclipse, try the ajbrowser structure viewer, as described in the AspectJ Browser section of the Development Environment Guide.
- To start using AspectJ with your own code, + To start using AspectJ with your own code, modify the example aspects to apply to your classes. As you learn, - use the compiler's -Xlint flags to catch some common - mistakes. (Understand that the + use the compiler's -Xlint flags to catch some common + mistakes. (Understand that the current implementation is limited to code the compiler controls.)
- To plan how to adopt AspectJ into a project, read the + To plan how to adopt AspectJ into a project, read the Programming Guide - on development- and production-time aspects - and the FAQ entries for + on development- and production-time aspects + and the FAQ entries for How should I start using AspectJ?, Deciding to adopt AspectJ, the Development tools sections (one, - two, - Load-time weaving + two, + Load-time weaving ), and AspectJ as open-source.
-- 2.39.5

Section	Contents
docs	- FAQ, + FAQ, Quick Reference (AspectJ 5), - Quick Reference (1.2.1), + Quick Reference (1.2.1), AspectJ 5 Developer's Notebook, - programming, - development and - problem diagnosis guides, + programming, + development and + problem diagnosis guides, API and example code.
distributions	+
distributions	AspectJ; - development environment support for - Eclipse + development environment support for + Eclipse and - JDeveloper. + JDeveloper.
resources	aosd.net; AspectJ project the bug db, - and mailing lists for + and mailing lists for users and developers.