From d3a06a6942b6f69ce9b5b4403d3c1cf1803cf01e Mon Sep 17 00:00:00 2001 From: Alexander Kriegisch Date: Sat, 19 Mar 2022 13:25:23 +0700 Subject: [PATCH] Docs: add AspectJ Java version compatibility table Signed-off-by: Alexander Kriegisch --- README.md | 1 + docs/dist/doc/JavaVersionCompatibility.md | 23 +++++++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 docs/dist/doc/JavaVersionCompatibility.md diff --git a/README.md b/README.md index 8f8ed181a..7273bc717 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,7 @@ Ensure you run this with a JDK - the more recent the better since some tests wil * [Getting started with AspectJ](https://www.eclipse.org/aspectj/doc/released/progguide/starting.html) * [Programming Guide](https://www.eclipse.org/aspectj/doc/released/progguide/index.html) * [READMEs for each version of AspectJ](docs/dist/doc) +* [AspectJ Java version compatibility](docs/dist/doc/JavaVersionCompatibility.md) ## Documentation for AspectJ developers diff --git a/docs/dist/doc/JavaVersionCompatibility.md b/docs/dist/doc/JavaVersionCompatibility.md new file mode 100644 index 000000000..be557d462 --- /dev/null +++ b/docs/dist/doc/JavaVersionCompatibility.md @@ -0,0 +1,23 @@ +# AspectJ Java version compatibility + +For reasons described e.g. in [this comment](https://github.com/eclipse/org.aspectj/issues/139#issuecomment-1072946123), +for AspectJ users it has become a little challenging to find out which minimum AspectJ version is required in order to +process byte code or compile source code using features of a certain Java language version. Since Java 10, this cannot +be easily concluded from the AspectJ version number anymore, and we are sorry for that. So here is a little overview: + +AspectJ version | Java version | Comments +----------------|--------------|-------- +1.9.8 | 17 | AspectJ compiler requires JDK 11+ during build time. During runtime, AspectJ still only requires Java 8+ for both compile-time and load-time weaving. Pure Java code can be compiled down to as old as 1.3 byte code level. +1.9.7 | 15, 16 +1.9.6 | 14 +1.9.5 | 13 +1.9.3 - 1.9.4 | 12 +1.9.2 | 11 +1.9.1 | 10 +1.9.0 | 9 +1.8.0 - 1.8.14 | 8 +1.7.0 - 1.7.4 | 7 +1.6.0 - 1.6.12 | 6 +1.5.0 - 1.5.4 | 5 + +Older versions omitted. -- 2.39.5