Bug 516357 - N&N for Oxygen (4.7)

Updated entries for new java index and others based on pmc feedback.
Added entry for Java 9.

2 files changed, 21 insertions, 5 deletions

diff --git a/bundles/org.eclipse.jdt.doc.user/whatsNew/jdt_whatsnew.html b/bundles/org.eclipse.jdt.doc.user/whatsNew/jdt_whatsnew.html
index e8d1f22a7..bc49b9da4 100644
--- a/bundles/org.eclipse.jdt.doc.user/whatsNew/jdt_whatsnew.html
+++ b/bundles/org.eclipse.jdt.doc.user/whatsNew/jdt_whatsnew.html
@@ -232,12 +232,20 @@ document for changes in the Platform.</p>
   <tr id="new-java-index">
     <td class="title">New Java index</td>
     <td class="content">
-      Eclipse 4.7 contains an experimental new Java index which is disabled by default. You can enable it from <b>Preferences &gt; Java</b>:
+      Eclipse 4.7 contains an experimental new Java index which is disabled by default.<br> 
+      As a thumb rule, you can try the new indexing to get better performance when there are a large number of Jar dependencies.
+      The new index has been adopted completely in the <b>Type Hierarchy</b> view and partially in some features that use the binary file caching (jars and .class files) such as <b>Package Explorer</b> expansion for jars.
+      It hasn't been adopted by the search features.
+      <p>
+      You can enable the new index from <b>Preferences &gt; Java</b>:
+      </p>
       <p>
         <img src="images/new-java-index.png" alt=""/>
       </p>
-      The new <b>Rebuild Index</b> button can be used to delete all information cached in the Java index.
-      This can be used to save disk space after the new index got disabled, and to fix index corruption.
+      To improve performance, the new index captures a lot of semantic information in an index file separate from the classic index file, consuming additional memory and disk space.
+      The new <b>Rebuild Index</b> button can be used to delete the existing index files - both classic as well as new - then rebuild these index files from scratch.
+      If <b>Enable new Java index</b> option is not checked, only the classic index file will be rebuilt though both will be deleted, thus saving disk space. 
+      Also, if index corruption is suspected, <b>Rebuild Index</b> can be used to start from a clean slate again.
     </td>
   </tr>
   
@@ -429,7 +437,7 @@ document for changes in the Platform.</p>
   </tr>
   
   <tr id="option-disable-hcr">
-    <td class="title">New option to disable HCR</td>
+    <td class="title">New option to disable Hot Code Replace</td>
     <td class="content">
       You can now disable <a href="https://wiki.eclipse.org/FAQ_What_is_hot_code_replace%3F" target="_blank">Hot Code Replace (HCR)</a> if it causes any trouble
       or if you want to avoid code changes in a debug target. HCR is enabled by default but can be disabled
diff --git a/bundles/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html b/bundles/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html
index 949c5a120..46ab2066c 100644
--- a/bundles/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html
+++ b/bundles/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html
@@ -51,7 +51,7 @@ document in the plug-in developer's guide.</p>
         A new extensible <b>Generic Editor</b> has been added which makes it easier 
         to implement an editor for new languages or new content types. It reuses 
         the existing Eclipse editor infrastructure. The generic editor can be extended using 
-        extension points instead of implementing an editor to  supply required functionality.
+        extension points instead of implementing an editor to supply required functionality.
       </td>
     </tr>
 
@@ -181,6 +181,7 @@ document in the plug-in developer's guide.</p>
       	      terminating the group will also terminate this launch). Any configured post launch
       	      action will still be executed!</li>      
       </ul>
+      Note that this is similar to the launch group in CDT, but with additional features.
       <p>
         New launch groups can be created via the <b>Run > Run Configurations...</b> or <b>Run > Debug Configurations...</b> dialogs.<br/>
         <img src="images/launch-groups.png" alt=""/>
@@ -795,6 +796,13 @@ document in the plug-in developer's guide.</p>
 	  </p>
     </td>
   </tr>
+  
+  <tr id="java-9">
+    <td class="title">Java 9 previews</td>
+    <td class="content">
+      You have to configure Eclipse Oxygen to work with Java 9. Please read this <a href="https://wiki.eclipse.org/Configure_Eclipse_for_Java_9" target="_blank">wiki</a> for the details.
+    </td>
+  </tr>
 
 </tbody>
 </table>