Skip to content

Commit 4b8fac9

Browse files
subyssurendran666subyssurendran666
authored
Migration guide for Eclipse 4.34 from 4.33 (#2543)
1 parent e96f8b8 commit 4b8fac9

File tree

10 files changed

+247
-14
lines changed

10 files changed

+247
-14
lines changed

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

‎eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.34/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) 2024 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.34 mechanisms and APIs</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Adopting JDT 4.34 Mechanisms and APIs</h1>
14+
<p>
15+
This section describes changes that are required if you are trying to change
16+
your 4.33 plug-in to adopt the 4.34 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_34_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 2024 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.34 Plug-in Migration Guide</title>
12+
</head>
13+
14+
<body>
15+
16+
<h1>Eclipse JDT 4.34 Plug-in Migration Guide</h1>
17+
<p>This guide covers migrating Eclipse JDT 4.33 plug-ins to Eclipse JDT 4.34.</p>
18+
<p>One of the goals of Eclipse 4.34 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.33 APIs should continue to work in 4.34 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.33 APIs remains valid for
24+
4.34, 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.34 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.33 plug-ins to
31+
4.34.</p>
32+
<ul>
33+
<li><a href="4.34/faq.html">Eclipse JDT 4.34 Plug-in Migration FAQ</a></li>
34+
<li><a href="4.34/incompatibilities.html">Incompatibilities between Eclipse JDT 4.33 and 4.34</a></li>
35+
<li><a href="4.34/recommended.html">Adopting 4.34 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: 13 additions & 7 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.34 from 4.33">
8+
<topic label="Introduction" href="porting/eclipse_4_34_porting_guide.html"/>
9+
<topic label="FAQ" href="porting/4.34/faq.html" />
10+
<topic label="Incompatibilities" href="porting/4.34/incompatibilities.html" />
11+
<topic label="Adopting 4.34 Mechanisms and API" href="porting/4.34/recommended.html" />
12+
</topic>
713
<topic label="Migrating to Eclipse JDT 4.33 from 4.32">
814
<topic label="Introduction" href="porting/eclipse_4_33_porting_guide.html"/>
915
<topic label="FAQ" href="porting/4.33/faq.html" />
@@ -27,15 +33,15 @@
2733
<topic label="FAQ" href="porting/4.30/faq.html" />
2834
<topic label="Incompatibilities" href="porting/4.30/incompatibilities.html" />
2935
<topic label="Adopting 4.30 Mechanisms and API" href="porting/4.30/recommended.html" />
30-
</topic>
31-
<topic label="Migrating to Eclipse JDT 4.29 from 4.28">
32-
<topic label="Introduction" href="porting/eclipse_4_29_porting_guide.html"/>
33-
<topic label="FAQ" href="porting/4.29/faq.html" />
34-
<topic label="Incompatibilities" href="porting/4.29/incompatibilities.html" />
35-
<topic label="Adopting 4.29 Mechanisms and API" href="porting/4.29/recommended.html" />
3636
</topic>
3737
<topic label="Older Migration Guides">
38-
<topic label="Migrating to Eclipse JDT 4.28 from 4.27">
38+
<topic label="Migrating to Eclipse JDT 4.29 from 4.28">
39+
<topic label="Introduction" href="porting/eclipse_4_29_porting_guide.html"/>
40+
<topic label="FAQ" href="porting/4.29/faq.html" />
41+
<topic label="Incompatibilities" href="porting/4.29/incompatibilities.html" />
42+
<topic label="Adopting 4.29 Mechanisms and API" href="porting/4.29/recommended.html" />
43+
</topic>
44+
<topic label="Migrating to Eclipse JDT 4.28 from 4.27">
3945
<topic label="Introduction" href="porting/eclipse_4_28_porting_guide.html"/>
4046
<topic label="FAQ" href="porting/4.28/faq.html" />
4147
<topic label="Incompatibilities" href="porting/4.28/incompatibilities.html" />

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

