diff options
author | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-01-04 08:29:34 +0700 |
---|---|---|
committer | Alexander Kriegisch <Alexander@Kriegisch.name> | 2024-01-06 10:09:11 +0100 |
commit | f7962810eca3ddda75d64b85caab2449eeff480e (patch) | |
tree | 1c6b31641f1e0b714afbb699cebfd1da3ccf96f8 /docs/dist/doc/README-121.adoc | |
parent | 0065b755292708d6fd27c067564ecef2b10ede04 (diff) | |
download | aspectj-f7962810eca3ddda75d64b85caab2449eeff480e.tar.gz aspectj-f7962810eca3ddda75d64b85caab2449eeff480e.zip |
Bulk-rename release read-me files to version numbers with dots
Also rename references. E.g.
- RELEASE-11 -> RELEASE-1.1
- RELEASE-1810 -> RELEASE-1.8.10
- RELEASE-1921 -> RELEASE-1.9.21
Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
Diffstat (limited to 'docs/dist/doc/README-121.adoc')
-rw-r--r-- | docs/dist/doc/README-121.adoc | 134 |
1 files changed, 0 insertions, 134 deletions
diff --git a/docs/dist/doc/README-121.adoc b/docs/dist/doc/README-121.adoc deleted file mode 100644 index c51bb81df..000000000 --- a/docs/dist/doc/README-121.adoc +++ /dev/null @@ -1,134 +0,0 @@ -== AspectJ 1.2.1 - -_© Copyright 2004 Contributors. All rights reserved._ - -AspectJ 1.2.1 is largely a bug-fix release and the definition of the -AspectJ language is unchanged from the 1.2.0 release (with the exception -that AspectJ 1.2.1 permits the use of the '+' operator to concatenate -the messages for declare error and warning statements). This document -describes the tools differences between AspectJ versions 1.2 and 1.2.1. -Users familiar with AspectJ 1.2 may find this document a quicker way to -learn what changed in the tools. - -This document summarizes changes in: - -* Weaver messages -* Dump support -* JDT Compiler version -* Line number information for join points -* Runtime performance -* String concatentation in declare error and warning statements -* Load-time weaving support -* Use of aspect libraries generated by ajc 1.2.1 with earlier versions -of ajc - -See the link:changes.html[changes document] for more details, or -xref:#allchanges[all the changes] as detailed in the bugzilla database. - -=== Weaver Informational Messages - -The AspectJ 1.2.1 compiler can produce informational messages about the -weaving process. To see these messages, use the -showWeaveInfo compiler -option, or set showweaveinfo=true in the iajc ant task. - -The following is an example of the messages produced when this option is -enabled: - -[source, text] -.... -C:\aspectj1.2.1\doc\examples\tjp>ajc -showWeaveInfo *.java - -Type 'tjp.Demo' (Demo.java:20) advised by around advice from 'tjp.GetInfo' -(GetInfo.java:26) [RuntimeTest=true] - -Type 'tjp.Demo' (Demo.java:30) advised by around advice from 'tjp.GetInfo' -(GetInfo.java:26) [RuntimeTest=true] - -Type 'tjp.Demo' (Demo.java:34) advised by around advice from 'tjp.GetInfo' -(GetInfo.java:26) [RuntimeTest=true] -.... - -=== Dump Support - -In the event of a compiler crash, AspectJ 1.2.1 will produce a dump file -giving important information about the state of the compiler at the time -of the crash. These dump files should enable us to analyze problems more -effectively. In the rare event that you witness a compiler crash, please -attach the dump file to the bug report. - -In addition to producing a dump file when an abort condition is -detected, the AspectJ 1.2.1 compiler can also be requested to create a -dump file on detection of a compilation error. Set the property -org.aspectj.weaver.Dump.condition=error to enable this behaviour. - -=== JDT Compiler Version - -AspectJ 1.2.1 is based on the Eclipse 3.0 final JDT compiler. - -=== Line Number Information for Join Points - -For source files compiled by ajc (as opposed to binary inputs to the -compiler compiled with some other java compiler), ajc now emits better -line number information for execution join points. In particular, for a -method, constructor or advice execution join point (as matched for -example by a declare error or declare warning statement), ajc 1.2.1 -reports the first line number of the declaration, as opposed to the line -number of the first line of code in the body. - -=== Runtime Performance - -AspectJ 1.2.1 contains a small number of runtime performance -optimisations, including optimisations of if(true) and if(false) -pointcut expressions, caching of getSignature() and toString() results -on JoinPoint objects, and an optimised implementation of cflow. - -In the case where there are no arguments bound in the cflow pointcut, -programs compiled under AspectJ 1.2.1 and that make heavy use of cflow -will run significantly faster. Thanks to the abc compiler team for -detecting this performance related bug and for piloting the fix. - -=== String Concatentation in Declare Error/Warning Statements - -String concatentation in declare error and warning statements is now -supported. For example, you can write: - -[source, java] -.... -declare warning : jdbcCall() && !inDataLayer() - : "Please don't make calls to JDBC " + - "outside of the data layer."; -.... - -=== Load-time Weaving Support - -The AspectJ 1.2.1 distribution contains a new jar in the lib directory, -aspectjweaver.jar, that contains the subset of aspectjtools.jar needed -for weaving only. This jar may be used in situations where you wish to -exploit AspectJ's binary weaving capabilities, but do not want the full -aspectjtools.jar around (aspectjweaver.jar is approx. 5 times smaller). - -In addition, the load-time weaving "aj" script which was included in the -doc/examples/ltw directory in the 1.2 distribution has been moved into -the regular bin directory. See xref:README-12.adoc[README-12] for -details of using this script. - -=== Binary Compatibility - -AspectJ 1.2.1 introduces a backwards-incompatible change to the class -file format generated by the AspectJ compiler. Classes generated by ajc -v1.2.1 cannot be used on the inpath or aspectpath of a weaver from a -prior version of the compiler. Classes generated by prior versions of -the compiler can of course be placed on the inpath or aspectpath of the -1.2.1 weaver. - -As ever, you should use the AspectJ runtime library (aspectjrt.jar) that -comes with the distribution you used to build your application. - -''''' - -[[allchanges]] -=== All changes are listed in the bug database - -For a complete list of changes in the 1.2.1 release, search for -`target 1.2.1` in the bug database: -https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler&target_milestone=1.2.1[https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.2.1&bug_status=RESOLVED&resolution=FIXED] |