aboutsummaryrefslogtreecommitdiffstats
path: root/docs/dist/doc/README-198.html
diff options
context:
space:
mode:
authorAlexander Kriegisch <Alexander@Kriegisch.name>2022-01-18 09:10:40 +0700
committerAlexander Kriegisch <Alexander@Kriegisch.name>2022-01-18 09:53:22 +0700
commit372b53f3b370031339b04926470ed60bd9e2c49f (patch)
tree70c2db6b4611a40b416636e521fd427536c8b395 /docs/dist/doc/README-198.html
parentb720626100766ec0c34985404d774eccb51efdc0 (diff)
downloadaspectj-372b53f3b370031339b04926470ed60bd9e2c49f.tar.gz
aspectj-372b53f3b370031339b04926470ed60bd9e2c49f.zip
Restructure README-198.html a bit
Move usage hints about compiler preview features and LTw on JDK 16+ towards the end. Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
Diffstat (limited to 'docs/dist/doc/README-198.html')
-rw-r--r--docs/dist/doc/README-198.html49
1 files changed, 28 insertions, 21 deletions
diff --git a/docs/dist/doc/README-198.html b/docs/dist/doc/README-198.html
index 7e30661da..7088b13d6 100644
--- a/docs/dist/doc/README-198.html
+++ b/docs/dist/doc/README-198.html
@@ -37,16 +37,6 @@
<li>Sealed classes (final in Java 17, previews in Java 15, 16 and AspectJ 1.9.7)</li>
<li>Pattern matching for <tt>switch</tt></li>
</ul>
-<p>
- For features marked as preview on a given JDK, you need to compile with <tt>ajc --enable-preview</tt> and run with
- <tt>java --enable-preview</tt> on that JDK.
-</p>
-<p>
- 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.
-</p>
<h2>Improvements</h2>
@@ -75,16 +65,6 @@
</li>
</ul>
-<h2>Using LTW on Java 16+</h2>
-
-<p>
- Please note that if you want to use load-time weaving on Java 16+, the weaving agent collides with
- <a href="https://openjdk.java.net/jeps/396">JEP 396 (Strongly Encapsulate JDK Internals by Default)</a>. Therefore,
- you need to set the JVM parameter <tt>--add-opens java.base/java.lang=ALL-UNNAMED</tt> 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.
-</p>
-
<h2>Other changes and bug fixes</h2>
<ul>
@@ -116,8 +96,35 @@
</li>
</ul>
+<h2>AspectJ usage hints</h2>
+
+<h3>Use LTW on Java 16+</h3>
+
+<p>
+ Please note that if you want to use load-time weaving on Java 16+, the weaving agent collides with
+ <a href="https://openjdk.java.net/jeps/396">JEP 396 (Strongly Encapsulate JDK Internals by Default)</a>. Therefore,
+ you need to set the JVM parameter <tt>--add-opens java.base/java.lang=ALL-UNNAMED</tt> 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.
+</p>
+
+<h3>Compile with Java preview features</h3>
+
+<p>
+ For features marked as preview on a given JDK, you need to compile with <tt>ajc --enable-preview</tt> and run with
+ <tt>java --enable-preview</tt> on that JDK.
+</p>
+<p>
+ 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.
+</p>
+
+<hr>
+
<p>
- Available: 1.9.8 available DD-MMM-2021
+ <b>Available:</b> 1.9.8 available DD-MMM-2022
</p>
</body>