‎eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.34/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) 2024 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.33 and 4.34</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.33 and 4.34</h1>
12+
13+
<p>
14+
Eclipse changed in incompatible ways between 4.33 and 4.34 in ways that affect
15+
plug-ins. The following entries describe the areas that changed and provide
16+
instructions for migrating 4.33 plug-ins to 4.34. Note that you only need to look
17+
here if you are experiencing problems running your 4.33 plug-in on 4.34.
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.34/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) 2024 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.34 mechanisms and APIs</title>
11+
</head>
12+
13+
<body>
14+
<h1>Adopting 4.34 Mechanisms and APIs</h1>
15+
16+
<p>This section describes changes that are required if you are
17+
trying to change your 4.33 plug-in to adopt the 4.34 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_34_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) 2024 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.34 Plug-in Migration Guide</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse 4.34 Plug-in Migration Guide</h1>
14+
<p>This guide covers migrating Eclipse 4.33 plug-ins to Eclipse 4.34.</p>
15+
<p>One of the goals of Eclipse 4.34 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.33 APIs should continue to work in 4.34 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.33 APIs remains valid for
20+
4.34, 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.34 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.33 plug-ins to
27+
4.34.</p>
28+
<ul>
29+
<li><a href="4.34/faq.html">Eclipse 4.34 Plug-in Migration FAQ</a></li>
30+
<li><a href="4.34/incompatibilities.html">Incompatibilities between Eclipse 4.33 and 4.34</a></li>
31+
<li><a href="4.34/recommended.html">Adopting 4.34 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: 13 additions & 7 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.34 from 4.33">
9+
<topic label="Introduction" href="porting/eclipse_4_34_porting_guide.html"/>
10+
<topic label="FAQ" href="porting/4.34/faq.html" />
11+
<topic label="Incompatibilities" href="porting/4.34/incompatibilities.html" />
12+
<topic label="Adopting 4.33 mechanisms and API" href="porting/4.34/recommended.html" />
13+
</topic>
814
<topic label="Migrating to Eclipse 4.33 from 4.32">
915
<topic label="Introduction" href="porting/eclipse_4_33_porting_guide.html"/>
1016
<topic label="FAQ" href="porting/4.33/faq.html" />
@@ -34,15 +40,15 @@
3440
<topic label="FAQ" href="porting/4.29/faq.html" />
3541
<topic label="Incompatibilities" href="porting/4.29/incompatibilities.html" />
3642
<topic label="Adopting 4.29 mechanisms and API" href="porting/4.29/recommended.html" />
37-
</topic>
38-
<topic label="Migrating to Eclipse 4.28 from 4.27">
39-
<topic label="Introduction" href="porting/eclipse_4_28_porting_guide.html"/>
40-
<topic label="FAQ" href="porting/4.28/faq.html" />
41-
<topic label="Incompatibilities" href="porting/4.28/incompatibilities.html" />
42-
<topic label="Adopting 4.28 mechanisms and API" href="porting/4.28/recommended.html" />
4343
</topic>
4444
<topic label="Older Migration Guides">
45-
<topic label="Migrating to Eclipse 4.27 from 4.26">
45+
<topic label="Migrating to Eclipse 4.28 from 4.27">
46+
<topic label="Introduction" href="porting/eclipse_4_28_porting_guide.html"/>
47+
<topic label="FAQ" href="porting/4.28/faq.html" />
48+
<topic label="Incompatibilities" href="porting/4.28/incompatibilities.html" />
49+
<topic label="Adopting 4.28 mechanisms and API" href="porting/4.28/recommended.html" />
50+
</topic>
51+
<topic label="Migrating to Eclipse 4.27 from 4.26">
4652
<topic label="Introduction" href="porting/eclipse_4_27_porting_guide.html"/>
4753
<topic label="FAQ" href="porting/4.27/faq.html" />
4854
<topic label="Incompatibilities" href="porting/4.27/incompatibilities.html" />

0 commit comments

Comments
 (0)