From 41dba14fdcc7286f8290f44b03459e04ec6bd7d5 Mon Sep 17 00:00:00 2001
From: Sarika Sinha <sarika.sinha@in.ibm.com>
Date: Wed, 24 Aug 2022 18:44:51 +0530
Subject: [PATCH] Update Readme for RCP (#90)

https://github.com/eclipse-platform/www.eclipse.org-eclipse/issues/15
---
 .../rootfiles/readme/readme_eclipse.html      | 102 +++++++++---------
 1 file changed, 51 insertions(+), 51 deletions(-)

diff --git a/features/org.eclipse.rcp/rootfiles/readme/readme_eclipse.html b/features/org.eclipse.rcp/rootfiles/readme/readme_eclipse.html
index debcb2fa4..64b284853 100644
--- a/features/org.eclipse.rcp/rootfiles/readme/readme_eclipse.html
+++ b/features/org.eclipse.rcp/rootfiles/readme/readme_eclipse.html
@@ -4,9 +4,9 @@
 <meta
   http-equiv="Content-Type"
   content="text/html; charset=UTF-8" />
-<title>Eclipse Project Release Notes 4.24</title>
+<title>Eclipse Project Release Notes 4.25</title>
 <!-- Please validate as "xhtml1 strict", at
-https://validator.w3.org/check?uri=http%3A%2F%2Fwww.eclipse.org%2Feclipse%2Fdevelopment%2Freadme_eclipse_4.24.html;ss=1
+https://validator.w3.org/check?uri=http%3A%2F%2Fwww.eclipse.org%2Feclipse%2Fdevelopment%2Freadme_eclipse_4.25.html;ss=1
 (It must be "on website" to validate.)
 -->
 </head>
@@ -19,12 +19,12 @@ <h1>
   <p>
     <a
       class="mozTocH1"
-      name="mozTocId299852">Release 4.24</a>
+      name="mozTocId299852">Release 4.25</a>
   </p>
   <p>
     <a
       class="mozTocH1"
-      name="mozTocId299852">Last revised May 24, 2022</a>
+      name="mozTocId299852">Last revised Aug 24, 2022</a>
   </p>
   <!-- 
 This following link to www.eclipse.org should be commented out
@@ -34,7 +34,7 @@ <h1>
 to "the latest version" since there _might_ be changes made 
 after the release.
   <p>
-    The latest version of this document can be found on the web at <a href="https://www.eclipse.org/eclipse/development/readme_eclipse_4.24.php">Eclipse Release Notes 4.24</a>. There may or may
+    The latest version of this document can be found on the web at <a href="https://www.eclipse.org/eclipse/development/readme_eclipse_4.25.php">Eclipse Release Notes 4.25</a>. There may or may
     not be changes made after the product is released. You can tell by checking the "last revised" date near the top of this page.
   </p>
 -->
@@ -57,7 +57,7 @@ <h2 id="TargetOperatingEnvironments1">
         <li><a href="#mozTocId315234">Target Operating Environments</a></li>
         <li><a href="#mozTocId569479">Compatibility with Previous Releases</a>
           <ol>
-            <li><a href="#mozTocId324309">Compatibility of Release 4.24 with 4.23</a></li>
+            <li><a href="#mozTocId324309">Compatibility of Release 4.25 with 4.24</a></li>
           </ol></li>
         <li><a href="#mozTocId214943">Known Issues</a>
           <ol>
@@ -159,10 +159,10 @@ <h2 id="TargetOperatingEnvironments1">
           </ol></li>
         <li><a href="#mozTocId638978">Interoperability with Previous Releases</a>
           <ol>
-            <li><a href="#mozTocId759237">Interoperability of Release 4.24 with previous releases</a>
+            <li><a href="#mozTocId759237">Interoperability of Release 4.25 with previous releases</a>
               <ol>
-                <li><a href="#mozTocId226004">Sharing projects between heterogeneous Eclipse 4.24 and 4.23</a></li>
-                <li><a href="#mozTocId574781">Using Eclipse 4.24 to develop plug-ins that work in Eclipse 4.23</a></li>
+                <li><a href="#mozTocId226004">Sharing projects between heterogeneous Eclipse 4.25 and 4.24</a></li>
+                <li><a href="#mozTocId574781">Using Eclipse 4.25 to develop plug-ins that work in Eclipse 4.24</a></li>
               </ol>
             </li>
           </ol></li>
@@ -176,7 +176,7 @@ <h2 id="TargetOperatingEnvironments2">
   <p>Most of the Eclipse SDK is "pure" 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 4.24 release of the Eclipse Project is developed on Java SE 11 VMs. As such, the Eclipse SDK as a whole is targeted at all modern, desktop Java VMs.</p>
+  <p>In general, the 4.25 release of the Eclipse Project is developed on Java SE 11 VMs. As such, the Eclipse SDK as a whole is targeted at all modern, desktop Java VMs.</p>
   <p>
     <a href="#appendix">Appendix 1</a> contains a table that indicates the class library level required for each bundle.
   </p>
@@ -187,9 +187,9 @@ <h2 id="TargetOperatingEnvironments2">
     problems with running Eclipse on a reference platform.
   </p>
   <p>
-    Eclipse 4.24 is tested and validated on a number of reference platforms. For the complete list, see <a
-      href="https://www.eclipse.org/projects/project-plan.php?planurl=https://www.eclipse.org/eclipse/development/plans/eclipse_project_plan_4_24.xml#target_environments">Target Environments in the
-      4.24 Plan</a>.
+    Eclipse 4.25 is tested and validated on a number of reference platforms. For the complete list, see <a
+      href="https://www.eclipse.org/projects/project-plan.php?planurl=https://www.eclipse.org/eclipse/development/plans/eclipse_project_plan_4_25.xml#target_environments">Target Environments in the
+      4.25 Plan</a>.
   </p>
   <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
@@ -208,42 +208,42 @@ <h2 id="Compatibility">
   <h3>
     <a
       class="mozTocH3"
-      name="mozTocId324309">Compatibility of Release 4.24 with 4.23</a>
+      name="mozTocId324309">Compatibility of Release 4.25 with 4.24</a>
   </h3>
   <p>
     <a
       class="mozTocH3"
-      name="mozTocId324309">Eclipse 4.24 is compatible with Eclipse 4.23 (and all earlier 4.x and 3.x versions).</a>
+      name="mozTocId324309">Eclipse 4.25 is compatible with Eclipse 4.24 (and all earlier 4.x and 3.x versions).</a>
   </p>
   <p>
     <a
       class="mozTocH3"
-      name="mozTocId324309"> <strong>API Contract Compatibility:</strong> Eclipse SDK 4.24 is upwards contract-compatible with Eclipse SDK 4.23 except in those areas noted in the
-    </a><a href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_24_porting_guide.html"><em>Eclipse 4.24 Plug-in Migration Guide</em></a>. Programs that use affected APIs and extension points
-    will need to be ported to Eclipse SDK 4.24 APIs. Downward contract compatibility is not supported. There is no guarantee that compliance with Eclipse SDK 4.24 APIs would ensure compliance with
-    Eclipse SDK 4.23 APIs. Refer to <a href="https://wiki.eclipse.org/Evolving_Java-based_APIs"><em>Evolving Java-based APIs</em></a> for a discussion of the kinds of API changes that maintain contract
+      name="mozTocId324309"> <strong>API Contract Compatibility:</strong> Eclipse SDK 4.25 is upwards contract-compatible with Eclipse SDK 4.24 except in those areas noted in the
+    </a><a href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_25_porting_guide.html"><em>Eclipse 4.25 Plug-in Migration Guide</em></a>. Programs that use affected APIs and extension points
+    will need to be ported to Eclipse SDK 4.25 APIs. Downward contract compatibility is not supported. There is no guarantee that compliance with Eclipse SDK 4.25 APIs would ensure compliance with
+    Eclipse SDK 4.24 APIs. Refer to <a href="https://wiki.eclipse.org/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 4.24 is upwards binary-compatible with Eclipse SDK 4.23 except in those areas noted in the <a
-      href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_24_porting_guide.html"><em>Eclipse 4.24 Plug-in Migration Guide</em> </a>. Downward plug-in compatibility is not supported.
-    Plug-ins for Eclipse SDK 4.24 will not be usable in Eclipse SDK 4.23. Refer to <a href="https://wiki.eclipse.org/Evolving_Java-based_APIs"> <em>Evolving Java-based APIs</em></a> for a discussion of
+    <strong>Binary (plug-in) Compatibility:</strong> Eclipse SDK 4.25 is upwards binary-compatible with Eclipse SDK 4.24 except in those areas noted in the <a
+      href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_25_porting_guide.html"><em>Eclipse 4.25 Plug-in Migration Guide</em> </a>. Downward plug-in compatibility is not supported.
+    Plug-ins for Eclipse SDK 4.25 will not be usable in Eclipse SDK 4.24. Refer to <a href="https://wiki.eclipse.org/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 4.24 is upwards source-compatible with Eclipse SDK 4.23 except in the areas noted in the <a
-      href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_24_porting_guide.html"><em>Eclipse 4.24 Plug-in Migration Guide</em> </a>. This means that source files written to use Eclipse
-    SDK 4.24 APIs might successfully compile and run against Eclipse SDK 4.23 APIs, although this is not guaranteed. Downward source compatibility is not supported. If source files use new Eclipse SDK
+    <strong>Source Compatibility:</strong> Eclipse SDK 4.25 is upwards source-compatible with Eclipse SDK 4.24 except in the areas noted in the <a
+      href="https://www.eclipse.org/eclipse/development/porting/eclipse_4_25_porting_guide.html"><em>Eclipse 4.25 Plug-in Migration Guide</em> </a>. This means that source files written to use Eclipse
+    SDK 4.25 APIs might successfully compile and run against Eclipse SDK 4.24 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 4.24 is upwards workspace-compatible with earlier 3.x and 4.x versions of the Eclipse SDK unless noted. This means that workspaces and projects
-    created with Eclipse SDK 4.23, 4.22, 4.21, 4.20, 4.19, 4.18, 4.17, 4.16, 4.15, 4.14, 4.13, 4.12, 4.11, 4.10, 4.9, 4.8, 4.7, 4.6, 4.5 and 4.4 can be successfully opened by Eclipse SDK 4.24 and upgraded to a 4.24 workspace. This includes both hidden metadata, which is localized to a
+    <strong>Workspace Compatibility:</strong> Eclipse SDK 4.25 is upwards workspace-compatible with earlier 3.x and 4.x versions of the Eclipse SDK unless noted. This means that workspaces and projects
+    created with Eclipse SDK 4.24, 4.23, 4.22, 4.21, 4.20, 4.19, 4.18, 4.17, 4.16, 4.15, 4.14, 4.13, 4.12, 4.11, 4.10, 4.9, 4.8, 4.7, 4.6, 4.5 and 4.4 can be successfully opened by Eclipse SDK 4.25 and upgraded to a 4.25 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 4.24 should provide similar upwards compatibility for their hidden and visible workspace metadata created by earlier versions; 4.24 plug-in developers are
+    plug-ins developed for Eclipse SDK 4.25 should provide similar upwards compatibility for their hidden and visible workspace metadata created by earlier versions; 4.25 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 4.24 will be unusable with a product based on an earlier version of Eclipse. Visible
-    metadata files created (or overwritten) by Eclipse 4.24 will generally be unusable with earlier versions of Eclipse.
+    Downward workspace compatibility is not supported. A workspace created (or opened) by a product based on Eclipse 4.25 will be unusable with a product based on an earlier version of Eclipse. Visible
+    metadata files created (or overwritten) by Eclipse 4.25 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 "internal" in its name or x-internal in the bundle manifest entry, are
@@ -279,7 +279,7 @@ <h4>
   <ul>
     <li><a
       class="mozTocH4"
-      name="mozTocId693657">As shown </a><a href="#TargetOperatingEnvironments">above</a>, Eclipse 4.24 requires at least a Java SE 11. Perhaps an older version of the VM is being found in your path. To
+      name="mozTocId693657">As shown </a><a href="#TargetOperatingEnvironments">above</a>, Eclipse 4.25 requires at least a Java SE 11. Perhaps an older version of the VM is being found in your path. To
       explicitly specify which VM to run with, use the Eclipse <code>-vm</code> command-line argument. (See also the <a href="#RunningEclipse">Running Eclipse</a> section below.)</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>.
@@ -1106,7 +1106,7 @@ <h2 id="RunningEclipse">
       class="mozTocH2"
       name="mozTocId19817"> 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 11 JRE,
       not included with the Eclipse SDK). With Oomph users can install required JRE courtesy of <a href="https://www.eclipse.org/justj/">JustJ</a>. 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-4.24-win64</code> , the executable is <code>c:\eclipse-SDK-4.24-win64\eclipse\eclipse.exe</code> . <b>Note:</b> Set-up on most other operating environments is analogous.
