Fixed bug 307820: Add readme entry about APT option to disable processing in the editorR3_5_maintenance

1 files changed, 15 insertions, 7 deletions

diff --git a/oldfeatures/org.eclipse.platform-feature/rootfiles/readme/readme_eclipse.html b/oldfeatures/org.eclipse.platform-feature/rootfiles/readme/readme_eclipse.html
index 74def422..b8b28b59 100644
--- a/oldfeatures/org.eclipse.platform-feature/rootfiles/readme/readme_eclipse.html
+++ b/oldfeatures/org.eclipse.platform-feature/rootfiles/readme/readme_eclipse.html
@@ -8,7 +8,7 @@
 
 <h1>Eclipse Project Release Notes</h1>
 <p>Release 3.5.2<br>
-  Last revised February 10, 2010</p>
+  Last revised April 7, 2010</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>
@@ -1232,12 +1232,20 @@ on the Installed JREs preference page. Error messages will appear in the log eac
 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 6 Annotation Processing</h4>
-Java 6 annotation processors are supported in the batch compiler and in the IDE, with 
-some limitations. 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>). Some methods
-in the processing API are unimplemented when compiling within the IDE, and will throw
-UnsupportedOperationException.
+
+<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>Refactoring fails with invalid package name error when jaxb-xjc.jar is on build path</h4>
 This JAR contains some entries that start with "1.0/". This leads to an invalid package name error once