Skip to content

Commit 6ad7788

Browse files
subyssurendran666merks
subyssurendran666
authored and
merks
committed
Migration guide for Eclipse 4.37 from 4.36
1 parent 5e88d58 commit 6ad7788

File tree

10 files changed

+237
-4
lines changed

10 files changed

+237
-4
lines changed

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.37/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.37 Plug-in Migration FAQ</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse JDT 4.37 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.37/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.36 and 4.37</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.36 and 4.37</h1>
12+
13+
<p>
14+
So far Eclipse did not change incompatibly between 4.36 and 4.37 in ways that affect
15+
plug-ins. Plug-ins that ran on 4.36 should run on 4.37 without any problems.
16+
</p>
17+
18+
</body>
19+
</html>

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.37/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.37 mechanisms and APIs</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Adopting JDT 4.37 Mechanisms and APIs</h1>
14+
<p>
15+
This section describes changes that are required if you are trying to change
16+
your 4.36 plug-in to adopt the 4.37 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_37_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.37 Plug-in Migration Guide</title>
12+
</head>
13+
14+
<body>
15+
16+
<h1>Eclipse JDT 4.37 Plug-in Migration Guide</h1>
17+
<p>This guide covers migrating Eclipse JDT 4.36 plug-ins to Eclipse JDT 4.37.</p>
18+
<p>One of the goals of Eclipse 4.37 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.36 APIs should continue to work in 4.37 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.36 APIs remains valid for
24+
4.37, 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.37 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.36 plug-ins to
31+
4.37.</p>
32+
<ul>
33+
<li><a href="4.37/faq.html">Eclipse JDT 4.37 Plug-in Migration FAQ</a></li>
34+
<li><a href="4.37/incompatibilities.html">Incompatibilities between Eclipse JDT 4.36 and 4.37</a></li>
35+
<li><a href="4.37/recommended.html">Adopting 4.37 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: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,12 @@
44
<!-- Define topics for the porting guide index -->
55
<!-- ============================================================================= -->
66
<toc label="Migration">
7+
<topic label="Migrating to Eclipse JDT 4.37 from 4.36">
8+
<topic label="Introduction" href="porting/eclipse_4_37_porting_guide.html"/>
9+
<topic label="FAQ" href="porting/4.37/faq.html" />
10+
<topic label="Incompatibilities" href="porting/4.37/incompatibilities.html" />
11+
<topic label="Adopting 4.37 Mechanisms and API" href="porting/4.37/recommended.html" />
12+
</topic>
713
<topic label="Migrating to Eclipse JDT 4.36 from 4.35">
814
<topic label="Introduction" href="porting/eclipse_4_36_porting_guide.html"/>
915
<topic label="FAQ" href="porting/4.36/faq.html" />
@@ -22,13 +28,13 @@
2228
<topic label="Incompatibilities" href="porting/4.34/incompatibilities.html" />
2329
<topic label="Adopting 4.34 Mechanisms and API" href="porting/4.34/recommended.html" />
2430
</topic>
25-
<topic label="Migrating to Eclipse JDT 4.33 from 4.32">
31+
<topic label="Migrating to Eclipse JDT 4.32 from 4.31">
32+
<topic label="Migrating to Eclipse JDT 4.33 from 4.32">
2633
<topic label="Introduction" href="porting/eclipse_4_33_porting_guide.html"/>
2734
<topic label="FAQ" href="porting/4.33/faq.html" />
2835
<topic label="Incompatibilities" href="porting/4.33/incompatibilities.html" />
2936
<topic label="Adopting 4.33 Mechanisms and API" href="porting/4.33/recommended.html" />
3037
</topic>
31-
<topic label="Migrating to Eclipse JDT 4.32 from 4.31">
3238
<topic label="Introduction" href="porting/eclipse_4_32_porting_guide.html"/>
3339
<topic label="FAQ" href="porting/4.32/faq.html" />
3440
<topic label="Incompatibilities" href="porting/4.32/incompatibilities.html" />

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.37/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.37 Plug-in Migration FAQ</title>
9+
</head>
10+
<body>
11+
<h1>Eclipse 4.37 Plug-in Migration FAQ</h1>
12+
</body>
13+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.37/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.36 and 4.37</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.36 and 4.37</h1>
12+
13+
<p>
14+
Eclipse changed in incompatible ways between 4.36 and 4.37 in ways that affect
15+
plug-ins. The following entries describe the areas that changed and provide
16+
instructions for migrating 4.36 plug-ins to 4.37. Note that you only need to look
17+
here if you are experiencing problems running your 4.36 plug-in on 4.37.
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.37/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.37 mechanisms and APIs</title>
11+
</head>
12+
13+
<body>
14+
<h1>Adopting 4.37 Mechanisms and APIs</h1>
15+
16+
<p>This section describes changes that are required if you are
17+
trying to change your 4.36 plug-in to adopt the 4.37 mechanisms and
18+
APIs.</p>
19+
20+
<!-- ##############################################
21+
############################################## -->
22+
23+
</body>
24+
1
25+
</html>

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_37_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.37 Plug-in Migration Guide</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse 4.37 Plug-in Migration Guide</h1>
14+
<p>This guide covers migrating Eclipse 4.36 plug-ins to Eclipse 4.37.</p>
15+
<p>One of the goals of Eclipse 4.37 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.36 APIs should continue to work in 4.37 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.36 APIs remains valid for
20+
4.37, 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.37 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.36 plug-ins to
27+
4.37.</p>
28+
<ul>
29+
<li><a href="4.37/faq.html">Eclipse 4.37 Plug-in Migration FAQ</a></li>
30+
<li><a href="4.37/incompatibilities.html">Incompatibilities between Eclipse 4.36 and 4.37</a></li>
31+
<li><a href="4.37/recommended.html">Adopting 4.37 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: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,12 @@
55
<!-- ============================================================================= -->
66
<toc label="Migration">
77
<topic label="Deprecated API removals" href="porting/removals.html"/>
8+
<topic label="Migrating to Eclipse 4.37 from 4.36">
9+
<topic label="Introduction" href="porting/eclipse_4_37_porting_guide.html"/>
10+
<topic label="FAQ" href="porting/4.37/faq.html" />
11+
<topic label="Incompatibilities" href="porting/4.37/incompatibilities.html" />
12+
<topic label="Adopting 4.37 mechanisms and API" href="porting/4.37/recommended.html" />
13+
</topic>
814
<topic label="Migrating to Eclipse 4.36 from 4.35">
915
<topic label="Introduction" href="porting/eclipse_4_36_porting_guide.html"/>
1016
<topic label="FAQ" href="porting/4.36/faq.html" />
@@ -41,13 +47,13 @@
4147
<topic label="Incompatibilities" href="porting/4.31/incompatibilities.html" />
4248
<topic label="Adopting 4.31 mechanisms and API" href="porting/4.31/recommended.html" />
4349
</topic>
44-
<topic label="Migrating to Eclipse 4.30 from 4.29">
50+
<topic label="Older Migration Guides">
51+
<topic label="Migrating to Eclipse 4.30 from 4.29">
4552
<topic label="Introduction" href="porting/eclipse_4_30_porting_guide.html"/>
4653
<topic label="FAQ" href="porting/4.30/faq.html" />
4754
<topic label="Incompatibilities" href="porting/4.30/incompatibilities.html" />
4855
<topic label="Adopting 4.30 mechanisms and API" href="porting/4.30/recommended.html" />
4956
</topic>
50-
<topic label="Older Migration Guides">
5157
<topic label="Migrating to Eclipse 4.29 from 4.28">
5258
<topic label="Introduction" href="porting/eclipse_4_29_porting_guide.html"/>
5359
<topic label="FAQ" href="porting/4.29/faq.html" />

0 commit comments

Comments
 (0)