mirrors
/
org.aspectj
mirror of https://github.com/eclipse/org.aspectj.git
Watch 1
Star 0
Fork 0
Code Issues 0 Releases 139 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1147 Commits
38 Branches
Tree: 18bc9e7ebb
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '18bc9e7ebb'
${ noResults }
org.aspectj/docs/dist/doc/changes.html

changes.html 61KB
Raw Blame History

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693 
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

  2. <html> <head>

  3.   <meta http-equiv="Content-Language" content="en-us">

  4.   <title>Changes in AspectJ</title>

  5. <STYLE TYPE="text/css">

  6. <!--

  7.  

  8.    /* FOR THE SDA PAGE */

  9.  

  10. 	/*

  11. 	BODY {margin-top: 15px; margin-left: 15px; margin-right: 15px;}

  12. 	*/

  13. 

  14. 	A:link {

  15. 		color:#4756AC;

  16. 	}

  17. 	A:visited {

  18. 		color:#60657B;

  19. 	}

  20. 	A:hover {

  21. 		color:red

  22. 	}

  23. 	

  24. 	INPUT {font:12px "Courier New", sans-serif;}

  25. 	

  26. 	H2 {

  27. 		font:18px/18px Verdana, Arial, Helvetica, sans-serif; 

  28. 		color:black; 

  29. 		font-weight:bold; 

  30. 		margin-left: 10px;

  31. 		line-height:110%; 

  32. 	}

  33. 	H3 {

  34. 		font:17px/17px Verdana, Arial, Helvetica, sans-serif; 

  35. 		color:black; 

  36. 		//font-weight:bold; 

  37. 		margin-left: 10px;

  38. 		line-height:110%; 

  39. 	}

  40. 	H4 {

  41. 		font:15px/16px Verdana, Arial, Helvetica, sans-serif; 

  42. 		color:black; 

  43. 		font-weight:bold; 

  44. 		margin-left: 10px;

  45. 		line-height:140%;

  46. 	}

  47. 	P {

  48. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif; 

  49. 		margin-right: 10px;

  50. 		margin-left: 10px;

  51. 		line-height:130%; 

  52. 	}

  53. 	.paragraph {

  54. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif; 

  55. 		margin-right: 10px;

  56. 		margin-left: 10px;

  57. 		line-height:130%; 

  58. 	}

  59. 	.smallParagraph {

  60. 		font:11px/11px Verdana, Arial, Helvetica, sans-serif; 

  61. 		margin-right: 10px;

  62. 		margin-left: 10px;

  63. 		line-height:130%; 

  64. 	}

  65. 	LI {

  66. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif;

  67. 		text-align:justify; 

  68. 		margin-right: 10px;

  69. 		margin-left: 15px;

  70. 		line-height:120%; 

  71. 	}

  72. 	/*

  73. 	UL {

  74. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif;

  75. 		text-align:justify; 

  76. 		margin-right: 10px;

  77. 		margin-left: 15px;

  78. 		line-height:120%; 

  79. 	}*/

  80. 	

  81. 	DL {

  82. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif;

  83. 		text-align:justify; 

  84. 		margin-right: 10px;

  85. 		margin-left: 15px;

  86. 		line-height:120%; 

  87. 	}

  88. 	B { font:13px/13px Verdana, Arial, Helvetica, sans-serif; 

  89. 		font-weight:bold; 

  90. 		line-height:140%;

  91. 	}

  92. 	.footer {

  93. 		font:10px/10px Verdana, Arial, Helvetica, sans-serif;  

  94. 		color:#888888; 

  95. 		text-align:left

  96. 	}

  97. 	.figureTitle {

  98. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif; 

  99. 		text-align:justify; 

  100. 		text-align:center

  101. 	}

  102. 	.copyrightNotice {

  103. 		font:10px/10px Verdana, Arial, Helvetica, sans-serif; 

  104. 		color:#999999; 

  105. 		line-height:110%;

  106. 	}

  107. 	.smallHeading {

  108. 		font:13px/13px Verdana, Arial, Helvetica, sans-serif; 

  109. 		font-weight:bold;

  110. 		line-height:110%;

  111. 	}

  112. 	.tinyHeading {

  113. 		font:11px/11px Verdana, Arial, Helvetica, sans-serif; 

  114. 		font-weight:bold;

  115. 		line-height:120%;

  116. 	}

  117. 	.newsText {

  118. 		font:11px/11px Verdana, Arial, Helvetica, sans-serif; 

  119. 		line-height:130%;

  120. 	}

  121. 	.smallParagraph {

  122. 		font:11px/11px Verdana, Arial, Helvetica, sans-serif; 

  123. 		line-height:130%;

  124. 	}

  125. 	.fancyHeading {

  126. 		font:20px/20px Chantilly, Arial, Helvetica, sans-serif; 

  127. 		margin-right: 10px;

  128. 		color:#6f7a92;

  129. 		margin-left: 10px;

  130. 		line-height:130%;

  131. 	}

  132.  

  133. -->

  134. </STYLE>

  135. </head>

  136. <body>

  137. 

  138. <div align=right><small>

  139. &copy; Copyright 1998-2002 Palo Alto Research Center Incorporated

  140.                       2003 Contributors.

  141. All rights reserved.

  142. </small></div>

  143. 

  144. <h2>Changes in AspectJ</h2>

  145. 

  146. <ul>

  147.   <li> <a href="#1.2">1.2</a> (released TODO XXX) 

  148.   </li>

  149.   <li> <a href="#1.1.1">1.1.1</a> (released 2003-09) 

  150.   </li>

  151. 	<li> 1.1.0 (released 2003-06-06) 

  152. 	See <a href="README-11.html">README-11.html</a>

  153.   </li>

  154. 

  155.   <li><a href="#1.0.6">1.0.6</a> (released 2002-07-24)

  156.     <ul>

  157.       <li><a href="#1.0.6compiler">Compiler</a></li>

  158.       <li><a href="#1.0.6ajde">AJDE</a></li>

  159.       <li><a href="#1.0.6ajdoc">Ajdoc</a></li>

  160.     </ul>

  161.   </li>

  162. 

  163.   <li><a href="#1.0.5">1.0.5</a> (released 2002-06-27)

  164.   </li>

  165. 

  166.   <li><a href="#1.0.4">1.0.4</a> (released 2002-04-17)

  167.   </li>

  168. 

  169.   <li><a href="#1.0.3">1.0.3</a> (released 2002-02-08)

  170.   </li>

  171.   <li><a href="#1.0.2">1.0.2</a> (released 2002-02-06)

  172.   </li>

  173.   <li><a href="#1.0.1">1.0.1</a> (released 2001-12-18)

  174.   </li>

  175.   <li><a href="#1.0.0">1.0.0</a> (released 2001-11-30)

  176.   </li>

  177.   <li><a href="#1.0rc3">1.0rc3</a> (released 2001-11-14)

  178.   </li>

  179.   <li><a href="#1.0rc2">1.0rc2</a> (released 2001-10-12)

  180.   </li>

  181.   <li><a href="#1.0rc1">1.0rc1</a> (released 2001-10-5)

  182.   </li>

  183.   <li><a href="#1.0beta1">1.0beta1</a> (released 2001-08-29)

  184.   </li>

  185.   <li><a href="#1.0alpha1">1.0alpha1</a> (released 2001-08-09)

  186.   </li>

  187.   <li><a href="porting.html">Porting and Transition</a></li>

  188. </ul>

  189. 

  190. <hr />

  191. 

  192. <h2><a name="1.2">1.2</a></h2>

  193. <p>Some of the more significant bug fixes and enhancements in this release include:

  194.   <ul>

  195.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=46347">46347</a> 

  196.      The ajc compiler now can read .class files from directories as well as

  197.      zip files for bytecode weaving. 

  198.      </li>

  199.   </ul>

  200. 

  201. <h2><a name="1.1.1">1.1.1</a></h2>

  202. 

  203. <p>All known P1 and P2 bugs have been fixed in this release. The <a href="https://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&target_milestone=1.1.1">full list of bug fixes</a> 

  204. (49 in all) can be found on bugzilla.</p>

  205. 

  206. <p>Some of the more significant bug fixes and enhancements in this release include:

  207.   <ul>

  208.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=40943">40943</a> 

  209.      The ajc compiler now copies resource files from jars specified using the 

  210.      -injars option. When compiling with source directories, resources are <i>not</i>

  211.      copied - mirroring the behaviour of javac so as to cause minimum disruption

  212.      when switching between ajc and javac. 

  213.      (To copy resources from source directories, use the iajc Ant task 

  214.       <tt>sourceRootCopyFilter</tt> option.)

  215.      Thanks to Matthew

  216.      Webster for contributing many of the patches for this enhancement.

  217.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=39626">39626</a> 

  218.      ajc was erroneously putting aspectjtools.jar in the classpath of a compilation. 

  219.      This caused problems when attempting to compile projects using different versions

  220.      of any of the classes in aspectjtools.jar. Thanks to George Harley and Igor

  221.      Hjelmstrom Vinhas Ribeiro for their assistance in tracking this down.

  222.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=40257">40257</a>

  223.      Relative paths are now supported in ".lst" files.

  224.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=40771">40771</a> 

  225.      The Ajde apis are no longer coupled to swing. This is of most significance to AJDT

  226.      users on the Mac OS X platform, enabling AJDT to be used with Mac OS X.

  227.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=41254">41254</a> 

  228.      Of interest to those writing tools that need to interact with the structure model for 

  229.      AspectJ programs: the interface to the AspectJ structure model was significantly revised

  230.      and enhanced in 1.1.1.

  231.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=39462">39462</a>

  232.      A compiler exception was thrown when an abstract aspect in a library was extended by 

  233.      a concrete aspect using cflow. Thanks to Takao Naguchi for an easy to reproduce bug report.

  234.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=39479">39479</a> 

  235.      Compiler crashes when a constructor delegates to another constructor that uses a switch statement.

  236.      Thanks to Andy Clement for both the easy to reproduce bug report and the patch.

  237.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=41175">41175</a>

  238.      Declared exceptions were being lost on inter-type declarations made from binary

  239.      aspects in an aspect library.

  240.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=41359">41359</a>

  241.      Aspect per-clauses were not inherited by sub-aspects when using binary aspect libraries. 

  242.      Thanks to Chris Bozic for the easy to reproduce bug report.

  243.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=42539">42539</a>

  244.      The "+" pattern was being ignored for type patterns used in throws clauses. Thanks to 

  245.      Keith Sader for the easy to reproduce bug report.

  246.      <li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=40807">40807</a>

  247.      If you specify no output directory, the iajc Ant task now defaults to using 

  248.      the source directory, following ajc and javac.

  249.      As a result, now you can use ajc to compile JSP's in Tomcat. 

  250.      Thanks to Ron Bodkin for investigating how to integrate ajc with Tomcat.

  251.   </ul>

  252. </p>

  253. 

  254. <h2><a name="1.0.6">1.0.6</a></h2>

  255. 

  256. <p> This release contains mainly bug fixes for ajde and ajdoc. 

  257. 

  258. <h3><a name="1.0.6compiler">Compiler</a></h3>

  259. 

  260. <p>We fixed a bug with switch statements, thanks largely 

  261. to Jason Rimmer's diligence in helping us isolate the problem. 

  262. Also, to help Log4J parse stack traces, we changed class file 

  263. symbolic line references to use [] instead of () for the 

  264. virtual start lines of each file. 

  265. </p>

  266. 

  267. <h3><a name="1.0.6ajde">AJDE</a></h3>

  268. 

  269. <p><b>AJDE Framework, AJBrowser, and AJDE for Forte/NetBeans</b></p>

  270. 

  271. <p>The memory use of the structure model has been streamlined in order to reduce 

  272. footprint when working with large systems.&nbsp; Error tolerance has also been 

  273. improved for dealing with a structure model that is out of synch with resources 

  274. on disk.</p>

  275. 

  276. <h4>AJDE for JBuilder</h4>

  277. 

  278. <p>JBuilder 7 is now supported.&nbsp; All known bugs have been fixed including:</p>

  279. 

  280. <ul>

  281.   <li><a href="http://aspectj.org/bugs/resolved?id=787">787</a> 

  282.    AJDE for JBuilder throws exception given non-existent file</li>

  283.   <li><a href="http://aspectj.org/bugs/resolved?id=788">788</a> 

  284.    Label too small in error message </li>

  285.   <li><a href="http://aspectj.org/bugs/resolved?id=789">789</a> 

  286.    Index-out-of-bounds exception in JBuilder AJDE </li>

  287.   <li><a href="http://aspectj.org/bugs/resolved?id=792">792</a> 

  288.    Required libraries disappear from JBuilder 6 </li>

  289.   <li><a href="http://aspectj.org/bugs/resolved?id=795">795</a> 

  290.    Unable to compile open tools </li>

  291.   <li><a href="http://aspectj.org/bugs/resolved?id=802">802</a> 

  292.    AJDE loses current (cursor) position in file when switching files </li>

  293. </ul>

  294. 

  295. <p>In addition, thanks to user feedback that indicated trouble building JBuilder 

  296. OpenTools with AJDE/JBuilder, the OpenTool is now being built with itself. </p>

  297. 

  298. <h3><a name="1.0.6ajdoc">Ajdoc</a></h3>

  299.   <ul>

  300.   <li>Fixed <a href="http://aspectj.org/bugs/resolved?id=790">790</a> 

  301.       aspect code comments suppressed by fix to bug 710

  302.       </li>

  303.   <li>Known problems: <a href="http://aspectj.org/bugs/ajdoc">

  304.       http://aspectj.org/bugs/ajdoc 

  305.       </a></li>

  306.   </ul>

  307. 

  308. <hr />

  309. 

  310. <h2><a name="1.0.5">1.0.5</a></h2>

  311. 

  312. 

  313. <p>This release includes significant improvements to AspectJ Development 

  314. Environment (AJDE) support. The entire user interface has been revised and 

  315. streamlined. The AJDE features are more tightly integrated into JBuilder and 

  316. NetBeans/Forte support. JBuilder support now includes graphical configuration 

  317. file editing and an integrated AspectJ Browser tool. </p>

  318. 

  319. <ul>

  320.   <li><a href="#1.0.5compiler">Compiler</a></li>

  321.   <li><a href="#1.0.5ajde">AJDE</a></li>

  322.   <li><a href="#1.0.5ajdoc">Ajdoc</a></li>

  323.   <li><a href="#1.0.5anttasks">Ant tasks</a></li>

  324. </ul>

  325. 

  326. <h3><a name="1.0.5compiler">Compiler</a></h3>

  327. 

  328. <p> This was another compiler release primarily concerned with fixing

  329. corner cases in the language implementation.  Our handling of nested

  330. classes, the assert statement, and cflow were the principal offenders

  331. this time.  Thanks to Nicholas Alex Leidenfrost and Patrick Chan for

  332. their clear and concise bug reports on some of these issues.  </p>

  333. 

  334. <h3><a name="1.0.5ajde">AJDE</a></h3>

  335. 

  336. <h4><span style="font-weight: 400">This release includes significant 

  337. improvements to AspectJ Development Environment (AJDE) support. All known bugs 

  338. have been fixed, and the core framework quality has been significantly increased 

  339. thanks to the adoption of a unit test suite.  The following changes apply 

  340. to all of the AJDE NetBeans/Forte, JBuilder, and the AspectJ Browser support.  

  341. NetBeans/Forte and JBuilder-specific changes are listed below.  </span></h4>

  342. 

  343. 

  344. <ul>

  345.   <li><span style="font-weight: 400">The entire user interface has been revised 

  346.   and streamlined.</span></li>

  347.   <li>The structure view and browser have a new UI, and offer both a file-based 

  348.   and global structure views.  All views expose node ordering, node 

  349.   filtering, and association filtering functionality.  The global views 

  350.   expose a package tree as well as the global inheritance and crosscutting 

  351.   structure.  </li>

  352.   <li>Structure view navigation now has a history exposed by back/forward.</li>

  353.   <li>The is a new build configuration management UI.</li>

  354.   <li>The compiler preferences UI now includes access to all build options.</li>

  355.   <li>Error messages have been improved, and the structure views include 

  356.   annotations of nodes with errors and warnings.</li>

  357. </ul>

  358. 

  359. <h4>AJDE for JBuilder</h4>

  360. 

  361. 

  362. <p>Integration into the JBuilder IDE is more streamlined.  In addition:</p>

  363. 

  364. 

  365. <ul>

  366.   <li>The AspectJ Browser is included as a tool that replaces JBuilder's 

  367.   "Project View" and can be used to navigate the global structure of your system 

  368.   (including the crosscutting and inheritance structure).</li>

  369.   <li>Inline structure annotations in the editor's gutter can now expose all of 

  370.   the structure presented in the structure view, and can be used to navigate in 

  371.   a similar way.  Note that there are preferences for toggling which of 

  372.   these appear.</li>

  373.   <li>Building is better integrated and the JBuilder build toolbar is removed 

  374.   when AJDE is enabled.</li>

  375.   <li>Build configurations can be selected from the build button's menu.</li>

  376.   <li>Execution is better integrated: instead of a separate "run" button 

  377.   JBuilder's run and debug can be used.  Note that for new projects you 

  378.   will need to use the "AspectJ Runtime" library, which will be added to your 

  379.   preferences automatically.</li>

  380.   <li>A new graphical build configuration editor can be used by double-clicking 

  381.   ".lst" files that have been added to the project. </li>

  382.   <li>Error messages now match JBuilder's look-and-feel and behavior.  

  383.   Seeking to column numbers now works in addition to line numbers.</li>

  384. </ul>

  385. 

  386. 

  387. <h4>AJDE for Forte/NetBeans</h4>

  388. 

  389. 

  390. <p>Integration into the NetBeans IDE is more streamlined.  In addition:</p>

  391. 

  392. 

  393. <ul>

  394.   <li>NetBeans 3.3.2 and SunONE Studio 4 are supported.</li>

  395.   <li>Multiple filesystems are supported.</li>

  396.   <li>Default project build configurations (all project files) are now 

  397.   supported.</li>

  398.   <li>Build configurations can be selected in the tool bar.</li>

  399.   <li>Regular NetBeans execution and debugging is supported.  Note that you 

  400.   have to add netbeans/lib/ext/aspectjrt.jar file to your project configuration.</li>

  401.   <li>Class files are generated beside source files (NetBeans/javac default).  

  402.   There is currently no way to specify a target directory.</li>

  403. </ul>

  404. 

  405. 

  406. <h4>AJBrowser</h4>

  407. 

  408. 

  409. <ul>

  410.   <li>The browser now supports main class execution.  Set the main class in 

  411.   the options dialog, and make sure that both the Java executable is on your 

  412.   path, and the class that you expect to execute on your classpath.</li>

  413.   <li>The error messages UI has been improved.</li>

  414. </ul>

  415. 

  416. 

  417. <h3><a name="1.0.5ajdoc">Ajdoc</a></h3>

  418. <p>Bug fixes:

  419. </p>

  420.   <ul>

  421.   <li><a href="http://aspectj.org/bugs/resolved?id=710">710 - 

  422.       compiler-generated constructor shown with class comment

  423.       </a></li>

  424.   <li><a href="http://aspectj.org/bugs/resolved?id=712">712 - 

  425.       comments lost in aspect docs for methods 

  426.       or constructors declared on other types.

  427.       </a></li>

  428.   <li><a href="http://aspectj.org/bugs/resolved?id=719">719 - 

  429.       poor support for @link, @see tags

  430.       </a></li>

  431.   <li><a href="http://aspectj.org/bugs/resolved?id=742">742 - 

  432.       crash with @see tag

  433.       </a></li>

  434.   <li><a href="http://aspectj.org/bugs/resolved?id=751">751 - 

  435.       error loading doclet resource

  436.       </a></li>

  437.   </ul>

  438. 

  439. <h3><a name="1.0.5anttasks">Ant tasks</a></h3>

  440. <p>Bug fixes:

  441. </p>

  442.   <ul>

  443.   <li><a href="http://aspectj.org/bugs/resolved?id=730">730 - 

  444.       document all supported ajc flags <a></li>

  445.   </ul>

  446. 

  447. <hr />

  448. 

  449. <h2><a name="1.0.4">1.0.4</a></h2>

  450. 

  451. <ul>

  452.          <li><a href="#1.0.4compiler">Compiler</a></li>

  453.          <li><a href="#1.0.4ajde">AJDE</a></li>

  454.          <li><a href="#1.0.4ajdoc">Ajdoc</a></li>

  455.          <li><a href="#1.0.4taskdefs">Ant taskdefs</a></li>

  456.          <li><a href="#1.0.4doc">Documentation</a></li>

  457. </ul>

  458. 

  459. <h3><a name="1.0.4compiler">Compiler</a></h3>

  460. <ul>

  461.   <li>Over a dozen people independently reported a bug in error

  462.   handling for the wrong number number of arguments to

  463.   <code>proceed</code>.  This has been turned into a nice error

  464.   message.  A number of other bug reports related to around advice and

  465.   proceed have also been fixed, including the ability to change the

  466.   bindings for <code>this</code> and <code>target</code> using proceed

  467.   in around advice.

  468.   </li>

  469.   <li>David Walend gets the <em>black thumb</em> award for the most

  470.   bug reports submitted by a new user.  His bug report on the 

  471.   behavior of after returning advice led to some valuable clarifications

  472.   of this part of the language spec.

  473.   </li>

  474.   <li>A number of places where ajc didn't fully comply with the Java

  475.   Language Spec have been fixed in this release.  Thanks to Neal

  476.   Gafter for reporting many of these.

  477.   </li>

  478. </ul>

  479. 

  480. <h4>Incompatible changes</h4>

  481. 

  482. <p>Two potentially surprising incompatible changes have been made to

  483. ajc in order to bring the compiler into compliance with the 1.0

  484. language design.  These changes will be signalled by clear warning or

  485. error messages at compile-time and will not cause any run-time

  486. surprises.  We expect most users to never notice these changes.</p>

  487. 

  488. <ul>

  489.   <li>The obsolete class

  490.   <code>org.aspectj.lang.MultipleAspectsBoundException</code> has been

  491.   removed from aspectjrt.jar.  This class had not been used since

  492.   AspectJ-0.8 and should have been removed prior to the 1.0 release.

  493.   It is not documented as part of the 1.0 language spec.  This change

  494.   will cause a compile-time type not found error in any code that

  495.   refers to this exception.</code>

  496. 

  497.   <li>The compiler was not correctly implementing the AspectJ-1.0

  498.   language design for some uses of after returning advice.  This

  499.   compiler behavior was fixed, and advice whose behavior might be

  500.   changed by this bug fix will be highlighted with a compiler

  501.   warning.  More information about some of these changes can be found

  502.   in the <a href="porting.html#pre-1.0.4">porting notes</a>.</li>

  503. </ul>

  504. 

  505. <h3><a name="1.0.4ajde">AJDE</a></h3>

  506. 

  507. 

  508. <p>This is the first release of AJDE support with significant external 

  509. contribution.  A big thanks goes out to Phil Sager for porting the AJDE for 

  510. Forte/NetBeans support to NetBeans 3.3.1 and improving the integration into 

  511. NetBeans.</p>

  512. 

  513. 

  514. <h4>AJDE for JBuilder</h4>

  515. 

  516. <ul>

  517.   <li>Updates<ul>

  518.     <li>This is a bug fix release only.  </li>

  519.   </ul>

  520.   </li>

  521. </ul>

  522. 

  523. <h4>AJDE for Forte/NetBeans</h4>

  524. 

  525. <ul>

  526.   <li>Updates<ul>

  527.     <li>NetBeans 3.3.1 is now supported in addition to NetBeans 3.2 and Forte CE 

  528.     3.</li>

  529.     <li>Native NetBeans main class execution can now be used.  After doing 

  530.     a "Compile with AJC" browse to the main class in the "Filesystems" Explorer, 

  531.     right-click the class and select "Execute".  </li>

  532.     <li>The debugger can now be used if the project main class is set ("Project" 

  533.     menu -&gt; "Set Project Main Class...").</li>

  534.     <li>Numerous bugs have been fixed.</li>

  535.   </ul>

  536.   </li>

  537.   <li>Known limitations<ul>

  538.     <li>Breakpoint setting does not work in the debugger.</li>

  539.     <li>In the "Filesystems" Explorer red Xs appear on files with AspectJ source 

  540.     code.  The "AspectJ" Explorer understands the structure of AspectJ 

  541.     projects and should be used for navigating structure instead.</li>

  542.   </ul>

  543.   </li>

  544. </ul>

  545. 

  546. <h4>AJDE for Emacs</h4>

  547. 

  548. 

  549. <ul>

  550.   <li>This is a bug fix release only.</li>

  551. </ul>

  552. 

  553. 

  554. <h3><a name="1.0.4ajdoc">Ajdoc</a></h3>

  555. <p>Ajdoc now runs under J2SE 1.4, but still requires the tools.jar 

  556.    from J2SE 1.3 be on the classpath.

  557. </p>

  558. 

  559. <h3><a name="1.0.4taskdefs">Ant tasks</a></h3>

  560. <ul>

  561.    <li>Repackaged to fit into the AspectJ product directory - e.g., 

  562.        <code>aspectj-ant.jar</code> moved to <code>lib</code> 

  563.        as expected by <code>examples/build.xml</code>.

  564.    </li>

  565.    <li>Fixed bugs, esp. <a href="http://aspectj.org/bugs/resolved?id=682">682</a>:

  566.        Throw BuildException if failonerror and ajdoc detects misconfiguration.

  567.    </li>

  568. </ul>

  569. <h3><a name="1.0.4doc">Documentation</a></h3>

  570. <p>Added a 1-page quick reference guide.  Improved javadoc documentation for

  571.    the org.aspectj.lang package.

  572. </p>

  573. 

  574. 

  575. <hr/>

  576. 

  577. <h2><a name="1.0.3">1.0.3</a></h2>

  578. 

  579. <ul>

  580.   <li><a href="#1.0.3compiler">Compiler</a></li>

  581.   <li><a href="#1.0.3taskdefs">Ant taskdefs</a></li>

  582. </ul>

  583. 

  584. <h3><a name="1.0.3compiler">Compiler</a></h3>

  585. <p> This release fixes a single significant bug in 1.0.2 where ajc

  586. could generate unreachable code in <code>-usejavac</code> or

  587. <code>-preprocess</code> mode.  This would happen when around advice

  588. was placed on void methods whose body consisted solely of a

  589. <code>while (true) {}</code> loop.  We now properly handle the

  590. flow-analysis for this case and generate code that is acceptable to

  591. javac.  Thanks to Rich Price for reporting this bug.

  592. </p>

  593. 

  594. <h3><a name="1.0.3taskdefs">Ant taskdefs</a></h3>

  595. <p>Added support to the Ajc taskdef for the -source 1.4 and -X options generally.

  596. </p>

  597. 

  598. <hr />

  599. 

  600. <h2><a name="1.0.2">1.0.2</a></h2>

  601. 

  602. <p> This release is mainly about keeping up with the Joneses.  To keep

  603. up with SUN's release candidate for J2SE1.4, we now officially support

  604. the new 1.4 assertions and running on the 1.4 VM.  In honor of the

  605. public review of JSR-45 Debugging Support for Other Languages we

  606. implement this spec for AspectJ.  We support Borland's recent release

  607. of JBuilder 6, and since some of our users are starting to work on Mac

  608. OSX, AJDE now works nicely on this platform.  We also fixed almost all of

  609. the bugs you reported in 1.0.1.

  610. </p>

  611. 

  612. <ul>

  613.   <li><a href="#1.0.2compiler">Compiler</a></li>

  614.   <li><a href="#1.0.2ajde">AJDE</a></li>

  615.   <li><a href="#1.0.2ajdb">AJDB</a></li>

  616. </ul>

  617. 

  618. <h3><a name="1.0.2compiler">Compiler</a></h3>

  619. 

  620. <ul>

  621.   <li>Official support for <code>-source 1.4</code> option to compile new

  622.       <a href="http://java.sun.com/j2se/1.4/docs/guide/lang/assert.html">1.4 assertions</a>.

  623.       This makes ajc completely compatible with j2se-1.4.

  624.   </li>

  625.   <li>Implementation of <a href="http://jcp.org/jsr/detail/45.jsp">

  626.       JSR-45 Debugging Support for Other Languages</a> so that debuggers which

  627.       correctly implement this specification will be able to accurately debug

  628.       any AspectJ program at a source code level.  We are not currently

  629.       aware of any debuggers that implement this so far, but expect that

  630.       as j2se-1.4 becomes widely available this will change.

  631.   </li>

  632.   <li>As proposed by Arno Schmidmeier and seconded by Nick Lesiecki, we now have an

  633.       experimental <code>-Xlint</code> option that will provide warnings when

  634.       type patterns used in pcds have no bindings.  We are very interested in

  635.       feedback on the usefulness and suggested improvements for this feature.

  636.   </li>

  637.   <li>Several significant bugs in the implementation of around advice have been fixed.

  638.       These include issues with <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=632">

  639.       dynamic tests</a>, with

  640.       <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=620">

  641.       complicated local types in an around body</a>, and with 

  642.       <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=636">

  643.       capturing proceed in a closure</a>.

  644.   </li>

  645.   <li>All but two (<a href="http://aspectj.org/jitterbug/aspectj-bugs/compiler?id=626">1</a>,

  646.       <a href="http://aspectj.org/jitterbug/aspectj-bugs/compiler?id=645">2</a>)

  647.       verified bugs in 1.0.1 have been fixed.  The two outstanding bugs

  648.       have relatively easy work-arounds.  Thanks as usual to everyone who

  649.       submitted a bug report.

  650.   </li>

  651.   <li>We no longer use the <code>SYNTHETIC</code> attribute to label declarations

  652.       added by the aspectj compiler.  We were using this attribute in compliance

  653.       with <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/html/ClassFile.doc.html#80128">

  654.       the JVM Specification</a>; however, we've found that many tools expect

  655.       this attribute to only be used for the narrow purpose of implementing

  656.       Java's inner classes and that using it for other synthetic members can confuse

  657.       them.  This led to problems both

  658.       <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=649">with javap</a> and

  659.       <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=646">with javac</a>.

  660.   </li>

  661.   <li>Changes required adding runtime classes, so please compile and run using the latest 

  662.       <code>aspectjrt.jar</code>

  663.   </li>

  664. 

  665. </ul>

  666. 

  667. <h3><a name="1.0.2ajde">AJDE</a></h3>

  668. 

  669. <p align="left">This is a bug fix release only.  </p>

  670. 

  671. <ul>

  672.   <li>

  673. 

  674. <p align="left">Thanks to Dave Yost and Matt Drance for submitting the AJDE 

  675. patches for Mac OSX (context popup menus and keyboard shortcuts did not work).  </p>

  676. 

  677.   </li>

  678.   <li>

  679. 

  680. <p align="left">Bugs in history navigation (back-forward buttons in the 

  681. structure view) have been fixed.</p>

  682. 

  683.   </li>

  684.   <li>

  685. 

  686. <p align="left">"Declares" are now handled properly in the structure view.</p>

  687. 

  688.   </li>

  689.   <li>

  690. 

  691. <p align="left">Other GUI and usability improvements have been made the AspectJ 

  692. Browser and core framework.</p>

  693. 

  694.   </li>

  695. </ul>

  696. 

  697. <h4>AJDE for JBuilder</h4>

  698. 

  699. 

  700. <ul>

  701.   <li>Support has been extended to JBuilder 6, and support for Enterprise 

  702.   version features has been improved.</li>

  703.   <li>Fixed bug causing inline source code annotations in the editor pane to not 

  704.   be updated after a recompile.</li>

  705.   <li>Keyboard shortcuts were fixed to work with Mac OSX.</li>

  706. </ul>

  707. 

  708. 

  709. <h4>AJDE for Forte</h4>

  710. 

  711. 

  712. <ul>

  713.   <li>Keyboard shortcuts were fixed to work with Mac OSX.</li>

  714. </ul>

  715. 

  716. <h4><a name="1.0.2ajdb">AJDB</a></h4>

  717. 

  718. <p> Some minor bug fixes, but this is still early-access software.

  719.     Please try using another JPDA-compliant debugger.  If it uses

  720.     JDI correctly, then it should navigate to line numbers 

  721.     when the classes are run under J2SE1.4, based on

  722.     the new JSR-45 debugging support described above.

  723.     We would appreciate any reports of success or failure.

  724. </p>

  725. 

  726. <hr />

  727. 

  728. <h2><a name="1.0.1">1.0.1</a></h2>

  729. 

  730. <ul>

  731.   <li><a href="#1.0.1compiler">Compiler</a></li>

  732.   <li><a href="#1.0.1ajde">AJDE</a></li>

  733.   <li><a href="#1.0.1ajdb">AJDB</a></li>

  734. </ul>

  735. 

  736. <h3><a name="1.0.1compiler">Compiler</a></h3>

  737. 

  738. <p> This release fixes a significant performance issue in the

  739. compiler, reported by Rich Price, that could lead to extremely long

  740. compiles in systems with many aspects and classes.  Several other

  741. small bugs related to reporting compilation errors have also been

  742. fixed, see <a

  743. href=http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=610>this

  744. bug report</a> for an example.

  745. </p>

  746. 

  747. <p> A new experimental flag has been added,

  748. <code>-XaddSafePrefix</code>, that will cause the prefix

  749. <code>aspectj$</code> to be inserted in front of all methods generated

  750. by ajc.  This mode should be helpful when using aspectj with tools

  751. that do reflection based on method names, such as EJB tools.  Thanks

  752. to Vincent Massol for pointing out the importance of this.  It is

  753. expected that this prefix will either become the default compiler

  754. behavior in the future or a non-experimental flag will replace it.

  755. </p>

  756. 

  757. 

  758. <h3><a name="1.0.1ajde">AJDE</a></h3>

  759. 

  760. <p align="left">Minor bug fixes, including: AJDE for JBuilder failed to preserve 

  761. application parameters from project settings when executing the application.</p>

  762. 

  763. <p align="left">Source builds were cleaned up for JBuilder and Forte sources.</p>

  764. 

  765. <h3><a name="1.0.1ajdb">AJDB</a></h3>

  766. 

  767. <p>Two bugs were reported and have been fixed in this release. 

  768.    (Note that ajdb is still considered early-access software.)</p>

  769. 

  770. <ul>

  771.   <li>bug 611: NullPointerException dumping non-primitive values</li>

  772.   <li>bug 617: -X and -D options not passed to debug VM correctly</li>

  773. </ul>

  774. 

  775. <h2><a name="1.0.0">1.0.0</a></h2>

  776. 

  777. <ul>

  778.   <li><a href="#1.0.0language">Language</a></li>

  779.   <li><a href="#1.0.0compiler">Compiler</a></li>

  780.   <li><a href="#1.0.0ajde">AJDE</a></li>

  781.   <li><a href="#1.0.0ajdoc">AJDoc</a></li>

  782.   <li><a href="#1.0.0taskdefs">Ant taskdefs</a></li>

  783. </ul>

  784. 

  785. <h2><a name="1.0.0language">Language</a></h2>

  786. 

  787. <p>There were no language changes for this release.</p>

  788. 

  789. <h2><a name="1.0.0compiler">Compiler</a></h2>

  790. 

  791. <p>Several minor bugs primarily in error handling were reported and

  792. have been fixed in this release.  The two most serious bugs are

  793. described below:</p>

  794. 

  795. <ul>

  796.   <li>Niall Smart and Stephan Schmidt reported related bugs (variants

  797.   of which are also produced by other compilers) that caused verify

  798.   errors when dealing with nested try-finally and synchronized

  799.   statements.  These are now fixed.  More details are available

  800.   <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=601">

  801.   here</a> and

  802.   <a href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=595">

  803.   here</a>

  804.   </li>

  805. 

  806.   <li>Jan Hannemann submitted a <a

  807.   href="http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=600">

  808.   succint and clear bug report</a> for a difficult intermittant bug.

  809.   The bug led to the compiler sometimes generating illegal code when

  810.   introduced methods on a class overrode introduced methods on an

  811.   interface implemented by that class.  This is now fixed.</li> </ul>

  812. 

  813. <h2><a name="1.0.0ajde">AJDE</a></h2>

  814. 

  815. <p align="left">Numerous user interface refinements were made to the browser and 

  816. core AJDE functionality.  Error handling and reporting has been improved.  

  817. All of the AJDE tools now support the ".aj" file extension.</p>

  818. 

  819. <h4>AJDE for JBuilder</h4>

  820. 

  821. 

  822. <ul>

  823.   <li>The AspectJ Browser now uses JBuilder's icons and distinguishes nodes by 

  824.   visibility.</li>

  825.   <li>Project-setting VM parameters are now supported by the "AJDE Run" button.</li>

  826. </ul>

  827. 

  828. 

  829. <h4>AJDE for Forte</h4>

  830. 

  831. 

  832. <ul>

  833.   <li>The AspectJ Browser now uses Forte's icons and distinguishes nodes by 

  834.   visibility</li>

  835. </ul>

  836. 

  837. 

  838. <h4>AJBrowser</h4>

  839. 

  840. 

  841. <ul>

  842.   <li>Documentation for the browser is now available at

  843.   <a href="http://aspectj.org/docs">http://aspectj.org/docs</a> </li>

  844. </ul>

  845. 

  846. 

  847. <h4>Emacs Support: aspectj-mode and AJDEE</h4>

  848. 

  849. <ul>

  850.   <li>Improved updating of annotations during editing.</li>

  851.   <li>Pop-up jump menu now placed (with mouse pointer) near cursor.</li>

  852.   <li>[AJDEE only] Improved filtering of legal code completions.</li>

  853. </ul>

  854. 

  855. <h4><a name="1.0.0ajdoc">AJDoc</a></h4>

  856. 

  857. <ul>

  858.   <li>Runs only in J2SE 1.3 - not 1.2 or 1.4.  

  859.       You can document 1.x-reliant programs by using the options

  860.       to compile using 1.x libraries.</li>

  861.   <li>Disabled some non-functioning options, documented as 

  862.       <code>unsupported</code> in the syntax message.</li>

  863. </ul>

  864. 

  865. <h4><a name="1.0.0taskdefs">Ant taskdefs</a></h4>

  866. <ul>

  867.   <li>Fork is not supported in the AJDoc taskdef</li>

  868. </ul>

  869. 

  870. <h2><a name="1.0rc3">1.0rc3</a></h2>

  871. 

  872. <h2><a name="1.0rc3language">Language</a></h2>

  873. 

  874. <p>There have been several minor clarifications/changes to the

  875. language.</p>

  876. 

  877. <ul>

  878.   <li>Thanks to Robin Green for suggesting that we could relax the

  879.   rules for inheriting multiple concrete members in order to allow

  880.   those unambiguous cases where one member has already overridden the

  881.   other.  <a href=http://aspectj.org/pipermail/users/2001/001289.html>

  882.   More details...</a></li>

  883. 

  884.   <li>Ron Bodkin encouraged us to examine the details of privileged

  885.   aspects more closely.  This led to several small improvements and

  886.   clarifications to this language feature.

  887.   <a href=http://aspectj.org/pipermail/users/2001/001258.html> More

  888.   details...</a></li>

  889. </ul>

  890. 

  891. <h2><a name="1.0rc3compiler">Compiler</a></h2>

  892. 

  893. <p>This release saw several changes to the compiler in order to

  894. work-around known bugs in different JVMs, or to otherwise mimic the

  895. behavior of javac rather than necessarily following the Java Language

  896. Specification.</p>

  897. 

  898. <ul>

  899.   <li>Hanson Char reported a bug where ajc's correctly generated

  900.   bytecodes for some references to interface fields result in verify

  901.   errors on certain JVMs.  While this is a known bug in those JVMs,

  902.   we've modified ajc to be bug compatible with all the other Java

  903.   compilers out there to work-around this JVM bug.

  904.   <a href=http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=551>

  905.   More details...</a></li>

  906. 

  907.   <li>Frank Hunleth discovered a similar bug where ajc's correct

  908.   bytecodes could lead to essentially random method dispath due to a

  909.   bad bug in the 1.3.0 JVM from Sun.  Even though this bug was fixed

  910.   in the 1.3.1 and 1.2.2 JVMs, we have introduced the appropriate

  911.   work-around in ajc's code generation. <a

  912.   href=http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=580>More

  913.   details...</a></li>

  914. 

  915.   <li>Thomas Haug (as well as several other members of his group)

  916.   reported a problem with name binding where ajc was behaving

  917.   differently than javac.  This problem was resolved to come from a

  918.   class created by an obfuscator that conflicted with his package

  919.   names.  The JLS doesn't clearly specify which of these two behaviors

  920.   is correct.  Nevertheless, ajc has been changed to treat packages

  921.   more like javac does in order to minimize this sort of problem in

  922.   the future.  <a

  923.   href=http://aspectj.org/jitterbug/aspectj-bugs/resolved?id=574> More

  924.   details...</a></li>

  925. 

  926.   <li>Several "real" bugs in ajc were also reported and fixed.  Toby

  927.   Allsopp gets credit for reporting two of them.  The most interesting

  928.   of these bugs to me was his report that we just didn't support

  929.   qualified anonymous inner constructors.  This is a part of the Java

  930.   language that ajc has never supported over its almost 3 year

  931.   history.  We'd just noticed this ourselves when running the jacks

  932.   compiler test suite from the jikes group, and had added the feature

  933.   days before getting our first bug report for it not being

  934.   there.</li>

  935. </ul>

  936. 

  937. <h2><a name="1.0rc3ajde">AJDE</a></h2>

  938. 

  939. <ul>

  940.   <li>The structure view has been improved.  </li>

  941.   <li>Multiple user-configurable views are supported.</li>

  942.   <li>Structure tree filtering and ordering has been added.  </li>

  943.   <li>A split tree mode has been added to permit the navigation of multiple 

  944.   views on the same structure.  </li>

  945.   <li>The view can also be toggled between a file-based and a system-based mode 

  946.   which determines whether the root of the structure tree is the current file or 

  947.   the project root.  </li>

  948.   <li>The signatures of tree nodes have been improved and several new node 

  949.   associations are now navigable.  </li>

  950.   <li>A depth slider for controlling tree-expansion has been added.</li>

  951. </ul>

  952. 

  953. <h4>AJDE for JBuilder</h4>

  954. 

  955. 

  956. <ul>

  957.   <li>Changes:</li>

  958.   <li>Inline annotations support have been improved and made consistent with the 

  959.   structure tree (annotations only show up for intra-declaration structure).</li>

  960.   <li>The current structure view persists across IDE launches.</li>

  961.   <li>An enabled AJDE no longer slows down JBuilder shutdown.</li>

  962. </ul>

  963. 

  964. 

  965. <h4>AJDE for Forte</h4>

  966. 

  967. 

  968. <ul>

  969.   <li>Execution remembers main class.</li>

  970.   <li>The bug causing an error during a "Mode" and "Explorer" switch has been 

  971.   fixed.</li>

  972. </ul>

  973. 

  974. 

  975. <h4>AJBrowser</h4>

  976. 

  977. 

  978. <ul>

  979.   <li>AJBrowser is currently an undocumented demonstration application. To use 

  980.   it type: ajbrowser &lt;lst file1&gt; &lt;lst file2&gt; ...</li>

  981.   <li>Multiple source locations can be shown by selecting multiple nodes and 

  982.   right-clicking to select the "Display Sources" command.</li>

  983. </ul>

  984. 

  985. 

  986. <h4>Emacs Support: aspectj-mode and AJDEE</h4>

  987. 

  988. <ul>

  989.   <li>Numerous jump-menu improvements, including operation of pop-ups.</li>

  990.   <li>For AJDEE, compatibility with JDEE 2.2.9beta4. Also, fixes in completion,

  991.       ajdoc launch, and speedbar.</li>

  992. </ul>

  993. 

  994. <h3><a name="1.0rc3ajdoc">AJDoc</a></h3>

  995. 

  996. <p>Some of the more obvious NullPointerException bugs in Ajdoc were fixed, but

  997. Ajdoc does not implement all the functionality of Javadoc and has some bugs:</p>

  998. <ul>

  999.   <li>Split indexes do not work correctly</li>

  1000.   <li>Inner classes are not listed in indexes </li>

  1001.   <li>Synthetic methods are documented</li>

  1002.   <li>There is no package frame even when packages are specified on the command line</li>

  1003.   <li>-group option is not implemented</li>

  1004.   <li>-use targets are not all calculated correctly</li>

  1005.   <li>Exception information may not be printed for the @throws tag</li>

  1006.   <li>Verbose output should go to stderr, not stdout</li>

  1007.   <li>Extra links are generated (should be unlinked text) </li>

  1008. </ul>

  1009. <p>Further, Ajdoc has not been testing on variants of the J2SE (it uses javadoc classes).

  1010. 

  1011. <h3><a name="1.0rc3taskdefs">Ant taskdefs</a></h3>

  1012. <p>The Ajc taskdef was updated to support the new compiler options and the .aj extension,

  1013. and some NullPointerException bugs were fixed (thanks to Vincent Massol for a bug

  1014. report listing the line number of the fix).  The AJDoc cannot be run repeatedly

  1015. in a single Ant run, and has trouble loading the doclet unless the libraries

  1016. are installed in ${ant.home}/lib.

  1017. <p>

  1018. <hr />

  1019. <h2><a name="1.0rc2">1.0rc2</a></h2>

  1020. 

  1021.        <ul>

  1022.          <li><a href="#1.0rc2language">Language</a></li>

  1023.          <li><a href="#1.0rc2compiler">Compiler</a></li>

  1024.          <li><a href="#1.0rc2ajde">AJDE</a></li>

  1025.        </ul>

  1026. 

  1027. <h2><a name="1.0rc2language">Language</a></h2>

  1028. 

  1029. <p>There are no language changes in this release. This is a bug fix release 

  1030. only.</p>

  1031. 

  1032. <h2><a name="1.0rc2compiler">Compiler</a></h2>

  1033. 

  1034. <p>A bug in handling inner type names that conflict with enclosing

  1035. type names was fixed.  Many error messages were improved.</p>

  1036. 

  1037. <h2><a name="1.0rc2ajde">AJDE</a></h2>

  1038. 

  1039. <ul>

  1040.   <li>This is a bug fix release only.</li>

  1041. </ul>

  1042. 

  1043. <h4>AJDE for JBuilder</h4>

  1044. 

  1045. <ul>

  1046.   <li>Changes:<ul>

  1047.   <li>Fixed bug causing the output path to be ignored and .class files to be 

  1048.   generated into the JBuilder install's "bin" directory.</li>

  1049.   <li>Fixed bugs in Browser listener causing NullPointerExceptions to be thrown 

  1050.   if no node editor was present.</li>

  1051.   <li>Fixed bug permitting "-bcg" option to be passed to the compiler.</li>

  1052.   <li>Fixed bug preventing ajc from compiling all of the project source files 

  1053.   when automatic package discovery was on (JBuilder Proffessional and Enterprise 

  1054.   editions).</li>

  1055.   <li>If the "-preprocess" flag is used resulting source files will be placed in 

  1056.   the project's "Working directory".</li>

  1057. </ul>

  1058. 

  1059.   </li>

  1060.   <li>Limitations:<ul>

  1061.     <li>"Automatic package discovery" mode is not supported in this release.</li>

  1062.     <li>The debugger has not seen much use and it's stability and performance is 

  1063.   limited.</li>

  1064.   </ul>

  1065.   </li>

  1066. </ul>

  1067. 

  1068. <h4>AJDE for Forte</h4>

  1069. 

  1070. <ul>

  1071.   <li>Changes:<ul>

  1072.   <li>Moved the "AspectJ" menu into the "Tools" menu in order to make it less 

  1073.   intrusive.</li>

  1074.   <li>Added a "ctrl-alt-shift-F9" keyboard compile shortcut.</li>

  1075. </ul>

  1076. 

  1077.   </li>

  1078.   <li>Limitations:<ul>

  1079.     <li>Known bug: "Mode" switching is not supported in this version--you must 

  1080.     do all of your AspectJ work in the "Editing" mode. If you switch modes the 

  1081.     IDE has to be restarted for the AspectJ window to show again. Switching to a 

  1082.     different tab in the ProjectExplorer has the same effect.</li>

  1083.     <li>The debugger has not seen much use and it's stability and performance is 

  1084.   limited.</li>

  1085.   </ul>

  1086.   </li>

  1087. </ul>

  1088. 

  1089. <h4>AJBrowser</h4>

  1090. 

  1091. <ul>

  1092.   <li>Changes:<ul>

  1093.   <li>...</li>

  1094. </ul>

  1095. 

  1096.   </li>

  1097.   <li>Limitations:<ul>

  1098.   <li>AJBrowser is currently an undocumented demonstration application. To use 

  1099.   it type:<br>

  1100.   &gt; ajbrowser &lt;lst file1&gt; &lt;lst file2&gt; ...</li>

  1101. </ul>

  1102. 

  1103.   </li>

  1104. </ul>

  1105. 

  1106. <h4>Emacs Support: aspectj-mode and AJDEE</h4>

  1107. 

  1108. <p align="left">  This release now properly displays annotations for call sites and

  1109.   introductions.  Robustness has been improved in several dimensions,

  1110.   including performance at startup.  The compile menu now recomputes

  1111.   properly when changing directories.</p>

  1112. 

  1113. <hr />

  1114. 

  1115. <h2><a name="1.0rc1">1.0rc1</a></h2>

  1116. 

  1117.        <ul>

  1118.          <li><a href="#1.0rc1language">Language</a></li>

  1119.          <li><a href="#1.0rc1compiler">Compiler</a></li>

  1120.          <li><a href="#1.0rc1ajde">AJDE</a></li>

  1121.        </ul>

  1122. 

  1123. <h2><a name="1.0rc1language">Language</a></h2>

  1124. 

  1125. <p>Some of the details of the specification for perthis and pertarget

  1126. have changed.  These changes make these language constructs

  1127. implementable on current JVMs without memory leaks (this wasn't true

  1128. of the previous version).  Most people will probably not notice these

  1129. changes, but the correct semantics are described in

  1130. <a href="progguide/semantics.html">the semantics section of the programming

  1131. guide</a>.

  1132. </p>

  1133. 

  1134. <p>In a related change, aspects are not allowed to implement either

  1135. the <code>java.io.Serializable</code> or the

  1136. <code>java.lang.Cloneable</code> interface.  It is unclear what the

  1137. correct behavior of a system should be when an aspect is serialized or

  1138. cloned, and rather than make an arbitrary choice right now we've

  1139. chosen to leave the most room to design them right in a future

  1140. release.</p>

  1141. 

  1142. <h2><a name="1.0rc1compiler">Compiler</a></h2>

  1143. 

  1144. <p>ajc now directly generates .class files without using javac as a

  1145. back-end.  This should result in improved compiler performance, better

  1146. error messages and better stack-traces and debugging info in those

  1147. .class files.  -preprocess mode is still available for those who want

  1148. to generate legal Java source code and a new -usejavac mode is

  1149. available if you have a requirement to continue to use javac as a

  1150. back-end.</p>

  1151. 

  1152. <p>ajc now officially supports source files with the .aj extension.

  1153. We plan to extend this support to the rest of our tools as time

  1154. permits.

  1155. </p>

  1156. 

  1157. <p>This release of ajc includes support for the "-source 1.4" option

  1158. that enables the new 'assert' keyword in jdk1.4.  This option only

  1159. works correctly when compiling against the jdk1.4 libraries.  In

  1160. addition, this release of ajc will run under SUN's jdk1.4beta2.

  1161. However, we still strongly recommend that most users use the non-beta

  1162. jdk1.3.</p>

  1163. 

  1164. <h2><a name="1.0rc1ajde">AJDE</a></h2>

  1165. 

  1166. <ul>

  1167.   <li>The structure view can now be configured (using the "Options" dialog) to

  1168.   display different kinds of associations between program elements that appear

  1169.   in the tree.</li>

  1170.   <li>Structure view history navigation has been added. </li>

  1171.   <li>When navigating links the structure view will stay synchronized with the

  1172.   editor.</li>

  1173. </ul>

  1174. 

  1175. <h4>AJDE for JBuilder</h4>

  1176. 

  1177. <ul>

  1178.   <li>Changes:<ul>

  1179.   <li>Inline structural navigation annotations appear in the gutter of the

  1180.   editor and can be used to navigate associations such as advice and

  1181.   introduction.</li>

  1182. </ul>

  1183. 

  1184.   </li>

  1185.   <li>Limitations:<ul>

  1186.     <li>"Automatic package discovery" mode is not supported in this release.</li>

  1187.     <li>The debugger has not seen much use and it's stability and performance is

  1188.   limited.</li>

  1189.   </ul>

  1190.   </li>

  1191. </ul>

  1192. 

  1193. <h4>AJDE for Forte</h4>

  1194. 

  1195. <ul>

  1196.   <li>Changes:<ul>

  1197.   <li>Support for Forte 3 and Netbeans 3.2 has been added.</li>

  1198.   <li>The module is now installed by default on the first use without having to

  1199.   go to the IDE options to enable it.</li>

  1200. </ul>

  1201. 

  1202.   </li>

  1203.   <li>Limitations:<ul>

  1204.     <li>Known bug: "Mode" switching is not supported in this version--you must

  1205.     do all of your AspectJ work in the "Editing" mode. If you switch modes the

  1206.     IDE has to be restarted for the AspectJ window to show again. Switching to a

  1207.     different tab in the ProjectExplorer has the same effect.</li>

  1208.     <li>The debugger has not seen much use and it's stability and performance is

  1209.   limited.</li>

  1210.   </ul>

  1211.   </li>

  1212. </ul>

  1213. 

  1214. <h4>AJBrowser</h4>

  1215. 

  1216. <ul>

  1217.   <li>Changes:<ul>

  1218.   <li>Build configuration file editor added.</li>

  1219. </ul>

  1220. 

  1221.   </li>

  1222.   <li>Limitations:<ul>

  1223.   <li>AJBrowser is currently an undocumented demonstration application. To use

  1224.   it type:<br>

  1225.   &gt; ajbrowser &lt;lst file1&gt; &lt;lst file2&gt; ...</li>

  1226. </ul>

  1227. 

  1228.   </li>

  1229. </ul>

  1230. 

  1231. <h4>Aspectj-mode and AJDEE: AspectJ support in Emacs</h4>

  1232. 

  1233. <p align="left">This release of AspectJ support for Emacs includes corrections to the

  1234. documentation and the appearance of annotations and jumps in the editing

  1235. view.  Also, advice are now shown on non-declarations, when appropriate,

  1236. such as call advice.  The internal event model has been revised to reduce

  1237. computational overhead. </p>

  1238. 

  1239. <hr />

  1240. 

  1241. <h2><a name="1.0beta1">1.0beta1</a></h2>

  1242. 

  1243. <ul>

  1244.   <li><a href="#1.0beta1language">Language</a></li>

  1245.   <li><a href="#1.0beta1compiler">Compiler</a></li>

  1246.   <li><a href="#1.0beta1ajbrowser">AJBrowser</a></li>

  1247.   <li><a href="#1.0beta1ajde">AJDE</a></li>

  1248. </ul>

  1249. 

  1250. <h2><a name="1.0beta1language">Language</a></h2>

  1251. 

  1252. <p>There is one language change since 1.0alpha1.  The static modifier is

  1253. no longer needed or allowed on pointcut declarations.  Name binding

  1254. for pointcut declarations works like class methods now.  Thanks to

  1255. Robin Green for encouraging us to look at this one last time.</p>

  1256. 

  1257. <p>The current implementation of perthis/pertarget has the possibility of

  1258. memory leaks (thanks to Arno Schmidmeier for pointing this out).  The

  1259. design of this part of the language will almost certainly see some

  1260. changes in the next release to address issues of implementability on

  1261. the JVM as well as related issues.</p>

  1262. 

  1263. <h2><a name="1.0beta1compiler">Compiler</a></h2>

  1264. 

  1265. <p>The ajc compiler should now catch all errors in source code and you

  1266. should no longer see errors coming from files in 'ajworkingdir'.

  1267. Please report any errors in 'ajworkingdir' as bugs.</p>

  1268. 

  1269. <p>All reported bugs in 1.0alpha1 have been fixed.  Thanks to everyone

  1270. for your bug reports.  Most notably, the 'if' pcd that was added in

  1271. 1.0alpha1 should work correctly in this release.  Thanks to Morgan

  1272. Deters for a very thorough bug report on this broken feature days

  1273. after the 1.0alpha1 release.</p>

  1274. 

  1275. <h2><a name="1.0beta1ajbrowser">AJBrowser</a></h2>

  1276. 

  1277. <ul>

  1278.   <li>Support for executing classes has been added.</li>

  1279.   <li>.lst can now be passed as arguments on the command line.</li>

  1280.   <li>Compiler options can be set.</li>

  1281.   <li>Know limitations:<ul>

  1282.     <li>In order to execute classes they must be available on the classpath that

  1283.     the browser is launched with.</li>

  1284.   </ul>

  1285.   </li>

  1286. </ul>

  1287. 

  1288. <h2><a name="1.0beta1ajde">AJDE</a></h2>

  1289. 

  1290. <ul>

  1291.   <li>The performance and UI of the structure tree has been improved.</li>

  1292.   <li>Compilation now runs in a separate thread and a progress monitor is

  1293.   updated during the compile.</li>

  1294.   <li>The structure view now persists across IDE launches.</li>

  1295.   <li>Limitations:<ul>

  1296.   <li>If an error occurs in the javac pass it will not display properly in the

  1297.   error messages pane.  To view the error you have check the output of the

  1298.   console that the IDE was launched from.  No more errors should be passed

  1299.   to javac, so please report this behavior and the corresponding error message

  1300.   as a bug.</li>

  1301. </ul>

  1302. 

  1303.   </li>

  1304. </ul>

  1305. 

  1306. <h4>AJDE for JBuilder</h4>

  1307. 

  1308. <ul>

  1309.   <li>Known bugs have been fixed.</li>

  1310.   <li>Classpath separator character is no longer hardcoded.</li>

  1311.   <li>Keyboard shortcuts for compilation (ctrl-F11) and execution (ctrl-F12)

  1312.   have been added.</li>

  1313.   <li>Limitations:<ul>

  1314.     <li>The debugger has not seen much use and it's stability and performance is

  1315.   limited.</li>

  1316.   </ul>

  1317.   </li>

  1318. </ul>

  1319. 

  1320. <h4>AJDE for Forte</h4>

  1321. 

  1322. <ul>

  1323.   <li>Known bugs have been fixed.</li>

  1324.   <li>Limitations:<ul>

  1325.     <li>"Mode" switching is not supported in this version--you must do all of your

  1326.   AspectJ work in the "Editing" mode.  If you switch modes the IDE has to

  1327.   be restarted for the AspectJ window to show again.</li>

  1328.     <li>There are no keyboard compile/execute shortcuts.</li>

  1329.     <li>The debugger has not seen much use and it's stability and performance is

  1330.   limited.</li>

  1331.   </ul>

  1332.   </li>

  1333. </ul>

  1334. 

  1335. <h4>Aspectj-mode and AJDEE: AspectJ support in Emacs</h4>

  1336. 

  1337. <p> AspectJ Development Environment for Emacs has been split into two pieces,

  1338. aspectj-mode (an extension of java-mode), and AJDEE (an extension of JDE).

  1339. Additionally, a switch, -emacssym, has been added to ajc that generates

  1340. AspectJ declarations information directly, thus beanshell is no longer

  1341. required for use of these modes.

  1342. </p>

  1343. 

  1344. <hr />

  1345. 

  1346. <h2><a name="1.0alpha1">1.0alpha1</a></h2>

  1347. 

  1348. <p> This is the first alpha release of the 1.0 language and tools.

  1349. There have been many changes in the language, and many improvements to

  1350. the tools.  We wish to thank our users for putting up with the high

  1351. volatility of AspectJ in the push to 1.0. </p>

  1352. 

  1353.       <ul>

  1354.          <li><a href="#1.0alpha1language">Language</a></li>

  1355.          <li><a href="#1.0alpha1compiler">Compiler</a></li>

  1356.          <li><a href="#1.0alpha1documentation">Documentation</a></li>

  1357.          <li><a href="#1.0alpha1ajdoc">AJDoc</a></li>

  1358.          <li><a href="#1.0alpha1ant">Ant</a></li>

  1359.          <li><a href="#1.0alpha1ajbrowser">AJBrowser</a></li>

  1360.          <li><a href="#1.0alpha1ajde">AJDE</a></li>

  1361.        </ul>

  1362. 

  1363. <h3><a name="1.0alpha1language">Language</a></h3>

  1364. 

  1365. <p> There have been many changes to make the 1.0 language both simpler

  1366. and more powerful.  User feedback has driven most of these design

  1367. changes.  Each email we've received either making a suggestion or just

  1368. asking a question about a confusing part of the language has played a

  1369. part in shaping this design.  We'd like to thank all of our users for

  1370. their contributions.

  1371. 

  1372. <p>While we don't have room to thank all of our users by name, we'd

  1373. like to specifically mention a few people for their high-quality

  1374. sustained contributions to the users@aspectj.org mailing list as well

  1375. as through their feature requests and bug reports.  Robin Green

  1376. (who'll be very happy to see <code>declare error</code>), Stefan

  1377. Hanenberg (who should appreciate the '+' wildcard in type patterns),

  1378. and Rich Price (who suggested final pointcuts, more flexible

  1379. dominates, and many other improvements).<p>

  1380. 

  1381. <p> Note that entries into the <a href="porting.html">porting

  1382. notes</a> for this release are linked from the various language

  1383. changes.  </p>

  1384. 

  1385. <h4>Pointcuts</h4>

  1386. 

  1387. <p> Perhaps the least interesting -- but most pervasive -- change is

  1388. that the names of the single-kinded pointcut designators (the ones

  1389. that pick out only one kind of join point) </p>

  1390. 

  1391. <blockquote>calls executions gets sets handlers initializations

  1392. staticinitializations</blockquote>

  1393. 

  1394. <p> have been

  1395. <a href="porting.html#1.0a1-plural-to-singular">changed</a> to be

  1396. singular rather than plural nouns </p>

  1397. 

  1398. <blockquote>call execution get set handler initialization

  1399. staticinitialization</blockquote>

  1400. 

  1401. <p> Although a side benefit is that the names are one character

  1402. shorter, the real benefit is that their combination with the

  1403. <CODE>&amp;&amp;</CODE> and <code>||</code> operators now reads much

  1404. more naturally.  No longer does "and" mean "or" and "or" mean "and".

  1405. </p>

  1406. 

  1407. <p> You'll notice that <code>receptions</code> doesn't appear on the

  1408. table as being shortened to <code>reception</code>.  That's because

  1409. call and reception join points have been merged, and the

  1410. <code>receptions</code> pointcut declaration has been

  1411. <a href="porting.html#1.0a1-remove-receptions">eliminated</a>.  Now,

  1412. <code>call</code> join points describe the action of making a call,

  1413. including both the caller and callee.  Eliminating reception join

  1414. points makes AspectJ much simpler to understand (reception join points

  1415. were a commonly misunderstood feature) without giving up expressive

  1416. power.</p>

  1417. 

  1418. <p> We have <a href="porting.html#1.0a1-fixing-state-access">changed

  1419. the mechanism for accessing state</a> at join points, which has the

  1420. benefit of making our treatment of signatures

  1421. <a href="porting.html#1.0a1-no-subs-in-sigs">cleaner</a> and easier to

  1422. read.  As a part of this, the <code>instanceof</code> pointcut

  1423. designator has now been

  1424. <a href="porting.html#1.0a1-fixing-instanceof">split into two

  1425. different pointcut designators</a>, <code>this</code> and

  1426. <code>target</code>, corresponding to a join point's currently

  1427. executing object and target object, respectively.  </p>

  1428. 

  1429. <p> The new <code>args</code> pointcut adds expressive power to the

  1430. language by allowing you to capture join points based on the actual

  1431. type of an argument, rather than the declared type of its formal.  So

  1432. even though the <code>HashSet.removeAll</code> method takes a

  1433. <code>Collection</code> as an argument, you can write advice that only

  1434. runs when it is actually passed a <code>HashSet</code> object. </p>

  1435. 

  1436. <p> AspectJ's notion of object construction and initialization, a

  1437. complicated process in Java, has been clarified.  This affects some

  1438. uses of the

  1439. <a href="porting.html#1.0a1-initializations">initializations

  1440. pointcut</a> and

  1441. <a href="porting.html#1.0a1-constructor-calls">constructor calls</a>

  1442. pointcut.  </p>

  1443. 

  1444. <p> The little-used pointcuts

  1445. <a href="porting.html#1.0a1-hasaspect"><code>hasaspect</code></a> and

  1446. <a href="porting.html#1.0a1-withinall"><code>withinall</code></a> have

  1447. been removed. </p>

  1448. 

  1449. <p> The <code>returns</code> keyword is

  1450. <a href="porting.html#1.0a1-user-defined-returns">no longer

  1451. necessary</a> for user-defined pointcuts.  </p>

  1452. 

  1453. <p> Pointcuts may now be declared <code>static</code>, and

  1454. <a href="porting.html#1.0a1-static-pointcuts">only static

  1455. pointcuts</a> may be declared in classes and referred to with

  1456. qualified references (such as <code>MyAspect.move()</code>).  </p>

  1457. 

  1458. <p> Non-abstract pointcuts may now be declared <code>final</code>.

  1459. </p>

  1460. 

  1461. <p> We have finally added an extremely general pointcut,

  1462. <code>if(<var>BooleanExpression</var>)</code>, that picks out

  1463. join points programatically.  </p>

  1464. 

  1465. 

  1466. <h4>Type patterns</h4>

  1467. 

  1468. <p> Our treatment of

  1469. <a href="porting.html#1.0a1-new-wildcards">* and ..</a> in type

  1470. patterns is cleaner.  </p>

  1471. 

  1472. <p> Type patterns now have the ability to include array types, and

  1473. there is a new wildcard, +, to pick out all subtypes of a given type.

  1474. Previously, the subtypes operator was only allowed in introduction,

  1475. and was <a href="porting.html#1.0a1-subtypes-to-plus">spelled

  1476. differently</a>.  </p>

  1477. 

  1478. <h4>Advice</h4>

  1479. 

  1480. <p> Around advice is treated much more like a method, with a

  1481. <a href="porting.html#1.0a1-around-returns">return value</a> and an

  1482. optional <a href="porting.html#1.0a1-around-throws">throws clause</a>.

  1483. </p>

  1484. 

  1485. <p> The advice precedence rules have been

  1486. <a href="porting.html#1.0a1-advice-precedence">changed</a>.  Now, for

  1487. example, a piece of after advice that appears lexically later than

  1488. another piece of after advice will run later, as well.  Previously,

  1489. the relationship was the other way around, which caused no small

  1490. amount of confusion.  </p>

  1491. 

  1492. <p> After returning advice has lost a

  1493. <a href="porting.html#1.0a1-after-returning">useless set of

  1494. parentheses</a> when not using the return value. </p>

  1495. 

  1496. <p> The <code>thisStaticJoinPoint</code> reflective object has been

  1497. <a href="porting.html#1.0a1-this-static-join-point">renamed</a>, and

  1498. the <code>thisJoinPoint</code> object hierarchy has been

  1499. <a href="porting.html#1.0a1-this-join-point">simplified</a>.  </p>

  1500. 

  1501. <h4>Introduction and static crosscutting</h4>

  1502. 

  1503. <p> On the static side of the language, introduction hasn't changed,

  1504. but there is now a new keyword, <code>declare</code>, that is used to

  1505. declare various statically-crosscutting properties.  One of these

  1506. properties is subtyping, so we've

  1507. <a href="porting.html#1.0a1-plus-implements-extends">gotten rid of</a>

  1508. the ugly keywords <code>+implements</code> and

  1509. <code>+extends</code>. </p>

  1510. 

  1511. <p> We have provided two new forms, <code>declare error</code> and

  1512. <code>declare warning</code>, for the often-asked-for property of

  1513. compile-time error detection based on crosscutting properties. </p>

  1514. 

  1515. <p> AspectJ's interaction with checked exceptions is now firmly on the

  1516. side of static crosscutting, since Java treats such exceptions at

  1517. compile-time. A new form, <code>declare soft</code>, can be used to

  1518. "soften" checked exceptions into an unchecked form.  This may affect

  1519. some uses of <a href="porting.html#1.0a1-now-use-soft">around

  1520. advice</a> that previously mucked with the exception checking

  1521. system.</p>

  1522. 

  1523. <h4>Aspects</h4>

  1524. 

  1525. <p> The "of each" modifiers have been

  1526. <a href="porting.html#1.0a1-aspects">renamed</a>.  Apart from the

  1527. spelling, the main interesting difference is the splitting up of

  1528. <code>of eachobject</code> into two different modifiers, parallel with

  1529. the split of <code>instanceof</code> into <code>this</code> and

  1530. <code>target</code>.  </p>

  1531. 

  1532. <p> The <code>dominates</code> keyword now takes a type pattern,

  1533. rather than a type.  This allows an aspect A, for example, to declare

  1534. that its advice should dominate the advice of another aspect B as well

  1535. as its subtypes, with the new + subtypes operator: <code>aspect A

  1536. dominates B+</code>.

  1537. </p>

  1538. 

  1539. <h3><a name="1.0alpha1compiler">Compiler</a></h3>

  1540. 

  1541. <p> The most important change in the compiler is that it supports the

  1542. new language.  In addition, all reported bugs in the last release have

  1543. been fixed.  Thanks for your bug reports.</p>

  1544. 

  1545. <p>The compiler also gets a new <code>-encoding</code> flag in this

  1546. release for handling source files that are not in standard US-ASCII

  1547. format.  Thanks to Nakamura Tadashi for both suggesting this feature

  1548. and for submitting a nice patch to implement it.

  1549. 

  1550. <h4>Known Limitations</h4>

  1551. 

  1552. <p> The previous compiler's limitations regarding join points that

  1553. occurred in anonymous classes have all been eliminated.

  1554. Unfortunately, eliminating this restriction has resulted in

  1555. preprocessed source code that is less readable than in previous

  1556. releases.  More care will be taken in the next release to mitigate

  1557. this effect.  </p>

  1558. 

  1559. <p> Many semantic errors are not caught by ajc but fall through to

  1560. javac.  Moreover, some errors regarding the initialization of final

  1561. fields might never show up when using ajc.  This will be fixed

  1562. shortly.  </p>

  1563. 

  1564. 

  1565. <h3><a name="1.0alpha1documentation">Documentation</a></h3>

  1566. 

  1567. <p> Although we spent much of our time this release cycle updating the

  1568. documentation to the new language rather than improving its content,

  1569. we did make some structural improvements.  The old <cite>Primer</cite> has been

  1570. split into a <cite>Programming Guide</cite>, covering the language, and a

  1571. <cite>Development Environment Guide</cite>, covering the develompent tools.  In

  1572. addition, printable versions of both guides (in PDF) are finally

  1573. included in the documentation package.  </p>

  1574. 

  1575. <h3><a NAME="1.0alpha1ajdoc">Ajdoc</a></h3>

  1576. 

  1577. <p> Ajdoc was rewritten to conform with the language changes and provide support

  1578. for other AspectJ/Java compilers.  Our doclet is used by default creating

  1579. AspectJ-specific documentation, or Sun's standard doclet can be used by

  1580. passing the '-standard' flag to Ajdoc to produce regular Javadoc documentation

  1581. (excluding AspectJ-specifics).

  1582. </p>

  1583. 

  1584. <h3><a NAME="1.0alpha1ant">Ant</a></h3>

  1585. 

  1586. <p> An Ajdoc task is now available.  The Ajc ant task was improved to

  1587. be completely back-compatible with the Javac task.</p>

  1588. 

  1589. <h3><a NAME="1.0alpha1ajbrowser">AJBrowser</a></h3>

  1590. 

  1591. <p> The "AspectJ Browser" is a new standalone source code browsing application.

  1592. It will let you compile ".lst" files, view the structure for those files and

  1593. navigate the corresponding source code.</p>

  1594. 

  1595. <h3><a name="1.0alpha1ajde">AJDE</a></h3>

  1596. 

  1597. <h4>AJDE for JBuilder</h4>

  1598. 

  1599. <h5>Installation</h5>

  1600. <ul>

  1601.   <li>Use the installer to place the "ajdeForJBuilder.jar" and "aspectjrt.jar"

  1602.   in to JBuilder's lib/ext directory.</li>

  1603. </ul>

  1604. 

  1605. <h5>Key Improvements</h5>

  1606. 

  1607. <ul>

  1608.   <li>The "AspectJ Structure View" replaces JBuilder's structure view instead of

  1609.   being launched in a separate window.</li>

  1610.   <li>AJDE can be toggled on/off with the "AJ" button--when it is turned off all

  1611.   of the menus, resources, and event listeners that it uses will be removed.</li>

  1612.   <li>Projects no longer require the manual adding of the "aspectjrt.jar"

  1613.   libarary.</li>

  1614. </ul>

  1615. 

  1616. <h5>Known Bugs &amp; Limitations</h5>

  1617. 

  1618. <ul>

  1619.   <li>There is no compiler progress dialog--the way to tell if the compile is

  1620.   finished is to watch the "status" area of the main window.</li>

  1621.   <li>There are no keyboard compile/execute shortcuts.</li>

  1622.   <li>The structure view is not persistent between IDE launches--you must

  1623.   compile to view the structure for a program.</li>

  1624.   <li>The debugger has not seen much use and it's stability and performance is

  1625.   limited.</li>

  1626.   <li>There is no ajdoc tool support.</li>

  1627.   <li>Linux testing has been very limited.</li>

  1628. </ul>

  1629. 

  1630. 

  1631. <h4>AJDE for Forte</h4>

  1632. 

  1633. 

  1634. <h5>Installation</h5>

  1635. 

  1636. <ul>

  1637.   <li>Use the installer to place the "ajdeForForte.jar" in Forte's

  1638.   modules directory  and "aspectjrt.jar"

  1639.   in to Forte's lib/ext directory.</li>

  1640.   <li>

  1641.   In the "Tools" menu select "Global Options"</li>

  1642.   <li>

  1643.   Right-click the "Modules" item and select "New Module from

  1644.     File..."</li>

  1645.   <li>

  1646.   Find the ajdeForForte.jar in the directory that you installed into (e.g.

  1647.     c:\forte4j\modules) and

  1648.     select it.</li>

  1649. </ul>

  1650. 

  1651. <h5>Key Improvements</h5>

  1652. 

  1653. <ul>

  1654.   <li>AJDE can be toggled on/off with the "AJ" button--when it is turned off all

  1655.   of the menus, resources, and event listeners that it uses will be removed.</li>

  1656.   <li>The AJDE functionality is now contained within it's own toolbar and menu.</li>

  1657. </ul>

  1658. 

  1659. <h5>Known Bugs &amp; Limitations</h5>

  1660. 

  1661. <ul>

  1662.   <li>"Mode" switching is not supported in this version--you must do all of your

  1663.   AspectJ work in the "Editing" mode.  If you switch modes the IDE has to

  1664.   be restarted for the AspectJ window to show again.</li>

  1665.   <li>There is no compiler progress dialog--the way to tell if the compile is

  1666.   finished is to watch the "status" area of the main window.</li>

  1667.   <li>There are no keyboard compile/execute shortcuts.</li>

  1668.   <li>The structure view is not persistent between IDE launches--you must

  1669.   compile to view the structure for a program.</li>

  1670.   <li>The debugger has not seen much use and it's stability and performance is

  1671.   limited.</li>

  1672.   <li>There is no ajdoc tool support.</li>

  1673.   <li>Linux testing has been very limited.</li>

  1674. </ul>

  1675. 

  1676. <h4>AJDE for Emacs</h4>

  1677. 

  1678. <p> AspectJ-mode now includes a toggle in the AspectJ menu that

  1679. disables its intrusive functions, enabling easy switching between Java

  1680. and AspectJ projects.  See the README and CHANGES files in the

  1681. distribution for additional details.  </p>

  1682. 

  1683. <p> AJDEE is now compatible with JDEE 2.2.7.1, JDEE 2.2.8beta4, and speedbar

  1684. 0.14alpha.  It a toggle in the AspectJ menu that disables its intrusive

  1685. functions, enabling easy switching between Java and AspectJ projects.  See

  1686. the README and CHANGES files in the distribution for additional details.

  1687. </p>

  1688. 

  1689. 

  1690. <hr />

  1691. 

  1692. </body>

  1693. </html>