+      <code>c:\eclipse-SDK-4.25-win64</code> , the executable is <code>c:\eclipse-SDK-4.25-win64\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><a href="#macosx">below</a>.
   </p>
@@ -1352,66 +1352,66 @@ <h2 id="InteroperabilityWithPreviousReleases">
   <h3>
     <a
       class="mozTocH3"
-      name="mozTocId759237">Interoperability of Release 4.24 with previous releases</a>
+      name="mozTocId759237">Interoperability of Release 4.25 with previous releases</a>
   </h3>
   <h4>
     <a
       class="mozTocH4"
-      name="mozTocId226004">Sharing projects between heterogeneous Eclipse 4.24 and 4.23</a>
+      name="mozTocId226004">Sharing projects between heterogeneous Eclipse 4.25 and 4.24</a>
   </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 4.24 while others are working in Eclipse 3.x, there are no such guarantees. This section provides advice for what to do and not to do. It addresses the
+    when some developers are working in Eclipse 4.25 while others are working in Eclipse 3.x, 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 4.24 user. 4.23 metadata is lost when a 4.24 user saves changes and then commits the updated metadata files to the repository. Here's how things
+  <p>The typical failure mode is noticed by the 4.25 user. 4.24 metadata is lost when a 4.25 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 4.24 creates or modifies a project in a way that results in changes to a shared metadata file that rely on 4.24-specific information. The user then commits the
+    <li>A user working in Eclipse 4.25 creates or modifies a project in a way that results in changes to a shared metadata file that rely on 4.25-specific information. The user then commits the
       updated project files, including the shared metadata file, to the shared repository.</li>
     <li><a
       class="mozTocH4"
