blob: cf4acffe6200053e864290083de6603a7e9b1b29 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<title>Eclipse Project Release Notes 3.7</title>
</head>
<body>
<h1>Eclipse Project Release Notes</h1>
<p>Release 3.7.1<br/>
Last revised Sep 23, 2011</p>
<p align="left"><strong>This software is OSI Certified Open Source Software.<br/>
OSI Certified is a certification mark of the Open Source Initiative.&nbsp;</strong></p>
<blockquote>
<p align="left"><a href="#TargetOperatingEnvironments">1. Target Operating
Environments</a><br/>
<a href="#Compatibility">2. Compatibility with Previous
Releases</a><br/>
<a href="#KnownIssues">3. Known Issues</a><br/>
<a href="#RunningEclipse">4. Running Eclipse</a><br/>
<a href="#Upgrading">5. Upgrading a Workspace from a Previous Release</a><br/>
<a href="#InteroperabilityWithPreviousReleases">6. Interoperability with
Previous Releases</a><br/>
<a href="#DefectsFixed">7. Defects Fixed in Maintenance Releases</a><br/>
<a href="#Appendix1">Appendix 1: Execution Environment by Bundle</a><br/>
</p>
</blockquote>
<h2>1. <a name="TargetOperatingEnvironments"></a>Target Operating Environments</h2>
<p>In order to remain current, each Eclipse Project release targets reasonably current
operating environments.</p>
<p>Most of the Eclipse SDK is &quot;pure&quot; Java code and has no direct dependence
on the underlying operating system. The chief dependence is therefore on the
Java Platform itself. Portions are targeted to specific classes of operating
environments, requiring their source code to only reference facilities available
in particular class libraries (e.g. J2ME Foundation 1.1, J2SE 1.4, Java 5, etc).</p>
<p>In general, the 3.7 release of the Eclipse Project is developed on a mix
of Java SE 5 and Java SE 6 VMs. As such, the Eclipse SDK as a whole
is targeted at all modern, desktop Java VMs. Most functionality is available for
Java SE 5 level development everywhere, and extended development capabilities are made
available on the VMs that support them.</p>
<p><a href="#Appendix1">Appendix 1</a> contains a table that indicates the class
library level required for each bundle.</p>
<p>There are many different implementations of the Java Platform running atop
a variety of operating systems. We focus our testing on a handful of
popular combinations of operating system and Java Platform; these are our <em>reference
platforms</em>. Eclipse undoubtedly runs fine in many operating environments
beyond the reference platforms we test. However, since we do not systematically test
them we cannot vouch for them. Problems encountered when running Eclipse on a
non-reference platform that cannot be recreated on any reference platform will
be given lower priority than problems with running Eclipse on a reference platform.</p>
<p>Eclipse 3.7 is tested and validated on the following reference platforms:</p>
<style type="text/css">
table.platforms {
border-width: 1px;
border-spacing: 0px;
border-style: solid;
border-collapse: separate;
}
table.platforms th {
border-width: 1px;
padding: 3px;
border-style: inset;
border-color: black;
background-color: #B9A9FF;
}
table.platforms td {
border-width: 1px 1px 1px 1px;
padding: 3px 3px 3px 3px;
border-style: inset inset inset inset;
border-color: gray gray gray gray;
}
table.platforms tr.c0 td {
background-color: #FDFDFD;
}
table.platforms tr.c1 td {
background-color: #F4EEFF;
}
</style>
<center>
<table class="platforms">
<tr>
<th>Operating System</th>
<th>Version</th>
<th>Hardware</th>
<th>JRE</th>
<th>Windowing System</th>
</tr>
<!-- ************ WINDOWS ************** -->
<tr class="c0">
<td rowspan="6">Windows</td>
<td rowspan="2">7</td>
<td rowspan="1">x86 32-bit</td>
<td rowspan="6">Oracle Java 6 Update 17<br/>
IBM Java 6 SR8
</td>
<td rowspan="6">Win32</td>
</tr>
<tr>
<td rowspan="1">x86 64-bit</td>
</tr>
<tr>
<td rowspan="2">Vista</td>
<td rowspan="1">x86 32-bit</td>
</tr>
<tr class="c0">
<td rowspan="1">x86 64-bit</td>
</tr>
<tr class="c0">
<td rowspan="2">XP</td>
<td rowspan="1">x86 32-bit</td>
</tr>
<tr class="c0">
<td rowspan="1">x86 64-bit</td>
</tr>
<!-- ************ RHEL ************** -->
<tr class="c1">
<td rowspan="3">Red Hat Enterprise Linux</td>
<td rowspan="3">6</td>
<td rowspan="1">x86 32-bit</td>
<td rowspan="2">Oracle Java 6 Update 17<br/>
IBM Java 6 SR8
</td>
<td rowspan="3">GTK</td>
</tr>
<tr class="c1">
<td rowspan="1">x86 64-bit</td>
</tr>
<tr class="c1">
<td rowspan="1">Power 64-bit</td>
<td>IBM Java 6 SR8</td>
</tr>
<!-- ************ SLES ************** -->
<tr class="c0">
<td rowspan="3">SUSE Linux Enterprise Server</td>
<td rowspan="3">11</td>
<td rowspan="1">x86 32-bit</td>
<td rowspan="2">Oracle Java 6 Update 17<br/>
IBM Java 6 SR8
</td>
<td rowspan="3">GTK</td>
</tr>
<tr class="c0">
<td rowspan="1">x86 64-bit</td>
</tr>
<tr class="c0">
<td rowspan="1">Power 64-bit</td>
<td>IBM Java 6 SR8</td>
</tr>
<!-- ************ Ubuntu ************** -->
<tr class="c1">
<td rowspan="2">Ubuntu Long Term Support</td>
<td rowspan="2">10.04</td>
<td rowspan="1">x86 32-bit</td>
<td rowspan="2">Oracle Java 6 Update 17<br/>
IBM Java 6 SR8
</td>
<td rowspan="2">GTK</td>
</tr>
<tr class="c1">
<td rowspan="1">x86 64-bit</td>
</tr>
<!-- ************ Solaris ************** -->
<tr class="c0">
<td rowspan="2">Oracle Solaris</td>
<td rowspan="2">10</td>
<td rowspan="1">x86 32-bit</td>
<td rowspan="2">Oracle Java 6 Update 17</td>
<td rowspan="2">GTK</td>
</tr>
<tr class="c0">
<td rowspan="1">SPARC 32-bit</td>
</tr>
<!-- ************ HPUX ************** -->
<tr class="c1">
<td rowspan="1">HP-UX</td>
<td rowspan="1">11i v2</td>
<td rowspan="1">ia64 32-bit</td>
<td rowspan="1"> HP-UX Java 6 Update 10</td>
<td rowspan="1">GTK</td>
</tr>
<!-- ************ AIX ************** -->
<tr class="c0">
<td rowspan="1">IBM AIX</td>
<td rowspan="1">5.3</td>
<td rowspan="1">Power 64-bit</td>
<td rowspan="1">IBM Java 6 SR8</td>
<td rowspan="1">GTK</td>
</tr>
<!-- ************ Mac ************** -->
<tr class="c1">
<td rowspan="2">Apple Mac OS X</td>
<td rowspan="2">10.6</td>
<td rowspan="1">Universal 32-bit</td>
<td rowspan="2">Apple Java 10.6 Update 2</td>
<td rowspan="2">Cocoa</td>
</tr>
<tr class="c1">
<td rowspan="1">Universal 64-bit</td>
</tr>
</table>
</center>
<p>As stated above, <i>we expect that Eclipse works fine on other current
Java VM and OS versions but we cannot flag these as reference platforms without
significant community support for testing them.</i></p>
<p>The Eclipse SDK is designed as the basis for internationalized products. The
user interface elements provided by the Eclipse SDK components, including dialogs
and error messages, are externalized. The English strings are provided as the
default resource bundles.</p>
<p>Latin-1, DBCS, and BIDI locales are supported by the Eclipse SDK on all reference platforms.</p>
<p>The Eclipse SDK supports GB 18030 (level 1), the Chinese code page standard,
on Windows, Linux and the Macintosh.</p>
<p>German and Japanese locales are tested.</p>
<h2>2. <a name="Compatibility"></a>Compatibility with Previous Releases</h2>
<h3>Compatibility of Release 3.7 with 3.6</h3>
<p>Eclipse 3.7 is compatible with Eclipse 3.6 (and all earlier 3.x versions).</p>
<p><strong>API Contract Compatibility:</strong> Eclipse SDK 3.7 is upwards
contract-compatible with Eclipse SDK 3.6 except in those areas noted in the
<a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.platform.doc.isv/porting/eclipse_3_7_porting_guide.html" target="_top">
<em>Eclipse 3.7 Plug-in Migration Guide</em>
</a>. Programs that use affected APIs and extension points will need to be ported
to Eclipse SDK 3.7 APIs. Downward contract compatibility
is not supported. There is no guarantee that compliance with Eclipse SDK 3.7
APIs would ensure compliance with Eclipse SDK 3.6 APIs. Refer to
<a href="http://wiki.eclipse.org/index.php/Evolving_Java-based_APIs">
<em>Evolving Java-based APIs</em>
</a> for a discussion of the kinds of API changes that maintain contract compatibility.</p>
<p><strong>Binary (plug-in) Compatibility:</strong> Eclipse SDK 3.7 is upwards
binary-compatible with Eclipse SDK 3.6 except in those areas noted in the
<a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.platform.doc.isv/porting/eclipse_3_7_porting_guide.html" target="_top">
<em>Eclipse 3.7 Plug-in Migration Guide</em>
</a>. Downward plug-in compatibility is not supported. Plug-ins for Eclipse SDK
3.7 will not be usable in Eclipse SDK 3.6. Refer to
<a href="http://wiki.eclipse.org/index.php/Evolving_Java-based_APIs">
<em>Evolving Java-based APIs</em>
</a> for a discussion of the kinds of API changes that maintain binary compatibility.</p>
<p><strong>Source Compatibility:</strong> Eclipse SDK 3.7 is upwards source-compatible
with Eclipse SDK 3.6 except in the areas noted in the
<a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/org.eclipse.platform.doc.isv/porting/eclipse_3_7_porting_guide.html" target="_top">
<em>Eclipse 3.7 Plug-in Migration Guide</em>
</a>. This means that source files written
to use Eclipse SDK 3.6 APIs might successfully compile and run against Eclipse
SDK 3.7 APIs, although this is not guaranteed. Downward source compatibility
is not supported. If source files use new Eclipse SDK APIs, they will not be
usable with an earlier version of the Eclipse SDK. </p>
<p><strong>Workspace Compatibility:</strong> Eclipse SDK 3.7 is upwards
workspace-compatible with earlier 3.x versions of the Eclipse SDK unless noted.
This means that workspaces and projects created with Eclipse SDK 3.6 .. 3.0 can be successfully
opened by Eclipse SDK 3.7 and upgraded to a 3.7 workspace. This includes both
hidden metadata, which is localized to a particular workspace, as well as metadata
files found within a workspace project (e.g., the .project file), which may
propagate between workspaces via file copying or team repositories. Individual
plug-ins developed for Eclipse SDK 3.7 should provide similar upwards compatibility
for their hidden and visible workspace metadata created by earlier versions;
3.7 plug-in developers are responsible for ensuring that their plug-ins recognize
metadata from earlier versions and process it appropriately. User
interface session state may be discarded when a workspace is upgraded. Downward
workspace compatibility is not supported. A workspace created (or opened) by
a product based on Eclipse 3.7 will be unusable with a product based on an earlier
version of Eclipse. Visible metadata files created (or overwritten) by Eclipse
3.7 will generally be unusable with earlier versions of Eclipse. </p>
<p><strong>Non-compliant usage of API's</strong>: All non-API methods and classes,
and certainly everything in a package with &quot;internal&quot; in its name or
x-internal in the bundle manifest entry,
are considered implementation details which may vary between operating environment
and are subject to change without notice. Client plug-ins that directly depend
on anything other than what is specified in the Eclipse SDK API are inherently
unsupportable and receive no guarantees about compatibility within a single
release much less with earlier releases. Refer to
<a href="http://www.eclipse.org/articles/Article-API%20use/eclipse-api-usage-rules.html">
<em>How to Use the Eclipse API</em>
</a> for information about how to write compliant plug-ins. </p>
<h2>3. <a name="KnownIssues"></a> Known Issues</h2>
<blockquote>
<a href="#I-General">
3.1 General problems</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-General-Startup">3.1.1 Startup</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-General-GCJ">3.1.2 GCJ</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-General-64bitJava">3.1.3 64-bit Java HotSpot(TM) VM</a><br/>
<a href="#I-Platform">3.2 Platform</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Core">3.2.1 Core</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Ant">3.2.2 Ant</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-User-Assistance">3.2.3 User Assistance</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-UI">3.2.4 UI</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Text">3.2.5 Text</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-SWT">3.2.6 SWT</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Team-CVS">3.2.7 Team and CVS</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Install-Update">3.2.8 Install/Update</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Debug">3.2.9 Debug</a><br/>
&nbsp;&nbsp;&nbsp;&nbsp; <a href="#I-Platform-Compare">3.2.10 Compare</a><br/>
<a href="#I-JDT">
3.3 Java development tools (JDT)</a><br/>
<a href="#I-PDE">
3.4 Plug-in Development Environment (PDE)</a><br/>
</blockquote>
<p>Note: Bug numbers refer to the Eclipse project bug database at <a href="http://dev.eclipse.org/bugs/">http://bugs.eclipse.org/bugs/</a></p>
<h3>3.1 <a name="I-General">General problems</a></h3>
<h3>3.1.1 <a name="I-General-Startup">General - Startup</a></h3>
<h4>Installation/Configuration issues that can cause Eclipse to fail start</h4>
<p>Here are some common problems that can cause Eclipse not to start:</p>
<ul>
<li>As shown <a href="#TargetOperatingEnvironments">above</a>, Eclipse 3.7 requires
at least a Java SE 5. Perhaps an older version of the VM is being found in
your path. To explicitly specify which VM to run with, use the Eclipse <tt>-vm</tt>
command-line argument. (See also the <a href="#RunningEclipse">Running Eclipse</a>
section below.)</li>
<li>
Running Eclipse on Gentoo Linux may result in the following error message:
<div style="margin-left: 40px;">
<tt>* run-java-tool is not available for sun-jdk-1.6 on i686<br/>* IMPORTANT: some Java tools are not available on some VMs on some architectures</tt>
</div>
If this occurs, start Eclipse by specifying a -vm argument, either
specify the path to a java vm or use: <tt>eclipse -vm `java-config</tt>
--java` (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=176021">176021</a>)</li>
<li>Eclipse must be installed to a clean directory and not installed over top of
a previous installation. If you have done this then please re-install to a new
directory. If your workspace is in a child directory of your old installation
directory, then see the instructions below on "<a href="#upgrading">Upgrading Workspace from a
Previous Release"</a>.</li>
<li>Java sometimes has difficulty detecting whether a file system is writable. In
particular, the method java.io.File.canWrite() appears to return true in
unexpected cases (e.g., using Windows drive sharing where the share is a
read-only Samba drive). The Eclipse runtime generally needs a writable
configuration area and as a result of this problem, may erroneously detect the
current configuration location as writable. The net result is that Eclipse will
fail to start and depending on the circumstances, may fail to write a log file
with any details. To work around this, we suggest users experiencing this
problem set their configuration area explicitly using the <tt>-configuration</tt> command
line argument. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=67719">67719</a>)</li>
</ul>
<h4><b>Invalid characters in install directory prevents Eclipse from starting</b></h4>
<p>Eclipse will fail to launch if installed in a directory whose path
contains certain invalid characters, including :%#&lt;&gt;&quot;!. The
workaround is to install Eclipse in a directory whose path does not contain
invalid characters. (bugs <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=3109">3109</a>
and <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=17281">17281</a>)</p>
<h4>Hanging during class loading when out of permanent generation memory</h4>
<p>
The Sun VM may hang indefinitely during class loading if it runs out of permanent
generation memory. This will cause CPU usage to stay at 100% until the process
is ended. See the section <a href="#RunningEclipse">Running Eclipse</a> for details
on addressing this VM problem.
</p>
<h3>3.1.2 <a name="I-General-GCJ">General - GCJ</a></h3>
<p>GCJ is an effort by the GCC team to provide an open source Java compiler and
runtime environment to interpret Java bytecode. Unfortunately, the GCJ runtime
environment is not an environment that is often tested on by Eclipse developers.</p>
<p>The most common problems surrounding GCJ are:</p>
<ul>
<li>Eclipse does not start at all</li>
<li>Eclipse throws a 'java.lang.ClassNotFoundException: org.eclipse.core.runtime.Plugin' that can be found in the logs (located in
workspace/.metadata/.log)</li>
</ul>
<p>The workspace's log file is a good place to check to identify whether GCJ is
being used or not. Every Eclipse log session is prepended with
information about the runtime environment that was used to run Eclipse. The log
may include something like the following:</p>
<code>java.fullversion=GNU libgcj 4.2.1 (Debian 4.2.1-5)</code>
<p>If Eclipse does start, one can check which runtime environment is being used to
run Eclipse by going to <b>Help &gt; About Eclipse SDK &gt; Installation Details &gt; Configuration</b>. The
<b>About</b> dialog itself can also provide other information, the build identifier
can be of particular interest as it is tagged by some distributions. This allows the
user to identify whether Eclipse was downloaded through the distribution's
package management system or directly from the eclipse.org web site.</p>
Eg: <code>Build id: M20070212-1330 (Ubuntu version: 3.2.2-0ubuntu3)</code>
<p>The two most common workarounds are:</p><ul>
<li>download the Eclipse binary from eclipse.org directly</li>
<li>run Eclipse using an alternate Java runtime environment</li></ul>
<p>To download Eclipse, try one of the links below:</p><ul>
<li><a href="http://www.eclipse.org/downloads/">http://www.eclipse.org/downloads/</a></li>
<li><a href="http://download.eclipse.org/eclipse/downloads/">http://download.eclipse.org/eclipse/downloads/</a></li></ul>
It is imperative that 64-bit builds are downloaded and used if a 64-bit Java
runtime environment has been installed. Below are two sample tarball names of
version 3.7.0 of the Eclipse SDK packaged for 32-bit and 64-bit processors.
<pre>eclipse-SDK-3.7-linux-gtk.tar.gz (32-bit)
eclipse-SDK-3.7-linux-gtk-x86_64.tar.gz (64-bit)</pre>
<p>To run Eclipse with an alternate Java runtime environment, the path to the Java
virtual machine's binary must be identified. With an Eclipse installation from
the distribution, altering the $PATH variable to include the path to the
alternate Java runtime environment is often not enough as the Eclipse that
Linux distributions package often performs a scan internally to pick up GCJ by
itself whilst ignoring what's on the $PATH. An example of the terminal's output
is shown below:</p>
<code>searching for compatible vm...<br/>
testing /usr/lib/jvm/java-7-icedtea...not found<br/>
testing /usr/lib/jvm/java-gcj...found</code>
<p>Once the path to the virtual machine's binary has been identified, try running
Eclipse with the following command:</p>
<code>./eclipse -vm /path/to/jre/bin/java</code>
<p>For an actual example, it might look something like the following:</p>
<code>./eclipse -vm /usr/lib/jvm/sun-java-6/bin/java<br/>
./eclipse -vm /opt/sun-jdk-1.6.0.02/bin/java</code>
<p>If this seems to solve the problem, it is likely that the problem really was
related to the use of GCJ as the Java runtime for running Eclipse. The
eclipse.ini file located within Eclipse's folder can be altered to
automatically pass this argument to Eclipse at startup. An example of its
content is presented below:</p>
<code>-showsplash<br/>
org.eclipse.platform<br/>
--launcher.XXMaxPermSize<br/>
256m<br/>
-vm<br/>
/opt/sun-jdk-1.6.0.02/bin/java<br/>
-vmargs<br/>
-Xms40m<br/>
-Xmx512m</code>
<p>Note that every argument must be on its own line. More information about the
eclipse.ini file can be found at <a href="http://wiki.eclipse.org/Eclipse.ini">http://wiki.eclipse.org/Eclipse.ini</a>.</p>
<p>If problems persists after downloading an installation of Eclipse from
eclipse.org and using a supported Java runtime environment (a list of which may be found <a href="#TargetOperatingEnvironments">above</a>),
you can seek further assistance through the <a href="http://www.eclipse.org/newsgroups/">newsgroups</a>,
the IRC <a href="irc://irc.freenode.net/#eclipse">channel</a>,
and/or <a href="https://bugs.eclipse.org/bugs/">bugzilla</a>.
</p>
<h3>3.1.3 <a name="I-General-64bitJava">General - 64-bit Java HotSpot(TM) VM</a></h3>
<p>
There is a known issue with the Java HotSpot(TM) 1.6.0 VM compiler which causes eclipse to
crash (see Sun bug <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6614100">http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6614100</a>,
and Eclipse bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=214092">214092</a>).
The crash usually occurs within a VM CompilerThread when attempting to compile the method org.eclipse.core.internal.dtree.DataTreeNode.forwardDeltaWith.
</p>
<p>
This problem has been addressed in Sun Java 6 update 11, so the simplest resolution is
to obtain the latest JRE release for your platform.
To work around the issue you can exclude the method org.eclipse.core.internal.dtree.DataTreeNode.forwardDeltaWith from being compiled with the following
VM argument:
</p>
<code>
-XX:CompileCommand=exclude,org/eclipse/core/internal/dtree/DataTreeNode,forwardDeltaWith
</code>
<p>
This VM argument can be placed in the eclipse.ini file after the -vmargs line like the following:
</p>
<code>
-startup<br/>
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.0.200.v20090306-1900<br/>
--launcher.library<br/>
plugins/org.eclipse.equinox.launcher_1.0.200.v20090429-1630.jar<br/>
-showsplash<br/>
org.eclipse.platform<br/>
--launcher.XXMaxPermSize<br/>
256m<br/>
-vmargs<br/>
-XX:CompileCommand=exclude,org/eclipse/core/internal/dtree/DataTreeNode,forwardDeltaWith<br/>
-Xms40m<br/>
-Xmx256m<br/>
</code>
<p>
There have been reports of other classes that cause the compiler to crash. If all else fails you can
disable the compiler with the VM arg &quot;-Xint&quot;.
</p>
<h3>3.2 <a name="I-Platform">Platform</a></h3>
<h3>3.2.1 <a name="I-Platform-Core">Platform - Core</a></h3>
<h4>Installing plug-ins by unzipping them into the plugins directory</h4>
<p>New plug-ins can be installed into the system by unzipping them into the plugins
directory. However this is not recommended, and the dropins directory should be
used for this purpose instead. Note that unzipping a different
version of a plug-in that is already installed will have no effect. To change the version
of a plug-in installed in your system, you need to either perform an update, or install
a feature patch.</p>
<h4>No branding with old config.ini</h4>
<p>If you have an old config.ini file and use it with a new Eclipse build, you
may not get the correct product branding. This is because the id of the standard
Eclipse product changed. Users in shared install scenarios may end up in this
situation as previous builds of Eclipse automatically generated config.ini files
in some cases. The work around is either to delete the local config.ini or
update the eclipse.product line to read eclipse.product=org.eclipse.platform.ide.</p>
<h4>Problems with classloaders in created threads</h4>
<p>There is a known issue with trying to load classes from a newly-created
thread using a class loader different from the plug-in class loader. The result
will be a <code>ClassNotFoundException</code>. As a workaround, do the
following:</p>
<ol>
<li>Create a thread in which to run your code.</li>
<li>Send yourThread.setContextClassLoader(yourClassLoader); // you can find
your classloader by grabbing a class it loaded (YourPluginClass.class.getClassLoader())</li>
<li>Run your code in the newly created thread.</li>
</ol>
<p>If you set the context class loader for the current thread, you are
competing with other users of the thread (all of Eclipse), so the results will
be unpredictable. However, there should be no problem in practice provided you
reset the context class loader back to its original value when your use in the
current thread is&nbsp;complete. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=8907">8907</a>)</p>
<h4>Deadlock creating executable extension in Plugin.startup</h4>
<p>If <code>Plugin.startup</code> code is too complex and performs tasks such
as creating an executable extension, a deadlock situation can be created. Only
simple bookkeeping tasks should be performed in <code>Plugin.startup</code>
code. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=5875">5875</a>)</p>
<h4>Potential Problems Converting Plug-in Manifests</h4>
<p>If your plug-in ships with a plug-in manifest and not an OSGi bundle manifest,
is shipped as a JAR file, and contains a nested JAR file then there may be
problems in the automatic generation of the bundle manifest file. The packages
defined in the nested JAR may not be exported correctly in the <tt>Export-packages</tt>
bundle manifest header. To work around this you should ship your plug-in with a
bundle manifest. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=97689">97689</a>)</p>
<h4>Location for Debug Options File on Mac OS</h4>
<p>If you are running in debug mode on Mac OS, the default location for the
.options file is inside the application bundle in the Eclipse.app/Contents/MacOS
directory (like the eclipse.ini). (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=88782">88782</a>)</p>
<h4>Issues with JNI that use FindClass</h4>
<p>
There may be issues when using a JNI implementation that uses FindClass
in a function where the JNIEnv pointer is not available, such as in a C
callback (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=125250">125250</a>). The reason is that FindClass, in this case, uses the application
class loader to find the class.
If the desired class is in the classpath used for the application classloader
(e.g. defined by the VM argument -cp &lt;classpath&gt;), as it would typically be in
a stand-alone application, there is no problem. However, under
Eclipse, the application classloader does not have access to classes
contained in plug-ins. Eclipse uses its own class loader to find classes
contained in plug-ins.
</p>
<p>
The proper plug-in class loader is used by FindClass in JNI functions which are
passed the JNIEnv pointer, but not when you have to use AttachCurrentThread to get the
JNIEnv pointer. In this case the application classloader is used.
</p>
<p>
For example, the following will fail because AttachCurrentThread is used to
get the JNIEnv pointer:</p>
<pre>
static JavaVM* jvm; // Global variable
void myCallback(void) {
JNIEnv* env;
jvm-&gt;AttachCurrentThread((void**)&amp;env, NULL);
// Fails if some/class is not in the application classloader:
jclass cls = env-&gt;FindClass(&quot;some/class&quot;);
jmethodID methodID = env-&gt;GetMethodID(cls, &quot;methodName&quot;,
&quot;(Ljava/lang/String;)V or whatever signature&quot;);
env-&gt;CallVoidMethod(callback, methodID, ...);
jvm-&gt;DetachCurrentThread();
}
}
</pre>
<p>
A solution is to cache the method ID, for example:
</p>
<pre>
static jmethodID mid; // Global variable
JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved) {
...
// Store the JavaVM pointer
jvm = vm;
// Find the class and store the method ID
// Will use the class loader that loaded the JNI library
jclass cls = env-&gt;FindClass(className&quot;some/class&quot;);
if(!cls) goto ERR;
mid = env-&gt;GetMethodID(cls, &quot;methodName&quot;,
&quot;(Ljava/lang/String;)V or whatever signature&quot;);
if(!mid) goto ERR;
...
}
void myCallback(void) {
JNIEnv* env;
jvm-&gt;AttachCurrentThread((void**)&amp;env, NULL);
env-&gt;CallVoidMethod(callback, mid, ...);
// Handle error ...
jvm-&gt;DetachCurrentThread();
}
}
</pre>
<h3>3.2.2 <a name="I-Platform-Ant">Platform - Ant</a></h3>
<h4> Custom Ant tasks and Ant types must be separate from plug-in library JARs</h4>
<p>Including the class files for custom Ant tasks or Ant types in the regular
code JAR for your plug-in causes problems. These class files must be provided in
a separate JAR that is contributed to the <code>org.eclipse.ant.core.antTasks</code>
or <code>antTypes</code> extension point (and not declared as a library in the
plug-in's manifest). This ensures that the Ant tasks and types are loaded by the
special Ant class loader and not by a plug-in classloader. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=34466">34466</a>).</p>
<h4> Concurrent Ant builds not supported</h4>
<p>Eclipse can run Ant in the same JVM as the rest of Eclipse. Several aspects
of Ant and its use of global Java resources (such as System.out and System.err),
make it unsafe to run more than one Ant build concurrently in the same JVM. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=24129">24129</a>).</p>
<h4>XDoclet support from within Eclipse</h4>
<p>Since there are differences when running Ant from the commandline and within Eclipse, some extra steps may be needed to have XDoclet support function correctly within Eclipse. Problems may occur creating XDoclet subtasks. The workarounds and full discussion can be found in bug report. (bug
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=37070">37070</a>)</p>
<h4>Ant Editor code completion based on Ant 1.6.x</h4>
<p>Code completion provided by the Ant editor does not respect the user-specified version of org.eclipse.ant.core plug-in or ANT_HOME.
Code completion proposals are mostly based on Ant 1.6.x with some updates to Ant 1.6.5 (bug
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=193046">bug 193046</a>)</p>
<h4> Setting build loggers not supported when debugging Ant builds</h4>
<p>When debugging Ant builds within Eclipse, setting -logger as a program argument will be ignored.</p>
<h4>Renaming an External Tool builder set to run during auto-build will cause errors</h4>
<p>If you rename an existing external tool builder that is configured to run during auto-builds, you will get the following error:
Errors during build.
Errors running builder "Integrated External Tool Builder" on project
&lt;PROJECT_NAME&gt;.
The builder launch configuration could not be found.
The workaround is to first disable the builder for auto-builds and then rename the builder.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=118294">118294</a>)</p>
<h4>Slow typing/saving of the Ant editor with imports that define numerous macrodefs</h4>
<p>The Ant editor is slow on saving with buildfiles that have &lt;import&gt; declarations of buildfiles that have numerous &lt;macrodef&gt;s.
See bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=125117">125117</a> for a possible workaround</p>
<h4>Failure to run Ant builds on non-Windows platforms if Eclipse installed in location with spaces in the path</h4>
<p>Due to a bug in Ant 1.7.0, Ant builds will fail with an IllegalArgumentException if the Eclipse installation is in a location with spaces in the path.
Embedded usage of Ant builds, such as plug-in export will also fail.
See bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=187993">187993</a> for possible workarounds</p>
<h4>Ant 1.8.x reports missing libraries as build failures</h4>
<p>
In Ant 1.8.x, if you try to use a task that requires additional libraries and you do not have the libraries on the Ant classpath, the build will now properly report is failed.
In previous versions of Ant, the build would still report that it had suceeded even though it actually failed to run any of the tasks from additional bundles. See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344518">bug 344518</a>.
</p>
<p>
For more information on tasks that require additional bundles please refer to the <a href="http://www.apache.org/dist/ant/RELEASE-NOTES-apache-ant-1.8.2.html">Ant 1.8.2 release notes</a>
and the <a href="http://ant.apache.org/manual/install.html#optionalTasks">Optional Tasks</a> section in the At manual.
</p>
<h4>Ant 1.8.x extension-point feature is not supported in the Ant editor</h4>
<p>
The extension-point feature added in Ant 1.8.x is not supported in the Ant editor, meaning there is no content assist or help support for it.
See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=324625">bug 324625</a> for more details.
</p>
<h3>3.2.3 <a name="I-Platform-User-Assistance">Platform - User Assistance</a></h3>
<h4>Welcome page not displayed properly (Linux/Unix)</h4>
<p>The default Welcome implementation is HTML-based and requires a supported browser
in order to work. If no supported browser can be found, Welcome falls back to its
Forms-based implementation, which has a different (simpler) appearance. Consult the
<a href="http://www.eclipse.org/swt/faq.php#browserplatforms">SWT FAQ</a> for supported
browsers and setting up your browser to work with eclipse.
</p>
<h4>Help browser tool bar buttons do not work for some documents</h4>
<p>The Help browser's Print, Synchronize, and Bookmark buttons do not work for
pages that are not actually installed with the product. However, you can always
use the print command in the browser's context menu to print the page you're
reading. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=44216">44216</a>)</p>
<h4> Help documents not displayed
in a browser or very slow document loading (Windows only)</h4>
If your LAN settings are not properly configured for local host access, your
Help browser might open to a blank page or display an HTTP error instead of a
help page, or you may experience long delays when loading help documents. Your
system administrator can configure your LAN settings so that help documents can
be accessed from the local help server.
<blockquote>
<ol>
<li>In the Control Panel, open <b>Internet Options</b>, select the <b>Connections</b>
tab and choose <b>LAN Settings</b>.</li>
<li>If your host was configured to use DHCP for IP assignment, make sure
that the &quot;Automatically detect settings&quot; check box is cleared.</li>
<li>If you use a proxy server, ensure that the &quot;Bypass proxy server
for local addresses&quot; is selected.</li>
<li>In &quot;Advanced&quot; settings for proxies, add
&quot;127.0.0.1;localhost&quot; to the &quot;Exceptions&quot; if these
addresses are not listed.</li>
<li>If you are using an automatic configuration script for proxy
settings, and are not sure that the script is correct, clear the &quot;Use
automatic configuration script&quot; check box.</li>
</ol>
</blockquote>
<h4> Working disconnected from
the network (Windows only)</h4>
If you are experiencing problems when not connected to the network, you must
install the loopback adapter from the Windows installation CD. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=831">831</a>)
<h4> Using Internet Explorer in
offline mode (Windows only)</h4>
If you have been using Internet Explorer in Offline mode, when you access the
help system you will get a message indicating that the web page you requested is
not available offline or a blank page will display. Click <b>Connect</b> or
deselect &quot;Work Offline&quot; in the Internet Explorer &quot;File&quot; menu
to return the system behavior to normal.
<h4>Help topics not highlighted in High Contrast mode (Windows only)</h4>
<p>Windows High Contrast settings are not consistently picked up by Internet
Explorer when they are set from the Accessibility Options utility as opposed to
when they are set using the predefined schemes. On Windows XP, it is recommended
to set High Contrast as follows: Right click the desktop, chose properties,
select Windows Classic style from the Windows and buttons drop down on the
Appearance tab, and choose your scheme (for example High Contrast Black) from
Color Scheme drop down. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=28609">28609</a>)</p>
<h3>3.2.4 <a name="I-Platform-UI">Platform - UI</a></h3>
<h4>High contrast settings</h4>
<p>Eclipse was tested for High Contrast using 1152 x 864 resolution in Windows
XP High Contrast mode. You can select this mode by selecting Accessibility
Options &gt; Display &gt; Use High Contrast from the Windows XP Control Panel
menu.</p>
<h4> Dirty state not tracked properly for OLE documents (Windows only)</h4>
<p>The dirty state for an OLE document is not updated properly. This causes
Eclipse to prompt to save the contents of the editor when the document is
closed, even if the contents have already been saved. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=2564">2564</a>)</p>
<h4> OLE document crashes can cause Eclipse to also crash (Windows only)</h4>
<p>If an OLE document crashes, Eclipse can crash, or the workbench menus can
become inconsistent.</p>
<h4>2.1 Presentation based workspaces incorrectly get new Min/Max behavior</h4>
<p>
Workspaces that are currently using the Eclipse 2.1 Presentation will incorrectly
'inherit' the new min/max behavior when opened with 3.3.
</p>
<p>
Workaround:</p>
<ol>
<li>Go to the 'Preferences -&gt; Appearance' page, change the current presentation to 'Default' and select apply</li>
<li>Change it back to the 2.1 Presentation, select 'OK' and 'Yes' to the restart prompt</li>
</ol>
When the workbench re-opens the old min/max behavior will be restored.
<h4>Toolbars only containing contributed controls exhibit display errors on Mac/Linux</h4>
<p>
Currently there is no way on the Max or Linux platforms to define the <b>height</b> for controls contributed to
toolbars, nor will those platforms respect the size returned by the control's <code>computeSize</code> method. If you
encounter this issue there is currently no truly viable workaround.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=183003">183003</a>)
</p>
<h3>3.2.5 <a name="I-Platform-Text">Platform - Text</a></h3>
None.
<h3>3.2.6 <a name="I-Platform-SWT">Platform - SWT</a></h3>
<h4>Eclipse plug-in based on the SWT Browser throws exception</h4>
<p>The SWT Browser widget uses a platform-specific web browser to render HTML.
The org.eclipse.swt.SWTError exception (&quot;No more handles&quot;) is thrown
on platforms that don't meet the requirements for running the Browser widget.
Supported platforms and prerequisites are listed on the SWT FAQ item <a href="http://www.eclipse.org/swt/faq.php#browserplatforms">
&quot;Which platforms support the SWT Browser?&quot;</a>.</p>
<h4>Opening File Dialog crashes eclipse (Vista only)</h4>
<p>On Vista, launching eclipse using <code>-vmargs -Xmx[any size]</code> can crash eclipse when the FileDialog is opened.
The workaround is to use the default heap size, i.e. do not use the <code>-Xmx</code> VM args.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=188317">188317</a>)</p>
<h4>Crash while editing text (Windows XP with SP2 only)</h4>
<p>Some users who have installed Service Pack 2 on Windows XP have experienced
crashes while using editors in Eclipse. The workaround is to place a working version
of Windows\System32\USP10.DLL in the Eclipse startup directory or uninstall
Service Pack 2.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=56390">56390</a>)</p>
<h4>Eclipse hangs when pasting from an unresponsive application (GTK only)</h4>
<p>If the application that is supplying the clipboard material is unresponsive,
the paste operation hangs Eclipse for several minutes. This situation can be
encountered when copying from an Eclipse target workbench, suspending the target
workbench at a breakpoint and pasting into the hosting Eclipse workbench. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=44915">44915</a>)</p>
<h4>Available colors on 8-bit Linux (Linux only)</h4>
<p>Typically, in Gnome Linux installs running with 8-bit visuals (i.e. 256
color mode), before the Eclipse application is started there are no free colors.
This may mean that Eclipse is unable to allocate the default widget background
color, causing it to display a white background. The functionality, however, is
otherwise unaffected.</p>
<h4>IME conversion problem (Solaris GTK only)</h4>
<p>When typing Japanese text, the conversion to Kanji must be done one ideogram at
a time. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=226636">226636</a>)</p>
<h4>Key bindings can stop working on Debian (GTK+ only)</h4>
<p>On some versions of Debian, Eclipse key bindings may stop working. In this context
the only way to make the key bindings work again is to restart Eclipse.
</p><p>
The problem is that a focus issue exists in GTK+ 2.6.7 and earlier, for which SWT has
a workaround. This workaround is incompatible with the GTK+ 2.6.7 fix, so a GTK+ version
check is done at runtime to determine whether the workaround should be used or not.
However, Debian backported the GTK+ focus fix into their libgtk+2.0 (2.6.4-2) package,
so the SWT workaround and GTK+ fix are both incorrectly applied in this context.
</p><p>
To work around this problem, either get the Debian unstable version of GTK+, compile your
own GTK+, or hack SWT's Shell.gtk_realize(int) and change the version that it checks.
See SWT bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=107013">107013</a>
and GTK+ bug <a href="http://bugzilla.gnome.org/show_bug.cgi?id=109246">109246</a>
for more information.</p>
<h4>Typing in an editor crashes with IBM 1.5 VM (Linux GTK PPC only)</h4>
<p>When running on the IBM Java 5.0 VM, Eclipse crashes while the user is typing in an editor.
If using this VM you must disable the JIT with the -Xnojit vm argument to avoid the crashes
(see bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=116730">116730</a>).
The command line for launching Eclipse with this vm should be: <br/>
<code>eclipse -vmargs -Dosgi.locking=none -Xnojit</code>
</p>
<h4>Eclipse won't start (Linux GTK PPC only)</h4>
<p>Eclipse fails to create a lock file with reason &quot;No locks available&quot;.
To launch eclipse you must disable file locking using the osgi.locking property.
For example, you could launch eclipse as follows: <br/>
<code>eclipse -vmargs -Dosgi.locking=none</code>
</p>
<h4>SWT for Carbon cannot be used with Mac OS X JRE version 1.6 (Mac OS X 10.5 only)</h4>
<p>On Leopard (Mac OS X 10.5), JDK version 1.6 assumes that pointers have a size of 64 bits, but SWT's Carbon
port only uses 32-bit pointers, so SWT and Eclipse cannot be used on Leopard with JDK version
1.6. The workaround is to use the Cocoa version of SWT or an earlier supported version
of the Mac OS X JDK.
</p>
<p>Snow Leopard (Mac OS X 10.6) has both a 32-bit and 64-bit version of JDK 1.6, so this restriction does not apply on that version of the operating system.
</p>
<h4>Strings may be truncated or incorrectly wrapped on RHEL5 (Linux GTK only)</h4>
<p>
Strings on wrapping Controls may not appear correctly in some locales on RHEL5 as a result
of a bug in Pango version 1.14.x. This problem can be fixed by upgrading the installed
Pango library to a version that is newer than 1.14.x. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=231951">231951</a>)
</p>
<h4>Block Selection functionality provided by StyledText is not BIDI aware</h4>
<p>
When the orientation of characters under the left and right edges of the block
selection rectangle are not the same, the actual selection ranges (in memory)
differ from the visual representation of the selection. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=277929">277929</a>)
</p>
<h4>Older versions of some Windows screen readers no longer work with Eclipse</h4>
<p>JAWS versions 8 and 9 and Window-Eyes version 6 no longer work well with Eclipse and other SWT applications.
Window-Eyes 6 will cause Eclipse to crash, and JAWS 8 and 9 can cause SWT applications to crash.
This happens because IAccessible2 support was added to SWT for Eclipse 3.7, but these older screen reader versions contain
partial implementations of IAccessible2 that do not follow the current IAccessible2 specification.</p>
<p>
The workaround for these cases is to specify Java property <code>org.eclipse.swt.accessibility.UseIA2</code> with value <code>false</code>,
which will instruct SWT to not attempt to use IA2 interfaces. An easy way to set this property is to specify VM argument
<code>-Dorg.eclipse.swt.accessibility.UseIA2=false</code> when launching Eclipse or your SWT application. (bug
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=313182">313182</a>)</p>
<h4>Drawing problems when using non-advanced graphics on recent GTK versions</h4>
<p>On modern Linux distributions with a GTK version greater than 2.18, clipping problems and pixel corruption
can occur if the SWT client uses non-advanced GC calls. These problems seem to be caused by low-level bugs
in the interactions between GDK and X.</p>
<p>
The workaround for this problem is to specify Java property <code>org.eclipse.swt.internal.gtk.useCairo</code> with value <code>true</code>,
which instructs SWT to always use Cairo for all GC calls (advanced graphics). An easy way to set this property is to specify VM argument
<code>-Dorg.eclipse.swt.internal.gtk.useCairo=true</code> when launching Eclipse or your SWT application.
(bugs <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345650">345650</a> and <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=333965">333965</a>)</p>
<h3>3.2.7 <a name="I-Platform-Team-CVS">Platform - Team - CVS</a></h3>
<p>The following are known problems with the CVS repository provider only, and
do not apply to other repository providers. Additional information on how to use
CVS from Eclipse can be found in the <a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-vcm-home/docs/online/cvs_features2.0/cvs-faq.html">Eclipse
CVS FAQ</a>.</p>
<h4> CVS server compatibility</h4>
<p>The CVS plug-in parses messages returned from the CVS server. If the format
of these messages is not as expected, some of the plug-in's functionality may be
missing. The CVS plug-in is compatible with all stable 1.11.X builds of the CVS
server, and should be compatible with future releases in that stream unless text
message formats change (the last tested server was 1.11.22). As for the 1.12.X
feature releases of CVS, the Eclipse CVS client has been tested with builds up
to 1.12.13. However, future releases could easily break the Eclipse CVS client.
Basic functionality, such as Checkout, Commit, and Update, should always work,
but there may be problems with more advanced commands such as Synchronizing and
Browsing the repository.</p>
<h4>SSH2 proxy settings lost upgrading to 3.3</h4>
<p>CVS now uses the Platform proxy settings. As a result, any CVS proxy settings
will be lost and must be re-entered on the General&gt;Network Connections preference
page. </p>
<h4>Connection cannot be found after initially missing</h4>
<p>If a connection initially fails due to a network problem, the connection may
continue to fail even when the network problem is fixed. In order to establish
the connection you must exit and restart Eclipse. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=9295">9295</a>)</p>
<h4>&quot;Received broken pipe signal&quot; error from server</h4>
<p>Eclipse sometimes performs multiple commands within a single connection to
the server. This may cause problems with CVS servers that are running server
scripts in response to certain commands. (bugs <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=23575">23575</a>
and <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=23581">23581</a>)</p>
<h4>&quot;Terminated with fatal signal 10&quot; error from server</h4>
<p>There is a bug in the CVS server related to some compression levels. If you
get this error, changing the compression level on the CVS preference page may
help. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=15724">15724</a>)</p>
<h4>&quot;Unknown response&quot; error using ext connection method</h4>
<p>There are a few situations that can result in an &quot;Unknown response&quot;
error messages when using the ext connection method. One situation involves
using an external communications client (e.g. rsh or ssh) that adds CRs to the
communications channel (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=21180">21180</a>).
Another involves Eclipse not properly reading the stderr output of the external
communications tool. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=11633">11633</a>)</p>
<h4>A disabled CVS capability may not be auto-enabled in existing workspaces</h4>
<p>New in 3.0 is the ability to disable capabilities and the CVS support in
Eclipse can be disabled. However, for backwards compatibility the CVS capability
is auto-enabled in existing workspaces that already contain CVS projects. The
auto-enabling function may not run if the team support plugin is not loaded at
startup. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=66977">66977</a>)</p>
<h4>Builder output files may appear as changed</h4>
<p>When folders containing build output are shared they may get improperly
marked as dirty when build output is generated.</p>
<h4>Enabling GNOME proxy support</h4>
<p>GNOME applications can make use of proxy settings defined in this environment.
If set, Eclipse will use it prior to proxy settings declared using env variables.
This feature is disabled by default, to enable it launch Eclipse with
<code>"-Dorg.eclipse.core.net.enableGnome"</code> switch. That is,</p>
<pre>eclipse -Dorg.eclipse.core.net.enableGnome</pre>
<h3>3.2.8 <a name="I-Platform-Install-Update">Platform - Install/Update</a></h3>
<h4>Manually installing features and plug-ins on a FAT file system (Windows only)</h4>
<p>When features and plug-ins are manually installed on top of an Eclipse-based
product install located on a FAT file system that has already been run at least
once, the product must be explicitly restarted with -clean. That is,</p>
<pre>eclipse.exe -clean
</pre>
<h4>Connecting to untrusted sites using https</h4>
<p>You cannot install or update software from a site using https whose certificate
is not chained to a trusted root certificate in your local certificate store. This typically
means the server is using a self-signed certificate, or a certificate authenticated by
an unknown third party.</p>
<h4>Extension location is lost if the install path changes</h4>
<p>A previously configured extension location may be temporarily removed if the install is moved or mounted
under a different path. This only happens when the link file that configures the
extension location uses a relative path that points to a directory under the Eclipse
install. On a second startup using the same install path, the extension location
is added again (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=95403">95403</a>). <br/></p>
<h4>Feature patches can only be installed from Eclipse 3.4-based update sites</h4>
<p>Feature patches can only be installed from update sites designed for Eclipse 3.4 or greater.
Specifically, the update site must have the necessary metadata for Equinox p2 (a content.xml
or content.jar file). This data can be generated by building an update site using Eclipse 3.4
or newer, or running the p2 metadata generator on an update site built using earlier versions
of the Eclipse SDK. See the help topic <i>Generating p2 metadata</i> for more details on running the p2 metadata
generator (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=244483">244483</a>).
</p>
<h3>3.2.9 <a name="I-Platform-Debug">Platform - Debug</a></h3>
<p>None. (Known problems with the Java debugger appear below in the <a href="#I-JDT">JDT</a>
section.)</p>
<h3>3.2.10 <a name="I-Platform-Compare">Platform - Compare</a></h3>
<p>None.</p>
<h3>3.3 <a name="I-JDT">Java development tools (JDT)</a></h3>
<h4>Multiple regions formatting in a given source snippet</h4>
In version 3.4, the new API method <code>org.eclipse.jdt.core.formatter.CodeFormatter.format(int, String, IRegion[], int, String)</code>
has been added to allow the formatting of several regions in a source snippet with a single pass.<br/>
Even if specified, this method does not currently accept comments of the following kinds:
<ul>
<li><code>org.eclipse.jdt.core.formatter.CodeFormatter#K_SINGLE_LINE_COMMENT</code></li>
<li><code>org.eclipse.jdt.core.formatter.CodeFormatter#K_MULTI_LINE_COMMENT</code></li>
<li><code>org.eclipse.jdt.core.formatter.CodeFormatter#K_JAVA_DOC</code></li>
</ul>
This will be fixed in a future release (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=233967">233967</a>).
<h4>Searching for constant field references</h4>
<p>Search does not find references to constant fields inside binaries because
the Java Language Specification mandates that constant field values be inlined
in the class file's byte codes, leaving no trace of a field reference.&nbsp;(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=12044">12044</a>)</p>
<h4> Cut, copy, paste not working
for linked resources in views showing Java elements</h4>
<p>The cut, copy, and paste actions do not work for linked files and folders
appearing in views that show Java elements, including the Package Explorer. The
workaround is to use these actions from the Navigator view instead. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=34568">34568</a>)</p>
<h4> Java working sets not
working correctly for elements from JRE system library container</h4>
<p>Applying a working set consisting entirely of elements from the JRE System
library container as a filter to the packages view might result in an empty
Package Explorer. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=30442">30442</a>)</p>
<h4>Breakpoints unreliable running Sun 1.6.0_14</h4>
Developers debugging applications on Sun's 1.6.0_14
virtual machine should be aware that breakpoints are unreliable (i.e. do
not always suspend execution). The problem occurs on Windows and Linux
platforms. This is an issue with the VM and not with Eclipse.
The workaround is to use the <code>-XX:+UseParallelGC</code> VM option. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=279137">279137</a>).
<h4>Some refactoring script operations fail with Sun 6.0 JREs</h4>
<p>Creating and applying refactoring scripts sometimes fails with Sun 6.0 JREs
due to a bug in the XML parser that is shipped with those VMs.
A workaround is to use a J2SE 5.0 VM or an IBM 6.0 VM.
Another workaround is to replace the XML parser using the
<a href="http://java.sun.com/javase/6/docs/technotes/guides/standards/index.html">Java Endorsed Standards Override Mechanism</a>:
</p>
<ol>
<li>Get original versions of xml-apis.jar, xercesImpl.jar, xalan.jar, and serializer.jar from Apache, e.g.
xalan-j_2_7_1-bin.zip from <a href="http://xml.apache.org/xalan-j/downloads.html">here</a>.
</li>
<li>Unpack the archive and copy the 4 JARs into <code>&lt;path-to-your-JavaSE6.0-install&gt;\jre\lib\endorsed\</code>.
</li>
</ol>
(see Sun bug <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6760982">http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6760982</a>,
Eclipse bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=262820">262820</a>)
<h4>Suspend on uncaught exception overrides exception breakpoint location filters</h4>
<p>Exception breakpoints can be configured with location filters (inclusive and
exclusive). When an unchecked exception is configured to <b>not</b> suspend
execution in a specific class, execution will still suspend when the user preference
to suspend on uncaught exceptions is on. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=66770">66770</a>)</p>
<h4>Running Java programs with non-Latin-1 characters in package or class names</h4>
You get a <code>java.lang.NoClassDefFoundError</code> when running Java
programs with non-Latin characters in the package or class names. The workaround
is to package the class files as a JAR file and run the program out of the JAR
and not from the file system directly. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=4181">4181</a>)
<h4>Cannot run or debug class in
a project with GB18030 characters in project name</h4>
<p>Most class libraries do not properly support the creation of a system
process (via <code>java.lang.Runtime.exec(...)</code>) when the specified
command line contains GB18030 characters. This limitation means the debugger
cannot launch applications when the command line it generates contains GB18030
characters. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=32206">32206</a>)</p>
<h4>Cannot detect installed JRE with GB18030 characters in path name</h4>
<p>Automatic JRE detection fails when the JRE is stored in a directory
containing GB18030 characters in its name. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=33844">33844</a>)</p>
<h4>Cannot generate Javadoc for packages with GB18030 characters in the name</h4>
<p>Most class libraries do not properly support the creation of a system
process (via <code>java.lang.Runtime.exec(...)</code>) when the specified
command line contains GB18030 characters. Since Javadoc is created using the
Javadoc executable provided with the JDK, generating Javadoc fails if the
package or class name contains GB18030 characters. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=32215">32215</a>)</p>
<h4> Unable to debug stack
overflows</h4>
<p>If a debug session suspends on a <code>java.lang.StackOverflowError</code>
exception (due to an exception breakpoint), the debugger may not be able to
retrieve any debug information from the target JVM. As well, the debugger may
not be able to reliably interact with the target JVM past this point. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=19217">19217</a>)</p>
<h4> Evaluation limitation</h4>
<p>The debugger uses threads in the target JVM to perform evaluations (both
explicit evaluations that the user requests, and implicit evaluations such as <code>toString()</code>
invocations in the <b>Variables</b> view). The Java Debug Interface (JDI)
requires that the thread in which an evaluation is performed be suspended by a
user event (that is, a breakpoint or step request). Evaluations cannot be
performed on threads suspended by the suspend action. As well, when a breakpoint
is configured to suspend the JVM rather than just the individual thread, the
threads which did not encounter the breakpoint are not in a valid state to
perform an evaluation. When an evaluation is attempted in a thread that is not
in a valid state to perform an evaluation, an error message will appear to the
effect of &quot;Thread must be suspended by step or breakpoint to perform method
invocation&quot;. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=34440">34440</a>)</p>
<h4> Missing debug attributes</h4>
The debugger requires that class files be compiled with debug attributes if
it is to be able to display line numbers and local variables. Quite often, class
libraries (for example, &quot;<code>rt.jar</code>&quot;) are compiled without
complete debug attributes, and thus local variables and method arguments for
those classes are not visible in the debugger.
<h4> Using Hot Code Replace</h4>
<p>Hot code replace is supported on JDK 1.4.x VMs, and IBM J9 VMs. The debugger
will attempt to replace all class files that change in the workspace as the user
edits and builds source code. However, hot code replace is limited to changes
that a particular virtual machine implementation supports. For example, changes
within existing methods may be supported, but the addition or removal of members
may not be.</p>
<p>Note that hot code replace and stepping on JDK 1.4.0 VMs was unreliable. The
underlying VM problems were fixed in JDK 1.4.1, and later.</p>
<h4> Scrapbook</h4>
Setting a breakpoint inside a scrapbook page is not supported.
<p>When a snippet is run in the scrapbook which directly or indirectly calls <code>System.exit(int)</code>,
the evaluation cannot be completed, and will result in a stack trace for a <code>com.sun.jdi.VMDisconnectedException</code>
being displayed in the scrapbook editor.</p>
<p>Terminating a scrapbook page while it is performing an evaluation results
in a <code>com.sun.jdi.VMDisconnectedException</code> being displayed in the
scrapbook editor.</p>
<h4> Debugging over slow
connections</h4>
A global Java debug preference specifies the debugger timeout, which is the
maximum amount of time the debugger waits for a response from the target VM
after making a request of that VM. Slow connections may require that this value
be increased. The timeout value can be edited from the <b>Java &gt; Debug </b>preference
page. Changing the timeout value only affects subsequently launched VM, not VMs
that are already running.
<h4> Updating of inspected values</h4>
When inspecting the result of an evaluated expression in the debugger, it is
important to note that the result displayed is the result of that expression at
the time it was evaluated. For example, when inspecting a simple integer counter
(primitive data type), the value displayed in the Expressions view is the value
when the expression was evaluated. As the counter is changed in the running
program, the inspected result will not change (since the view is not displaying
the value bound to a variable - it is displaying the value of an expression, and
the value of a primitive data type cannot change). However, if an expression
results in an object, fields of that object will be updated in the inspector as
they change in the running program (since the value bound to fields in an object
can change).
<h4> Stepping over native methods
that perform I/O</h4>
When the debugger steps over native methods that perform I/O to <code>System.out</code>
or <code>System.err</code>, the output may not appear immediately unless the
native performs a flush on the output buffer.
<h4> VM and process termination
running on IBM 1.3 JVM on Linux (Linux only)</h4>
Terminating a launch, debug target, or system process associated with a debug
target running on the IBM 1.3 JVM on the Linux platform does not work when the
associated debug target has a suspended thread. To remove such debug targets
from the debug UI, select <b>Terminate and Remove</b> from the debug view's
pop-up menu (or use the shortcut &quot;delete&quot; key). Associated system
processes in the OS may not be properly cleaned up. If a debug target has no
suspended threads, termination works properly. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=1631">1631</a>)
<h4>Java 6 and MacOS</h4>
Apple JavaSE-1.6 VMs only execute on 64-bit architectures but JDT will detect 1.6 VMs installed on 32-bit
architectures when a new workspace is started or when the user presses the &quot;Search...&quot; button
on the Installed JREs preference page. Error messages will appear in the log each time JDT attempts to
determine which execution environments a 1.6 VM is compatible with. JDT can be configured to ignore 1.6
JREs by removing them from the Installed JREs preference page.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=262542">262542</a>)
<h4>Java Annotation Processing</h4>
<p>Some methods in the processing API are unimplemented when compiling within the IDE, and will
throw <code>UnsupportedOperationException</code>.</p>
<p>
Java 6 annotation processors are supported in the batch compiler and in the
IDE. By design, Java 6 processors are only executed during a build, not while
editing. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=188558">188558</a>)</p>
<p>
Java 5 annotation processors are supported in the IDE only. Java 5 processors
can be executed while editing, as well as during a build. Slow annotation
processors can cause a slowdown of the editing experience. If this occurs, you
may wish to turn off <b>Enable processing in editor</b> on the <b>Java Compiler &gt; Annotation Processing</b> properties
page of your Java project.</p>
<h4>Java indexing encounters problems when a folder is used both as a source and a class folder</h4>
<p>Java indexing encounters problems when a folder is used both as a source folder
in a project and as a class folder in another project. Hence, when this peculiar setup is
used, the Java Search might miss matches located in such a folder. To avoid this kind of problem, it is strongly advised to use different
folders for sources and binary classes. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=309903">309903</a>)</p>
<h3>3.4 <a name="I-PDE">Plug-in Development Environment (PDE)</a></h3>
<h4>Feature manifest editor does not preserve all comments</h4>
<p>When a non-source page of the feature manifest editor is used, PDE will convert
changes back into XML by regenerating the file. Although the overall content and
most of the comments are preserved, some comments may be lost. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=59502">59502</a>)</p>
<h4>PDE will not unzip source zips of some plug-ins</h4>
<p>In the plug-in import wizard, when you choose to import plug-ins as
&quot;projects with source folders&quot;, PDE will not unzip the source for the
org.apache.ant, org.eclipse.core.runtime.compatibility.registry, org.eclipse.osgi.util and org.eclipse.osgi.services. This is
because the source ZIPs contains code that will not compile when unzipped as it
requires additional JARs that are not part of the SDK. To avoid the creation of
plug-in projects that won't compile, PDE will import these plug-ins as binary
and attach source, so you would still be able to read the source, you just won't
be able to modify it. Also, PDE will not unzip the source for the
org.eclipse.swt plug-ins. In this case, it is because, when shipped, the swt
code is spread across a plug-in and a fragment, and when unzipped, it will
require circular dependencies between the plug-in and fragment projects. These
circular dependencies are at minimum marked as warnings by the JDT compiler and
may result in unpredictable build behavior. Therefore, PDE always imports
org.eclipse.swt as binary with source attached. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=66314">66314</a>)</p>
<h4>Emacs key bindings do not
work in manifest editor fields</h4>
<p>Non-default key bindings currently do not work in fields on non-source
pages of the PDE manifest editors. (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=19482">19482</a>)</p>
<h4>Export of plug-in may silently drop classes</h4>
<p>When exporting a plug-in using the plug-in, feature or product wizards, some classes
might be dropped from the resulting archive if their fully qualified name is too long.
This typical path limitation can be worked around by creating the jar of the problematic
plug-in by using the Jar export wizard.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=97150">97150</a>)</p>
<h4>Compilation errors when exporting projects not stored outside of the workspace</h4>
<p>When exporting multiple plug-ins and one is stored outside of the workspace,
compile errors occurs on export. To work around the problem, you can either export
the plug-ins one by one, or change their location.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=98579">98579</a>)</p>
<h4>Headless build needs to be run from a fully qualified path</h4>
<p>When running a headless build using the scripts provided by pde build, the properties <code>builder</code>
and <code>buildDirectory</code> must refer to a fully qualified path.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=139554">139554</a>)
</p>
<h4>Target Platform only sees installed plug-ins</h4>
<p>With the new p2 provisioning system in 3.4, PDE introduced a preference to control how target platforms are built.
By default, this preference is on if your target equals your host, otherwise it's off. When this preference is enabled, PDE attempts to
read a target platform's configuration and build the target platform based in the target's list of installed plug-ins. If a configuration
can't be found (a bundles.info or platform.xml file), PDE will simply manually scan the target directory and populate the target platform's
list of plug-ins.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=226037">226037</a> and bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=225148">225148</a>)
</p>
<h4>Delta pack is not seen by PDE when installed</h4>
<p>If you're using the delta pack, the target platform preference for building a target based on the target's installed plug-ins must be checked off.
This is because a target's runtime configuration only contains plug-ins specific to the platform it's running on.
(bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=230146">230146</a>)
</p>
<h2>4. <a name="RunningEclipse">Running Eclipse</a></h2>
<p>After installing the Eclipse SDK in a directory, you can start the Workbench
by running the Eclipse executable included with the release (you also need a Java SE 5
JRE, not included with the Eclipse SDK). On Windows, the executable file is called <samp>eclipse.exe</samp>,
and is located in the <code>eclipse</code> sub-directory of the install. If
installed at <code>c:\eclipse-SDK-3.7-win32</code>, the executable is <code>c:\eclipse-SDK-3.7-win32\eclipse\eclipse.exe</code>.
<b>Note:</b> Set-up on most other operating environments is analogous. Special
instructions for Mac OS X are listed <a href="#macosx">below</a>.</p>
<h3>Allocating enough memory and solving OutOfMemoryErrors</h3>
<p>By default, Eclipse will allocate up to 256 megabytes of Java heap memory. This should
be ample for all typical development tasks. However, depending on the JRE
that you are running, the number of additional plug-ins you are using, and
the number of files you will be working with, you could conceivably have to increase this amount.
Eclipse allows you to pass arguments directly to the Java VM using the
<code>-vmargs</code> command line argument, which must follow all other Eclipse specific arguments.
Thus, to increase the available heap memory, you would typically use:</p>
<blockquote>
<p><code>eclipse -vmargs -Xmx&lt;memory size&gt;</code></p>
</blockquote>
<p>with the <code>&lt;memory size&gt;</code> value set to greater than
&quot;256M&quot; (256 megabytes -- the default).
</p>
<p>
When using a Sun VM, you may also need to increase the size of the permanent
generation memory. The default maximum is 64 megabytes, but more may
be needed depending on your plug-in configuration and use. When the VM runs
out of permanent generation memory, it may crash or hang during class loading.
This failure is less common when using Sun JRE version 1.5.0_07 or greater.
The maximum permanent generation size is increased using the -XX:MaxPermSize=&lt;memory size&gt; argument:</p>
<blockquote>
<p><code>eclipse -vmargs -XX:MaxPermSize=&lt;memory size&gt;</code></p>
</blockquote>
<p>This argument may not be available for all VM versions and platforms; consult your VM documentation
for more details.
</p>
<p>
Note that setting memory sizes to be larger than the amount of available physical
memory on your machine will cause Java to &quot;thrash&quot; as it copies objects
back and forth to virtual memory, which will severely degrade your performance.
</p>
<h3>Selecting a workspace</h3>
<p>When the Workbench is launched, the first thing you see is a
dialog that allows you to select where the workspace will be located. The
workspace is the directory where your work will be stored.
If you do not specify otherwise, Eclipse creates the workspace in your
user directory.
This workspace directory is used as the default content area for your projects
as well as for holding any required metadata. For shared or multi-workspace
installs you must explicitly specify the location for your workspace using the
dialog (or via the &quot;<code>-data</code>&quot; command line argument).</p>
<h3>Specifying the Java virtual machine</h3>
<p>Here is a typical Eclipse command line:&nbsp;</p>
<blockquote>
<p><code>eclipse -vm c:\jdk6u22\jre\bin\javaw</code></p>
</blockquote>
<p><i>Tip:</i> It's generally a good idea to explicitly specify which Java VM to
use when running Eclipse. This is achieved with the &quot;<code>-vm</code>&quot;
command line argument as illustrated above. If you don't use &quot;<code>-vm</code>&quot;,
Eclipse will look on the O/S path. When you install other Java-based products,
they may change your path and could result in a different Java VM being used
when you next launch Eclipse.</p>
<p>To create a Windows shortcut to an installed Eclipse:</p>
<ol>
<li>Navigate to <code>eclipse.exe</code> in Windows Explorer and use Create
Shortcut on the content menu.</li>
<li>Select the shortcut and edit its Properties. In the Target: field append
the command line arguments.</li>
</ol>
<p>Opening this shortcut launches Eclipse. (You can drag the shortcut to the
Windows Desktop if you want to keep it in easy reach.)</p>
<h3><a name="macosx">Mac OS X</a></h3>
<p>On Mac OS X, you start Eclipse by double clicking the Eclipse application. If you need to
pass arguments to Eclipse, you'll have to edit the <code>eclipse.ini</code> file
inside the Eclipse application bundle: select the Eclipse application bundle icon while holding down the Control Key.
This will present you with a popup menu. Select &quot;Show Package Contents&quot; in the popup menu.
Locate <code>eclipse.ini</code> file in the <code>Contents/MacOS</code> sub-folder and open it with your favorite text editor to edit the command line options.
</p>
<p>
On MacOS X you can only launch a UI program more than once if you have separate
copies of the program on disk. The reason for this behavior is that every UI
application on Mac can open multiple documents, so typically there is no need
to open a program twice. Since Eclipse cannot open more than one workspace, this means you have to make
a copy of the Eclipse install if you want to open more then one workspace at
the same time (bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=139319">139319</a>).
</p>
<p>If you need to launch Eclipse from the command line, you can use the symbolic link &quot;eclipse&quot; in the
top-level eclipse folder. It refers to the eclipse executable inside the application bundle and takes
the same arguments as &quot;eclipse.exe&quot; on other platforms.
</p>
<p>On Mac OS X 10.4 and later, you may notice a slow down when working with significant
numbers of resources if you allow Spotlight to index your workspace. To prevent this, start
System Preferences, select the Spotlight icon, then the Privacy tab, then click the Add button
(&quot;+&quot;) and find your workspace directory in the dialog that appears.</p>
<h3><a name="SharedInstall">Shared Install</a></h3>
<p>The startup speed of a shared install can be improved if proper cache information is stored in the shared
install area. To achieve this, after unzipping Eclipse distribution, run Eclipse once with the &quot;-initialize&quot;
option from an account that has a write access to the install directory.</p>
<h2>5. <a name="Upgrading"></a>Upgrading Workspace from a Previous Release</h2>
<h3>Users who don't use &quot;-data&quot;</h3>
<p>If you weren't previously using &quot;-data&quot; to specify your workspace,
follow these steps to upgrade:</p>
<ol>
<li>Find the workspace directory used by your old version of Eclipse.
Typically this is located inside the directory in which Eclipse was
installed in a sub-directory called &quot;<code>workspace</code>&quot;. If
you are using a shortcut or script to launch Eclipse, then it will be under
the current working directory of that shortcut or script in a sub-directory
called &quot;workspace&quot;. For Windows users, this is specified by the
&quot;Start in:&quot; argument in your shortcut properties.</li>
<li>Copy this workspace directory to a new, empty location outside of any
Eclipse install directory.</li>
<li>Install the new version of Eclipse in a new location, separate from any
old version of Eclipse.</li>
<li>If you had installed additional features and plug-ins into your old
Eclipse, you should re-install them in the new Eclipse.</li>
<li>Start this new version of Eclipse and select
this location using the workspace chooser dialog at startup (or use &quot;<code>-data</code>&quot;
command line argument to pre-select the workspace location).</li>
</ol>
<h3>Users who do use &quot;-data&quot;</h3>
<p>If you were previously using the &quot;<code>-data</code>&quot; argument to
start Eclipse, your upgrade path is much easier:</p>
<ol>
<li>Optionally copy your workspace directory to a new, empty location outside of any
Eclipse install directory as a backup.</li>
<li>Install the new version of Eclipse in a new location, separate from any
old versions of Eclipse.</li>
<li>If you had installed additional features and plug-ins into your old
Eclipse, you should re-install them in the new Eclipse.</li>
<li>Start this new version of Eclipse and select this location using the workspace chooser dialog at
startup (or use &quot;<code>-data</code>&quot;
command line argument to pre-select the workspace location).</li>
</ol>
<p><i>Note:</i> Copying your workspace is recommended because,
after you've upgraded your workspace, you won't be able to use it
again with an older version of Eclipse. If you ever want to go &quot;back in
time&quot; to an earlier release, you will need that backup.</p>
<h3> Users who use User Libraries or classpath containers that contain JARs referencing other libraries via Class-Path in the MANIFEST.MF</h3>
<p>
If you want the referenced JAR files to be included in the classpath, you can do one of the following:<br/>
<ul>
<li>Add the system property (<code>-DresolveReferencedLibrariesForContainers=true</code>) to the <code>-vmargs</code>
list on start-up, or</li>
<li>Manually add the referenced JARs to the User Library or to the project.</li>
</ul>
</p>
<h2>6. <a name="InteroperabilityWithPreviousReleases">Interoperability with
Previous Releases</a></h2>
<h3>6.1 Interoperability of Release 3.7 with previous releases</h3>
<h4>Sharing projects between heterogeneous Eclipse 3.7 and 3.6</h4>
<p>Special care is required when a project in a team repository is being loaded
and operated on by developers using Eclipse-based products based on different
feature or plug-in versions. The general problem is that the existence,
contents, and interpretation of metadata files in the workspaces may be specific
to a particular feature or plug-in version, and differ between versions. The
workspace compatibility guarantees only cover cases where all developers upgrade
their Eclipse workspaces in lock step. In those cases there should be no problem
with shared metadata. However, when some developers are working in Eclipse 3.7
while others are working in Eclipse 3.6, there are no such guarantees.
This section provides advice for what to do and not to do. It addresses the
specific issues with the Eclipse SDK.</p>
<p>The typical failure mode is noticed by the 3.7 user. 3.7 metadata is lost
when a 3.6 user saves changes and then commits the updated metadata files to the
repository. Here's how things typically go awry:</p>
<ul>
<li>A user working in Eclipse 3.7 creates or modifies a project in a way that
results in changes to a shared metadata file that rely on 3.7-specific
information. The user then commits the updated project files, including the
shared metadata file, to the shared repository.</li>
<li>Another user working in Eclipse 3.6 shares this project from the same
repository. The 3.7-specific information in the shared metadata file is not
understood by Eclipse 3.6, and is generally discarded or ignored without
warning. The user modifies the project in a way that results in changes to
the shared metadata file, causing the shared metadata file to be rewritten
without any of the 3.7-specific information. The user commits the updated
project files, including the shared metadata file, to the shared repository.
The user is generally unaware that shared information has just been lost as
a result of their actions.</li>
<li>A user working in Eclipse 3.7 picks up the changes to a project from the
shared repository, including the updated shared metadata file. The user may
be unaware that they have just taken a retrograde step until later when
things start to malfunction.</li>
</ul>
<p>Here are some things to watch out for when sharing projects between
Eclipse 3.7 and earlier 3.x releases:</p>
<ul>
<li><b>Virtual folders</b> -
Eclipse 3.7 supports a notion of <i>virtual folders</i> that did not exist
in Eclipse 3.5 or earlier. If such virtual folders are created in 3.7, and the project
is subsequently loaded into an Eclipse 3.5 or earlier workspace, these folders
will not be recognized. Recommendation: avoid creating virtual folders where project
compatibility with Eclipse 3.5 or earlier is required.</li>
<li><b>Resource filters</b> -
Eclipse 3.7 supports a notion of <i>resource filters</i> that did not exist
in Eclipse 3.5 or earlier. If such filters are added to resources in 3.7, and the project
is subsequently loaded into an Eclipse 3.5 or earlier workspace, these filters
will not be recognized. Recommendation: avoid creating resource filters where project
compatibility with Eclipse 3.5 or earlier is required.</li>
<li><b>Predefined path variables</b> -
Eclipse 3.7 supports a set of built in path variables that can be used as the basis
for linked resource locations. Such variables will not be defined automatically in
Eclipse 3.5 or earlier. If compatibility with 3.5 or earlier workspace is required,
users on 3.5 or earlier workspaces will need to define such path variables manually.
</li>
</ul>
<h4>Using Eclipse 3.7 to develop plug-ins that work in Eclipse 3.6</h4>
<p>It is also possible (and reasonable) to use Eclipse 3.7 to develop a plug-in
intended to work in Eclipse 3.6 or earlier. Use the <b>Plug-in Development &gt;
Target Platform </b>preference page to locate non-workspace plug-ins in an Eclipse
3.6 install. This ensures that the code for your plug-in is being compiled and
tested against Eclipse 3.6 APIs, extension points, and plug-ins. (The above
list of concerns do not apply since they affect the layout and interpretation
of files in the plug-in <i>project</i> but none affect the actual deployed form
of the plug-in.)</p>
<h2>7. <a name="DefectsFixed"></a>Defects Fixed in Maintenance Releases</h2>
<h3>7.1 Defects fixed in release 3.7.1 since 3.7</h3>
<p>Release 3.7.1 is a maintenance release to fix serious defects present in
release 3.7. These changes only affect some plug-ins and
features.</p>
<p>Maintenance release 3.7.1 contains fixes for the following defects and others:</p>
<p>
Note: Bug fixes since the 3.7.1 release can be obtained by the following the Bugzilla query: </p>
<p>
<a href="https://bugs.eclipse.org/bugs/buglist.cgi?bug_file_loc_type=allwordssubstr&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&classification=Eclipse&classification=RT&columnlist=short_desc&field0-0-0=noop&keywords_type=allwords&long_desc_type=allwordssubstr&product=Equinox&product=JDT&product=PDE&product=Platform&query_format=advanced&remaction=&resolution=FIXED&short_desc=&short_desc_type=allwordssubstr&status_whiteboard=&status_whiteboard_type=allwordssubstr&target_milestone=3.7.1&type0-0-0=noop&value0-0-0=|&order=bug_id&query_based_on=">Bugs fixed in the 3.7.1 release</a>
</p>
<table class="bz_buglist" cellspacing="0" cellpadding="4" width="100%">
<tr class="bz_buglist_header bz_first_buglist_header">
<th colspan="1" class="first-child">
<a href="https://bugs.eclipse.org/bugs/buglist.cgi?bug_file_loc_type=allwordssubstr&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;classification=Eclipse&amp;classification=RT&amp;columnlist=short_desc&amp;field0-0-0=noop&amp;keywords_type=allwords&amp;long_desc_type=allwordssubstr&amp;product=Equinox&amp;product=JDT&amp;product=PDE&amp;product=Platform&amp;query_format=advanced&amp;remaction=&amp;resolution=FIXED&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;status_whiteboard=&amp;status_whiteboard_type=allwordssubstr&amp;target_milestone=3.7.1&amp;type0-0-0=noop&amp;value0-0-0=%7C&amp;order=bug_id%20DESC&amp;query_based_on=">ID<span class="bz_sort_order_primary">&#x25B2;</span></a>
</th>
<th colspan="1">
<a href="https://bugs.eclipse.org/bugs/buglist.cgi?bug_file_loc_type=allwordssubstr&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;classification=Eclipse&amp;classification=RT&amp;columnlist=short_desc&amp;field0-0-0=noop&amp;keywords_type=allwords&amp;long_desc_type=allwordssubstr&amp;product=Equinox&amp;product=JDT&amp;product=PDE&amp;product=Platform&amp;query_format=advanced&amp;remaction=&amp;resolution=FIXED&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;status_whiteboard=&amp;status_whiteboard_type=allwordssubstr&amp;target_milestone=3.7.1&amp;type0-0-0=noop&amp;value0-0-0=%7C&amp;order=short_desc%2Cbug_id&amp;query_based_on=">Summary</a>
</th>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b112443"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=112443">112443</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][quick assist] allow converting a conditional into if-else even if there is an error
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b242159"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=242159">242159</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] type inference with unbounded wildcard in result type
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b272592"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=272592">272592</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Issues with PNG images on Cocoa
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b281912"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=281912">281912</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">printing to non-default printer no longer works properly
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P2 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b288548"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=288548">288548</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Add support for Java SE 7 features
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b300576"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=300576">300576</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">NPE Computing type hierarchy when compliance doesn't match libraries
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b317719"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=317719">317719</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Method incorrectly flagged as having same erasure output when return type differs
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b326311"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=326311">326311</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Bus error in org.eclipse.swt.internal.cocoa.OS.object_getInstanceVariable (called from Tree.expandItem)
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b334306"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=334306">334306</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] name clash reported in javac 1.7 and not in javac 1.6
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b334313"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=334313">334313</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.5][compiler] Bug in the way eclipse handles overriding of generic abstract method by a non-abstract method
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b336322"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=336322">336322</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][search]CCE while searching for a type reference in multiple catch parameters
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b336782"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=336782">336782</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][recovery]Extra error tokens with invalid unary operator
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b337738"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=337738">337738</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][content assist]Test CompletionParserTest#testEA_1 fails
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b337795"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=337795">337795</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Missing unchecked warning at varargs method/ctor declaration site
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b337799"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=337799">337799</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler][varargs] Eclipse fails to report error on incorrect SafeVarargs usage
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b337802"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=337802">337802</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Usage of 0x0ffffffff is being reported as out of range.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b338402"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=338402">338402</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler][enh] Open issues in try with resources implementation
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b338789"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=338789">338789</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][assist] No proposal inside a multi catch statement after '|'
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b339478"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=339478">339478</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] support for diamond case
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b339837"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=339837">339837</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Multicatch syntax not rejected at 1.6-
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b339864"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=339864">339864</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Add recovery in ASTConverter for all new constructs in JLS3 mode
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340022"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340022">340022</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Support for precise rethrow
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340059"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340059">340059</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] IAE when dealing with Signature of disjunctive type
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340365"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340365">340365</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Problems in new APIs (TryStatementWithResources, DisjunctiveType)
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340372"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340372">340372</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] NaiveASTFlattener needs to support the new AST nodes
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340375"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340375">340375</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Merge TryStatementWithResources into TryStatement
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340445"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340445">340445</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] ASTRewriteAnalyzer and ASTRewriteFlattener need updates
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340484"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340484">340484</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Failure in computing precisely rethrown types.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340485"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340485">340485</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Type miscalculation in rethrow
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340486"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340486">340486</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Missing error in multi catch scenario
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340513"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340513">340513</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Unicode 6.0 characters work at compiler compliance level 1.5 and 1.6
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340626"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340626">340626</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Inconsistent source pinpointing in multi-catch blocks
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b340634"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340634">340634</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler][multicatch] Compiler accepts type variables as catch parameter type
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b340747"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=340747">340747</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] compiler option to warn when diamond can be used, but type args are used instead.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b341333"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=341333">341333</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] DisjunctiveTypeReference#resolveType(..) does not set the value for DisjunctiveTypeReference$resolvedType
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b341462"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=341462">341462</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][search][diamond] Search doesn't return the reference to a function when called with diamond constructor
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b341485"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=341485">341485</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][navigate] &quot;Open declared type&quot; does not navigate to LUB for a multi-catch's argument
</td>
</tr>
<tr class="bz_bugitem
bz_major bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b341795"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=341795">341795</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Cannot assign a generic method with multiple bounds return value to any variable
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b342416"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=342416">342416</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Signature#createIntersectionTypeSignature(..) should take array of signatures
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b343475"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343475">343475</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Compiler warning for invalid type inside switch needs to be improved
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b343476"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343476">343476</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][assist] propose String variables and fields inside switch case.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b343637"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343637">343637</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Already used exception offered again in a Mulicatch block
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b343687"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343687">343687</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] IAE in NumberLiteral#setToken(String) for binary tokens and tokens with underscore
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b343693"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343693">343693</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Adjust subclasses of AllocationExpression for &lt;&gt; support
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b343785"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=343785">343785</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Incorrect line numbers in stack trace with try with resources
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b344522"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344522">344522</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Incorrect source range for ParameterizedType in case of Diamond
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b344655"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344655">344655</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Prohibit use of &lt;&gt; with explicit type arguments to generic constructor
</td>
</tr>
<tr class="bz_bugitem
bz_critical bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b344696"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344696">344696</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[registry] IllegalArgumentException in DirectMap cause by multi-threaded access in ConfigurationElementMulti when -registryMultiLanguage is used
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b344824"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344824">344824</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Incorrect error range for unreachable catch block error in multi-catch
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b344833"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=344833">344833</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Enable 1.7 compiler compliance in JavaSE-1.7.profile
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345020"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345020">345020</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[run control][debug view] Run control actions not updated upon state change when multiple elements selected in Debug view.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b345239"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345239">345239</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Compiler should issue better diagnostics for use of &lt;&gt; with anonymous classes
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345359"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345359">345359</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] AIOOB on diamond construct with argument error
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b345411"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345411">345411</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Table.pack() makes column width too small by one pixel
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345522"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345522">345522</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Compilers fails to compute precisely rethrown types
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b345559"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345559">345559</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Type inference for generic allocation can be avoided for invalid constructor
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345579"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345579">345579</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Weird error message in rethrow site
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b345628"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345628">345628</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Rename disjunctive type to union type
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345715"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345715">345715</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[implementation] AnnotationModel.fModificationStamp leaks annotations
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b345968"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345968">345968</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] NPE while using diamond for inner class allocation
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b345979"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345979">345979</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Helios crash on Linux!
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b346029"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346029">346029</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Eclipse compiles code rejected by JDK7
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P2 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b346116"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346116">346116</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Java files open when inspecting the code, instead of Class file
</td>
</tr>
<tr class="bz_bugitem
bz_minor bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b346401"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346401">346401</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[import/export] p2 import/export does not persist previously selected Eclipse installation
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b346406"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346406">346406</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[import/export] p2 import/export: offer a search filter
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b346415"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346415">346415</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][assist] No proposal inside catch statement from 3rd catch block onwards
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b346454"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346454">346454</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][content assist]Getting NegativeArraySizeException while trying content assist after diamond
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b346518"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346518">346518</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">weaving hook support creates an extra byte[] copy each class load when it is not necessary
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b346741"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=346741">346741</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][doc] Update doc when java 1.7 support is done
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b347145"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347145">347145</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Bounds check issue with raw types in method inference
</td>
</tr>
<tr class="bz_bugitem
bz_critical bz_P3 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b347183"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347183">347183</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Deadlock reading/writing to log
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b347426"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347426">347426</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] ecj behavior differs from javac
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b347503"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347503">347503</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[DOM] ASTParser.setEnvironment() ignores includeRunningVMBootclasspath parameter
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b347600"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347600">347600</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Suspect bounds check failure after inference.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b347746"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347746">347746</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][compiler] Bounds check failure during method inference
</td>
</tr>
<tr class="bz_bugitem
bz_major bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b347756"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347756">347756</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[10.7] Keyboard events are not received if Shell has SWT.RESIZE style
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b347786"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347786">347786</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][quick fix] Quick fixes for new warnings/errors corresponding to &#64;SafeVarargs annotation
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b347792"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=347792">347792</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][quick fix] Update &quot;Convert 'switch' to 'if-else'&quot; quick assist
</td>
</tr>
<tr class="bz_bugitem
bz_major bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b348024"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348024">348024</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">Empty AST for class with static inner class in a package with package-info.java
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b348046"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348046">348046</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">MAC Copy DBCS using HTMLTransfer will be shown as messy code.
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b348050"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348050">348050</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Error in JDT Core during AST creation
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b348061"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348061">348061</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] [quick assist] Quick assists to convert multiple catch blocks to a single multi-catch block and vice versa
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b348164"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348164">348164</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">text boxes in server overview for times are too small on Cocoa / Mac
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b348198"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348198">348198</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7][typing] Broken indentation after enhanced for loop
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_RESOLVED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b348309"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348309">348309</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[10.7]Awkward Scroll Bars
</td>
</tr>
<tr class="bz_bugitem
bz_normal bz_P3 bz_VERIFIED bz_FIXED bz_row_even ">
<td class="first-child bz_id_column">
<a name="b348369"
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=348369">348369</a>
<span style="display: none"></span>
</td>
<td
class="bz_short_desc_column">[1.7] Missing error &quot;No exception of type Exception[] can be thrown&quot;
</td>
</tr>
<tr class="bz_bugitem
bz_enhancement bz_P3 bz_VERIFIED bz_FIXED bz_row_odd ">
<td class="first-child bz_id_column">
<a name="b348379"