From 2628adc9ce40055d5d800ab796500238f2885e1f Mon Sep 17 00:00:00 2001 From: Suby S Surendran Date: Tue, 27 May 2025 07:15:47 +0530 Subject: [PATCH] Migration guide for Eclipse 4.36 from 4.35 --- .../porting/4.36/faq.html | 20 ++++++++ .../porting/4.36/incompatibilities.html | 19 ++++++++ .../porting/4.36/recommended.html | 23 +++++++++ .../porting/eclipse_4_36_porting_guide.html | 39 +++++++++++++++ .../topics_Porting.xml | 22 +++++---- .../porting/4.36/faq.html | 13 +++++ .../porting/4.36/incompatibilities.html | 47 +++++++++++++++++++ .../porting/4.36/recommended.html | 25 ++++++++++ .../porting/eclipse_4_36_porting_guide.html | 35 ++++++++++++++ .../topics_Porting.xml | 20 ++++---- 10 files changed, 245 insertions(+), 18 deletions(-) create mode 100644 eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/faq.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/incompatibilities.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/recommended.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_36_porting_guide.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/faq.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/incompatibilities.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/recommended.html create mode 100644 eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_36_porting_guide.html diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/faq.html b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/faq.html new file mode 100644 index 00000000000..11f8d579a43 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/faq.html @@ -0,0 +1,20 @@ + + + + + + + +Eclipse JDT 4.36 Plug-in Migration FAQ + + + + +

Eclipse JDT 4.36 Plug-in Migration FAQ

+ +
    +
  1. None
    2. +
+ + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/incompatibilities.html b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/incompatibilities.html new file mode 100644 index 00000000000..a5c4c1c7116 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/incompatibilities.html @@ -0,0 +1,19 @@ + + + + + + + +Incompatibilities between Eclipse 4.35 and 4.36 + + +

Incompatibilities Between Eclipse 4.35 and 4.36

+ +

+ So far Eclipse did not change incompatibly between 4.35 and 4.36 in ways that affect + plug-ins. Plug-ins that ran on 4.35 should run on 4.36 without any problems. +

+ + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/recommended.html b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/recommended.html new file mode 100644 index 00000000000..e83c1d4af31 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/recommended.html @@ -0,0 +1,23 @@ + + + + + + + +Adopting JDT 4.36 mechanisms and APIs + + + + +

Adopting JDT 4.36 Mechanisms and APIs

+

+ This section describes changes that are required if you are trying to change + your 4.35 plug-in to adopt the 4.36 mechanisms and APIs. +

+ +
    +
  1. None
    2. +
+ + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_36_porting_guide.html b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_36_porting_guide.html new file mode 100644 index 00000000000..7c1156952b1 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_36_porting_guide.html @@ -0,0 +1,39 @@ + + + + + + + + + + +Eclipse JDT 4.36 Plug-in Migration Guide + + + + +

Eclipse JDT 4.36 Plug-in Migration Guide

+

This guide covers migrating Eclipse JDT 4.35 plug-ins to Eclipse JDT 4.36.

+

One of the goals of Eclipse 4.36 was to move Eclipse forward while remaining compatible + with previous versions to the greatest extent possible. That is, plug-ins written + against the Eclipse 4.35 APIs should continue to work in 4.36 in spite of the + API changes.

+

The key kinds of compatibility are API contract compatibility and binary compatibility. + API contract compatibility means that valid use of 4.35 APIs remains valid for + 4.36, so there is no need to revisit working code. Binary compatibility means + that the API method signatures, etc. did not change in ways that would cause + existing compiled ("binary") code to no longer link and run with the + new 4.36 libraries.

+

While every effort was made to avoid breakage, there are a few areas of incompatibility or new + APIs that should be adopted by clients. + This document describes those areas and provides instructions for migrating 4.35 plug-ins to + 4.36.

+ + + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml index 41934ca3ae3..695884415fb 100644 --- a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml +++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml @@ -4,11 +4,17 @@ + + + + + + - + @@ -27,15 +33,15 @@ - - - - - - - + + + + + + + diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/faq.html b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/faq.html new file mode 100644 index 00000000000..4459f72ef1b --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/faq.html @@ -0,0 +1,13 @@ + + + + + + + +Eclipse 4.36 Plug-in Migration FAQ + + +

Eclipse 4.36 Plug-in Migration FAQ

+ + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/incompatibilities.html b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/incompatibilities.html new file mode 100644 index 00000000000..321d43225a2 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/incompatibilities.html @@ -0,0 +1,47 @@ + + + + + + + +Incompatibilities between Eclipse 4.35 and 4.36 + + +

Incompatibilities Between Eclipse 4.35 and 4.36

+ +

+ Eclipse changed in incompatible ways between 4.35 and 4.36 in ways that affect + plug-ins. The following entries describe the areas that changed and provide + instructions for migrating 4.35 plug-ins to 4.36. Note that you only need to look + here if you are experiencing problems running your 4.35 plug-in on 4.36. +

+

+See also the list of deprecated API removals for this release. +

+ +
    +
  1. Several bundles renamed for 3rd party libraries
    2. +
+ +
+ + + +

1. Multiple Platform-specific Fragments Merged Into Their Host

+

+ The following platform-specific fragments have been merged into their respective host bundle: +

    +
  • org.eclipse.core.resources.win32.win32.x86_64
    • +
  • org.eclipse.core.filesystem.win32.x86_64
    • +
  • org.eclipse.core.net.linux
    • +
  • org.eclipse.core.net.win32
    • +
+

+

+ All functionality formerly provided through these platform-specific fragments is now provided by the fragment's host bundle alone and no code change is required. + If any of the mentioned fragments is referenced in a PDE feature.xml or listed as content of a product definition it just has to be removed. +

+ + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/recommended.html b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/recommended.html new file mode 100644 index 00000000000..5e8d87e8e59 --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/recommended.html @@ -0,0 +1,25 @@ + + + + + + + + + Adopting 4.36 mechanisms and APIs + + + +

Adopting 4.36 Mechanisms and APIs

+ +

This section describes changes that are required if you are + trying to change your 4.35 plug-in to adopt the 4.36 mechanisms and + APIs.

+ + + + + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_36_porting_guide.html b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_36_porting_guide.html new file mode 100644 index 00000000000..bfecb16b15b --- /dev/null +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_36_porting_guide.html @@ -0,0 +1,35 @@ + + + + + + + +Eclipse 4.36 Plug-in Migration Guide + + + + +

Eclipse 4.36 Plug-in Migration Guide

+

This guide covers migrating Eclipse 4.35 plug-ins to Eclipse 4.36.

+

One of the goals of Eclipse 4.36 was to move Eclipse forward while remaining compatible + with previous versions to the greatest extent possible. That is, plug-ins written + against the Eclipse 4.35 APIs should continue to work in 4.36 in spite of any API changes.

+

The key kinds of compatibility are API contract compatibility and binary compatibility. + API contract compatibility means that valid use of 4.35 APIs remains valid for + 4.36, so there is no need to revisit working code. Binary compatibility means + that the API method signatures, etc. did not change in ways that would cause + existing compiled ("binary") code to no longer link and run with the + new 4.36 libraries.

+

While every effort was made to avoid breakage, there are a few areas of incompatibility or new + APIs that should be adopted by clients. + This document describes those areas and provides instructions for migrating 4.35 plug-ins to + 4.36.

+ + + + \ No newline at end of file diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml index d583c160203..2235d2e58c8 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml @@ -5,29 +5,35 @@ + + + + + + - + - + - + - + @@ -60,12 +66,6 @@ - - - - - -