-      name="mozTocId226004">Another user working in Eclipse 4.23 or earlier shares this project from the same repository. The 4.24-specific information in the shared metadata file is not understood
-        by Eclipse 4.23, 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 4.24-specific information. The user commits the updated project files, including the shared metadata file, to the shared repository. The user is
+      name="mozTocId226004">Another user working in Eclipse 4.24 or earlier shares this project from the same repository. The 4.25-specific information in the shared metadata file is not understood
+        by Eclipse 4.24, 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 4.25-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.</a></li>
     <li><a
       class="mozTocH4"
-      name="mozTocId226004">A user working in Eclipse 4.24 picks up the changes to a project from the shared repository, including the updated shared metadata file. The user may be unaware that
+      name="mozTocId226004">A user working in Eclipse 4.25 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.</a></li>
   </ul>
   <p>
     <a
       class="mozTocH4"
-      name="mozTocId226004">Here are some things to watch out for when sharing projects between Eclipse 4.24 and earlier releases:</a>
+      name="mozTocId226004">Here are some things to watch out for when sharing projects between Eclipse 4.25 and earlier releases:</a>
   </p>
   <ul>
     <li><a
       class="mozTocH4"
-      name="mozTocId226004"><b>Virtual folders</b> - Eclipse 4.24 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
-        4.24, 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
+      name="mozTocId226004"><b>Virtual folders</b> - Eclipse 4.25 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
+        4.25, 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.</a></li>
     <li><a
       class="mozTocH4"
