releasenotes120M3.html - gerrit/www.eclipse.org/ajdt - Git at Google

 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
 <title>AJDT Release Notes for 1.2.0M3</title>
 <link rel="stylesheet" href="http://www.eclipse.org/default_style.css" type="text/css">
 </head>
 <body bgcolor="#FFFFFF">

 <h2>AJDT Release Notes for 1.2.0M3</h2>

 <p>This document contains migration information and known
 limitations. It will be updated as necessary as any new problems and
 workarounds are discovered.</p>

 <p><i>Last updated: 13 April 2005.</i></p>

 <h3>Migration issues</h3>

 <p>It is easiest to install 1.2.0M3 with a new, empty workspace, and
 check-out your projects into that. However when that isn't possible or
 desirable, you can upgrade an existing workspace, as long as you are
 aware of the following issues.</p>

 <p><b>Open Editors.</b> The AspectJ Editor has a different Eclipse
 identifier in the 1.2.0 stream. This means that any files open with the editor from a
 1.1.x version of AJDT
 will not be restored after upgrading to 1.2.0M3, and you will get a
 "Problem restoring workbench layout" message about this. It is therefore
 recommended that you close all open editors before performing the
 upgrade.</p>

 <p><b>PDE Projects.</b> If you have AspectJ-enabled plugin projects
 from a 1.1.x version of AJDT,
 you need to change the dependency on the org.aspectj.ajde plugin to be
 org.aspectj.runtime instead. You can of course do this after
 performing the upgrade.</p>

 <p><b>Resource filters for .aj files.</b> If you have defined your own
 custom filter settings in the package explorer before installing 1.2.0M3,
 you will get a warning dialog about the ".aj resource filter" being disabled.
 If you see this please follow the instructions listed in the dialog, otherwise
 any .aj files will appear twice in the package explorer - once as compilation
 units and again as plain files.</p>

 <p><b>Outline and Cross References views.</b> The default mode in 1.2.0M3 is
 to use the standard outline view rather than the customized one
 that was used previously, and use the Cross References view to see crosscutting information.
 If you have existing projects built with any previous release of AJDT, you will
 need to rebuild these in order to see the new advice decorator in the outline view and the
 crosscutting information in the new view.  </p>

 <p><b>AspectJ code in ".java" files.</b> Most of the new functionality in 1.2.0M3 requires all
 AspectJ code to be contained in ".aj" files. Code in ".java" files should be pure Java code.
 There is a file extension conversion wizard to help with this process, which can be launched
 by right-clicking on a project or source file and selecting the appropriate option from the
 context menu.</p>

 <h3>Known limitations and workarounds</h3>

 <p><b>Supported versions of Eclipse.</b> This release of AJDT consists of a
 version for Eclipse 3.0 and one for Eclipse 3.1M6. It will not work properly
 on any other build of Eclipse 3.1.</p>

 <p><b>Moving .aj files within the package explorer.</b> Most files can
 be dragged to new locations within the package explorer, but
 unfortunately this isn't currently possible with .aj files.  You
 should however be able to copy and paste an .aj file to a new
 location. You can also drag and drop .aj files from the package
 explorer to applications outside of Eclipse, and back again.</p>

 <p><b>File conversion wizard with excluded inner aspects.</b> The
 default mode of this wizard converts source files containing aspects
 to .aj files. This includes Java classes which contain innner
 aspects. However inner aspects are currently only detected in classes
 which are included in the current build configuration. Therefore if
 you're using this mode of the wizard you are recommended to make sure
 any classes with inner aspects are first included in the current
 configuration.</p>

 <p><b>Organise imports with imported aspects.</b> This operation is
 possible for aspects contained in
 .aj files, but it isn't aware of imported aspects. So if your aspect
 is extending an abstract aspect which is in a different package, you
 need to import it. But running organise imports will not add it, and
 if it is there already, it will unhelpfully remove it! You can at
 least do an undo to get it back. Similiarly, the add import action
 will not work for imported aspects.</p>

 <p><b>Checking out AspectJ projects from CVS.</b> Previously, if you
 had Java projects which depend on AspectJ projects, and you checked
 out all of the projects from CVS, then the dependent Java projects
 would say that they can't be built until their prerequisite projects
 have been rebuilt. Rebuilding the AspectJ projects in this case does
 not fix the problem. This issue has been reported as bug <a
 href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=73435">73435</a>. This
 release contains a workaround for this problem, which is to detect
 this situation and then disable the Eclipse preference "Abort build
 when build path errors occur", which is located under Preferences &gt;
 Java &gt; Compiler &gt; Build Path. This results in both the AspectJ
 projects and the Java projects building. Note that if the dependent
 java projects use project settings rather than workspace settings,
 then it is these which are updated to not abort a build when there are
 classpath errors and you are able to revert your workspace settings
 without seeing the problem marker against your java projects. If you
 don't want your workbench settings to change, then converting your
 AspectJ projects to Java projects then back to AspectJ projects also
 solves this problem.  Note that this does not work on M6, so if you
 encounter this problem you can either change this setting manually
 or convert your AspectJ projects to Java projects and back. </p>

 <p><b>Cross References view.</b> The cross references view is a new
 contribution to AJDT and as such you may experience some problems.
 It is already known that 'declare soft' references are not shown. If you
 discover a bug please report it, if it has not already been reported, at
 <a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=AJDT">
 https://bugs.eclipse.org/bugs/enter_bug.cgi?product=AJDT</a></p>

 <p><b>Visualiser changes.</b> In this milestone the Visualiser requires
 you to have done a build before it can show any crosscutting - it
 does not persist the data between Eclipse sessions. The Visualiser also
 no longer supports aspects in .java files.</p>

 </body>
 </html>
	<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
	<html>
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
	<title>AJDT Release Notes for 1.2.0M3</title>
	<link rel="stylesheet" href="http://www.eclipse.org/default_style.css" type="text/css">
	</head>
	<body bgcolor="#FFFFFF">

	<h2>AJDT Release Notes for 1.2.0M3</h2>

	<p>This document contains migration information and known
	limitations. It will be updated as necessary as any new problems and
	workarounds are discovered.</p>

	<p><i>Last updated: 13 April 2005.</i></p>

	<h3>Migration issues</h3>

	<p>It is easiest to install 1.2.0M3 with a new, empty workspace, and
	check-out your projects into that. However when that isn't possible or
	desirable, you can upgrade an existing workspace, as long as you are
	aware of the following issues.</p>

	<p><b>Open Editors.</b> The AspectJ Editor has a different Eclipse
	identifier in the 1.2.0 stream. This means that any files open with the editor from a
	1.1.x version of AJDT
	will not be restored after upgrading to 1.2.0M3, and you will get a
	"Problem restoring workbench layout" message about this. It is therefore
	recommended that you close all open editors before performing the
	upgrade.</p>

	<p><b>PDE Projects.</b> If you have AspectJ-enabled plugin projects
	from a 1.1.x version of AJDT,
	you need to change the dependency on the org.aspectj.ajde plugin to be
	org.aspectj.runtime instead. You can of course do this after
	performing the upgrade.</p>

	<p><b>Resource filters for .aj files.</b> If you have defined your own
	custom filter settings in the package explorer before installing 1.2.0M3,
	you will get a warning dialog about the ".aj resource filter" being disabled.
	If you see this please follow the instructions listed in the dialog, otherwise
	any .aj files will appear twice in the package explorer - once as compilation
	units and again as plain files.</p>

	<p><b>Outline and Cross References views.</b> The default mode in 1.2.0M3 is
	to use the standard outline view rather than the customized one
	that was used previously, and use the Cross References view to see crosscutting information.
	If you have existing projects built with any previous release of AJDT, you will
	need to rebuild these in order to see the new advice decorator in the outline view and the
	crosscutting information in the new view. </p>

	<p><b>AspectJ code in ".java" files.</b> Most of the new functionality in 1.2.0M3 requires all
	AspectJ code to be contained in ".aj" files. Code in ".java" files should be pure Java code.
	There is a file extension conversion wizard to help with this process, which can be launched
	by right-clicking on a project or source file and selecting the appropriate option from the
	context menu.</p>

	<h3>Known limitations and workarounds</h3>

	<p><b>Supported versions of Eclipse.</b> This release of AJDT consists of a
	version for Eclipse 3.0 and one for Eclipse 3.1M6. It will not work properly
	on any other build of Eclipse 3.1.</p>

	<p><b>Moving .aj files within the package explorer.</b> Most files can
	be dragged to new locations within the package explorer, but
	unfortunately this isn't currently possible with .aj files. You
	should however be able to copy and paste an .aj file to a new
	location. You can also drag and drop .aj files from the package
	explorer to applications outside of Eclipse, and back again.</p>

	<p><b>File conversion wizard with excluded inner aspects.</b> The
	default mode of this wizard converts source files containing aspects
	to .aj files. This includes Java classes which contain innner
	aspects. However inner aspects are currently only detected in classes
	which are included in the current build configuration. Therefore if
	you're using this mode of the wizard you are recommended to make sure
	any classes with inner aspects are first included in the current
	configuration.</p>

	<p><b>Organise imports with imported aspects.</b> This operation is
	possible for aspects contained in
	.aj files, but it isn't aware of imported aspects. So if your aspect
	is extending an abstract aspect which is in a different package, you
	need to import it. But running organise imports will not add it, and
	if it is there already, it will unhelpfully remove it! You can at
	least do an undo to get it back. Similiarly, the add import action
	will not work for imported aspects.</p>

	<p><b>Checking out AspectJ projects from CVS.</b> Previously, if you
	had Java projects which depend on AspectJ projects, and you checked
	out all of the projects from CVS, then the dependent Java projects
	would say that they can't be built until their prerequisite projects
	have been rebuilt. Rebuilding the AspectJ projects in this case does
	not fix the problem. This issue has been reported as bug <a
	href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=73435">73435</a>. This
	release contains a workaround for this problem, which is to detect
	this situation and then disable the Eclipse preference "Abort build
	when build path errors occur", which is located under Preferences >
	Java > Compiler > Build Path. This results in both the AspectJ
	projects and the Java projects building. Note that if the dependent
	java projects use project settings rather than workspace settings,
	then it is these which are updated to not abort a build when there are
	classpath errors and you are able to revert your workspace settings
	without seeing the problem marker against your java projects. If you
	don't want your workbench settings to change, then converting your
	AspectJ projects to Java projects then back to AspectJ projects also
	solves this problem. Note that this does not work on M6, so if you
	encounter this problem you can either change this setting manually
	or convert your AspectJ projects to Java projects and back. </p>

	<p><b>Cross References view.</b> The cross references view is a new
	contribution to AJDT and as such you may experience some problems.
	It is already known that 'declare soft' references are not shown. If you
	discover a bug please report it, if it has not already been reported, at
	<a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=AJDT">
	https://bugs.eclipse.org/bugs/enter_bug.cgi?product=AJDT</a></p>

	<p><b>Visualiser changes.</b> In this milestone the Visualiser requires
	you to have done a build before it can show any crosscutting - it
	does not persist the data between Eclipse sessions. The Visualiser also
	no longer supports aspects in .java files.</p>

	</body>
	</html>