Skip to content

Commit 139d6f4

Browse files
subyssurendran666subyssurendran666
authored
Migration guide for Eclipse 4.36 from 4.35 (#3061)
1 parent 2e975ef commit 139d6f4

File tree

10 files changed

+245
-18
lines changed

10 files changed

+245
-18
lines changed

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/faq.html

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
8+
<title>Eclipse JDT 4.36 Plug-in Migration FAQ</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse JDT 4.36 Plug-in Migration FAQ</h1>
14+
15+
<ol>
16+
<li>None</li>
17+
</ol>
18+
19+
</body>
20+
</html>

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/incompatibilities.html

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../../book.css" type="text/css">
8+
<title>Incompatibilities between Eclipse 4.35 and 4.36</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.35 and 4.36</h1>
12+
13+
<p>
14+
So far Eclipse did not change incompatibly between 4.35 and 4.36 in ways that affect
15+
plug-ins. Plug-ins that ran on 4.35 should run on 4.36 without any problems.
16+
</p>
17+
18+
</body>
19+
</html>

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.36/recommended.html

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
8+
<title>Adopting JDT 4.36 mechanisms and APIs</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Adopting JDT 4.36 Mechanisms and APIs</h1>
14+
<p>
15+
This section describes changes that are required if you are trying to change
16+
your 4.35 plug-in to adopt the 4.36 mechanisms and APIs.
17+
</p>
18+
19+
<ol>
20+
<li>None</li>
21+
</ol>
22+
</body>
23+
</html>

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_36_porting_guide.html

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
4+
<head>
5+
6+
<meta name="copyright" content="Copyright (c) IBM 2025 Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
7+
8+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
9+
<meta http-equiv="Content-Style-Type" content="text/css">
10+
<link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
11+
<title>Eclipse JDT 4.36 Plug-in Migration Guide</title>
12+
</head>
13+
14+
<body>
15+
16+
<h1>Eclipse JDT 4.36 Plug-in Migration Guide</h1>
17+
<p>This guide covers migrating Eclipse JDT 4.35 plug-ins to Eclipse JDT 4.36.</p>
18+
<p>One of the goals of Eclipse 4.36 was to move Eclipse forward while remaining compatible
19+
with previous versions to the greatest extent possible. That is, plug-ins written
20+
against the Eclipse 4.35 APIs should continue to work in 4.36 in spite of the
21+
API changes.</p>
22+
<p>The key kinds of compatibility are API contract compatibility and binary compatibility.
23+
API contract compatibility means that valid use of 4.35 APIs remains valid for
24+
4.36, so there is no need to revisit working code. Binary compatibility means
25+
that the API method signatures, etc. did not change in ways that would cause
26+
existing compiled (&quot;binary&quot;) code to no longer link and run with the
27+
new 4.36 libraries.</p>
28+
<p>While every effort was made to avoid breakage, there are a few areas of incompatibility or new
29+
APIs that should be adopted by clients.
30+
This document describes those areas and provides instructions for migrating 4.35 plug-ins to
31+
4.36.</p>
32+
<ul>
33+
<li><a href="4.36/faq.html">Eclipse JDT 4.36 Plug-in Migration FAQ</a></li>
34+
<li><a href="4.36/incompatibilities.html">Incompatibilities between Eclipse JDT 4.35 and 4.36</a></li>
35+
<li><a href="4.36/recommended.html">Adopting 4.36 mechanisms and API</a></li>
36+
</ul>
37+
38+
</body>
39+
</html>

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,17 @@
44
<!-- Define topics for the porting guide index -->
55
<!-- ============================================================================= -->
66
<toc label="Migration">
7+
<topic label="Migrating to Eclipse JDT 4.36 from 4.35">
8+
<topic label="Introduction" href="porting/eclipse_4_36_porting_guide.html"/>
9+
<topic label="FAQ" href="porting/4.36/faq.html" />
10+
<topic label="Incompatibilities" href="porting/4.36/incompatibilities.html" />
11+
<topic label="Adopting 4.36 Mechanisms and API" href="porting/4.36/recommended.html" />
12+
</topic>
713
<topic label="Migrating to Eclipse JDT 4.35 from 4.34">
814
<topic label="Introduction" href="porting/eclipse_4_35_porting_guide.html"/>
915
<topic label="FAQ" href="porting/4.35/faq.html" />
1016
<topic label="Incompatibilities" href="porting/4.35/incompatibilities.html" />
11-
<topic label="Adopting 4.34 Mechanisms and API" href="porting/4.35/recommended.html" />
17+
<topic label="Adopting 4.35 Mechanisms and API" href="porting/4.35/recommended.html" />
1218
</topic>
1319
<topic label="Migrating to Eclipse JDT 4.34 from 4.33">
1420
<topic label="Introduction" href="porting/eclipse_4_34_porting_guide.html"/>
@@ -27,15 +33,15 @@
2733
<topic label="FAQ" href="porting/4.32/faq.html" />
2834
<topic label="Incompatibilities" href="porting/4.32/incompatibilities.html" />
2935
<topic label="Adopting 4.32 Mechanisms and API" href="porting/4.32/recommended.html" />
30-
</topic>
31-
<topic label="Migrating to Eclipse JDT 4.31 from 4.30">
32-
<topic label="Introduction" href="porting/eclipse_4_31_porting_guide.html"/>
33-
<topic label="FAQ" href="porting/4.31/faq.html" />
34-
<topic label="Incompatibilities" href="porting/4.31/incompatibilities.html" />
35-
<topic label="Adopting 4.31 Mechanisms and API" href="porting/4.31/recommended.html" />
3636
</topic>
3737
<topic label="Older Migration Guides">
38-
<topic label="Migrating to Eclipse JDT 4.30 from 4.29">
38+
<topic label="Migrating to Eclipse JDT 4.31 from 4.30">
39+
<topic label="Introduction" href="porting/eclipse_4_31_porting_guide.html"/>
40+
<topic label="FAQ" href="porting/4.31/faq.html" />
41+
<topic label="Incompatibilities" href="porting/4.31/incompatibilities.html" />
42+
<topic label="Adopting 4.31 Mechanisms and API" href="porting/4.31/recommended.html" />
43+
</topic>
44+
<topic label="Migrating to Eclipse JDT 4.30 from 4.29">
3945
<topic label="Introduction" href="porting/eclipse_4_30_porting_guide.html"/>
4046
<topic label="FAQ" href="porting/4.30/faq.html" />
4147
<topic label="Incompatibilities" href="porting/4.30/incompatibilities.html" />

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/faq.html

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
8+
<title>Eclipse 4.36 Plug-in Migration FAQ</title>
9+
</head>
10+
<body>
11+
<h1>Eclipse 4.36 Plug-in Migration FAQ</h1>
12+
</body>
13+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/incompatibilities.html

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../../book.css" type="text/css">
8+
<title>Incompatibilities between Eclipse 4.35 and 4.36</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.35 and 4.36</h1>
12+
13+
<p>
14+
Eclipse changed in incompatible ways between 4.35 and 4.36 in ways that affect
15+
plug-ins. The following entries describe the areas that changed and provide
16+
instructions for migrating 4.35 plug-ins to 4.36. Note that you only need to look
17+
here if you are experiencing problems running your 4.35 plug-in on 4.36.
18+
</p>
19+
<p>
20+
See also the list of <a href="../removals.html">deprecated API removals</a> for this release.
21+
</p>
22+
23+
<ol>
24+
<li><a href="#upstream-bundles">Several bundles renamed for 3rd party libraries</a></li>
25+
</ol>
26+
27+
<hr>
28+
29+
<!-- ############################################## -->
30+
31+
<h2>1. <a name="native-fragments-merge">Multiple Platform-specific Fragments Merged Into Their Host</a></h2>
32+
<p>
33+
The following platform-specific fragments have been merged into their respective host bundle:
34+
<ul>
35+
<li><code>org.eclipse.core.resources.win32.win32.x86_64</code></li>
36+
<li><code>org.eclipse.core.filesystem.win32.x86_64</code></li>
37+
<li><code>org.eclipse.core.net.linux</code></li>
38+
<li><code>org.eclipse.core.net.win32</code></li>
39+
</ul>
40+
</p>
41+
<p>
42+
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.
43+
If any of the mentioned fragments is referenced in a PDE <em>feature.xml</em> or listed as content of a product definition it just has to be removed.
44+
</p>
45+
46+
</body>
47+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.36/recommended.html

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
4+
<head>
5+
<meta name="copyright"
6+
content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
7+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
8+
<meta http-equiv="Content-Style-Type" content="text/css">
9+
<link rel="STYLESHEET" href="../../book.css" type="text/css">
10+
<title>Adopting 4.36 mechanisms and APIs</title>
11+
</head>
12+
13+
<body>
14+
<h1>Adopting 4.36 Mechanisms and APIs</h1>
15+
16+
<p>This section describes changes that are required if you are
17+
trying to change your 4.35 plug-in to adopt the 4.36 mechanisms and
18+
APIs.</p>
19+
20+
<!-- ##############################################
21+
############################################## -->
22+
23+
</body>
24+
25+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_36_porting_guide.html

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2+
<html lang="en">
3+
<head>
4+
<meta name="copyright" content="Copyright (c) 2025 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
5+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6+
<meta http-equiv="Content-Style-Type" content="text/css">
7+
<link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
8+
<title>Eclipse 4.36 Plug-in Migration Guide</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse 4.36 Plug-in Migration Guide</h1>
14+
<p>This guide covers migrating Eclipse 4.35 plug-ins to Eclipse 4.36.</p>
15+
<p>One of the goals of Eclipse 4.36 was to move Eclipse forward while remaining compatible
16+
with previous versions to the greatest extent possible. That is, plug-ins written
17+
against the Eclipse 4.35 APIs should continue to work in 4.36 in spite of any API changes.</p>
18+
<p>The key kinds of compatibility are API contract compatibility and binary compatibility.
19+
API contract compatibility means that valid use of 4.35 APIs remains valid for
20+
4.36, so there is no need to revisit working code. Binary compatibility means
21+
that the API method signatures, etc. did not change in ways that would cause
22+
existing compiled (&quot;binary&quot;) code to no longer link and run with the
23+
new 4.36 libraries.</p>
24+
<p>While every effort was made to avoid breakage, there are a few areas of incompatibility or new
25+
APIs that should be adopted by clients.
26+
This document describes those areas and provides instructions for migrating 4.35 plug-ins to
27+
4.36.</p>
28+
<ul>
29+
<li><a href="4.36/faq.html">Eclipse 4.36 Plug-in Migration FAQ</a></li>
30+
<li><a href="4.36/incompatibilities.html">Incompatibilities between Eclipse 4.35 and 4.36</a></li>
31+
<li><a href="4.36/recommended.html">Adopting 4.36 mechanisms and API</a></li>
32+
</ul>
33+
34+
</body>
35+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,29 +5,35 @@
55
<!-- ============================================================================= -->
66
<toc label="Migration">
77
<topic label="Deprecated API removals" href="porting/removals.html"/>
8+
<topic label="Migrating to Eclipse 4.36 from 4.35">
9+
<topic label="Introduction" href="porting/eclipse_4_36_porting_guide.html"/>
10+
<topic label="FAQ" href="porting/4.36/faq.html" />
11+
<topic label="Incompatibilities" href="porting/4.36/incompatibilities.html" />
12+
<topic label="Adopting 4.36 mechanisms and API" href="porting/4.36/recommended.html" />
13+
</topic>
814
<topic label="Migrating to Eclipse 4.35 from 4.34">
915
<topic label="Introduction" href="porting/eclipse_4_35_porting_guide.html"/>
1016
<topic label="FAQ" href="porting/4.35/faq.html" />
1117
<topic label="Incompatibilities" href="porting/4.35/incompatibilities.html" />
12-
<topic label="Adopting 4.34 mechanisms and API" href="porting/4.35/recommended.html" />
18+
<topic label="Adopting 4.35 mechanisms and API" href="porting/4.35/recommended.html" />
1319
</topic>
1420
<topic label="Migrating to Eclipse 4.34 from 4.33">
1521
<topic label="Introduction" href="porting/eclipse_4_34_porting_guide.html"/>
1622
<topic label="FAQ" href="porting/4.34/faq.html" />
1723
<topic label="Incompatibilities" href="porting/4.34/incompatibilities.html" />
18-
<topic label="Adopting 4.33 mechanisms and API" href="porting/4.34/recommended.html" />
24+
<topic label="Adopting 4.34 mechanisms and API" href="porting/4.34/recommended.html" />
1925
</topic>
2026
<topic label="Migrating to Eclipse 4.33 from 4.32">
2127
<topic label="Introduction" href="porting/eclipse_4_33_porting_guide.html"/>
2228
<topic label="FAQ" href="porting/4.33/faq.html" />
2329
<topic label="Incompatibilities" href="porting/4.33/incompatibilities.html" />
24-
<topic label="Adopting 4.32 mechanisms and API" href="porting/4.33/recommended.html" />
30+
<topic label="Adopting 4.33 mechanisms and API" href="porting/4.33/recommended.html" />
2531
</topic>
2632
<topic label="Migrating to Eclipse 4.32 from 4.31">
2733
<topic label="Introduction" href="porting/eclipse_4_32_porting_guide.html"/>
2834
<topic label="FAQ" href="porting/4.32/faq.html" />
2935
<topic label="Incompatibilities" href="porting/4.32/incompatibilities.html" />
30-
<topic label="Adopting 4.31 mechanisms and API" href="porting/4.32/recommended.html" />
36+
<topic label="Adopting 4.32 mechanisms and API" href="porting/4.32/recommended.html" />
3137
</topic>
3238
<topic label="Migrating to Eclipse 4.31 from 4.30">
3339
<topic label="Introduction" href="porting/eclipse_4_31_porting_guide.html"/>
@@ -60,12 +66,6 @@
6066
<topic label="Incompatibilities" href="porting/4.27/incompatibilities.html" />
6167
<topic label="Adopting 4.27 mechanisms and API" href="porting/4.27/recommended.html" />
6268
</topic>
63-
<topic label="Migrating to Eclipse 4.27 from 4.26">
64-
<topic label="Introduction" href="porting/eclipse_4_27_porting_guide.html"/>
65-
<topic label="FAQ" href="porting/4.27/faq.html" />
66-
<topic label="Incompatibilities" href="porting/4.27/incompatibilities.html" />
67-
<topic label="Adopting 4.27 mechanisms and API" href="porting/4.27/recommended.html" />
68-
</topic>
6969
<topic label="Migrating to Eclipse 4.26 from 4.25">
7070
<topic label="Introduction" href="porting/eclipse_4_26_porting_guide.html"/>
7171
<topic label="FAQ" href="porting/4.26/faq.html" />

0 commit comments

Comments
 (0)