-      name="mozTocId226004"><b>Resource filters</b> - Eclipse 4.24 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 4.24, 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
+      name="mozTocId226004"><b>Resource filters</b> - Eclipse 4.25 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 4.25, 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.</a></li>
     <li><a
       class="mozTocH4"
-      name="mozTocId226004"><b>Predefined path variables</b> - Eclipse 4.24 supports a set of built in path variables that can be used as the basis for linked resource locations. Such variables
+      name="mozTocId226004"><b>Predefined path variables</b> - Eclipse 4.25 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.</a></li>
   </ul>
   <h4>
     <a
       class="mozTocH4"
-      name="mozTocId574781">Using Eclipse 4.24 to develop plug-ins that work in Eclipse 4.23</a>
+      name="mozTocId574781">Using Eclipse 4.25 to develop plug-ins that work in Eclipse 4.24</a>
   </h4>
   <p>
     <a
       class="mozTocH4"
-      name="mozTocId574781"> It is also possible (and reasonable) to use Eclipse 4.24 to develop a plug-in intended to work in Eclipse 4.23 or earlier. Use the <b>Plug-in Development &gt; Target
-        Platform </b>preference page to locate non-workspace plug-ins in an Eclipse 4.23 install. This ensures that the code for your plug-in is being compiled and tested against Eclipse 4.23 APIs,
+      name="mozTocId574781"> It is also possible (and reasonable) to use Eclipse 4.25 to develop a plug-in intended to work in Eclipse 4.24 or earlier. Use the <b>Plug-in Development &gt; Target
+        Platform </b>preference page to locate non-workspace plug-ins in an Eclipse 4.24 install. This ensures that the code for your plug-in is being compiled and tested against Eclipse 4.24 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.)
     </a>
@@ -1424,4 +1424,4 @@ <h4>
   <p>Other company, product, and service names may be trademarks or service marks of others.</p>
   <p>(c) Copyright Eclipse Contributors 2009, 2022</p>
 </body>
-</html>
+</html>
\ No newline at end of file