Skip to content

Commit 97f0bb7

Browse files
Migration guide for Eclipse 4.35 from 4.34 (#2839)
1 parent e3b6ec0 commit 97f0bb7

File tree

12 files changed

+247
-14
lines changed

12 files changed

+247
-14
lines changed

eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/META-INF/MANIFEST.MF

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Manifest-Version: 1.0
22
Bundle-ManifestVersion: 2
33
Bundle-Name: %pluginName
44
Bundle-SymbolicName: org.eclipse.jdt.doc.isv; singleton:=true
5-
Bundle-Version: 3.14.2600.qualifier
5+
Bundle-Version: 3.14.2700.qualifier
66
Bundle-Vendor: %providerName
77
Bundle-Localization: plugin
88
Require-Bundle: org.eclipse.help;bundle-version="[3.2.0,4.0.0)"

eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
</parent>
2020
<groupId>org.eclipse.jdt</groupId>
2121
<artifactId>org.eclipse.jdt.doc.isv</artifactId>
22-
<version>3.14.2600-SNAPSHOT</version>
22+
<version>3.14.2700-SNAPSHOT</version>
2323
<packaging>eclipse-plugin</packaging>
2424

2525
<profiles>
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.35 Plug-in Migration FAQ</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Eclipse JDT 4.35 Plug-in Migration FAQ</h1>
14+
15+
<ol>
16+
<li>None</li>
17+
</ol>
18+
19+
</body>
20+
</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.34 and 4.35</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.34 and 4.35</h1>
12+
13+
<p>
14+
So far Eclipse did not change incompatibly between 4.34 and 4.35 in ways that affect
15+
plug-ins. Plug-ins that ran on 4.34 should run on 4.35 without any problems.
16+
</p>
17+
18+
</body>
19+
</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.35 mechanisms and APIs</title>
9+
</head>
10+
11+
<body>
12+
13+
<h1>Adopting JDT 4.35 Mechanisms and APIs</h1>
14+
<p>
15+
This section describes changes that are required if you are trying to change
16+
your 4.34 plug-in to adopt the 4.35 mechanisms and APIs.
17+
</p>
18+
19+
<ol>
20+
<li>None</li>
21+
</ol>
22+
</body>
23+
</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.35 Plug-in Migration Guide</title>
12+
</head>
13+
14+
<body>
15+
16+
<h1>Eclipse JDT 4.35 Plug-in Migration Guide</h1>
17+
<p>This guide covers migrating Eclipse JDT 4.34 plug-ins to Eclipse JDT 4.35.</p>
18+
<p>One of the goals of Eclipse 4.35 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.34 APIs should continue to work in 4.35 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.34 APIs remains valid for
24+
4.35, 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.35 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.34 plug-ins to
31+
4.35.</p>
32+
<ul>
33+
<li><a href="4.35/faq.html">Eclipse JDT 4.35 Plug-in Migration FAQ</a></li>
34+
<li><a href="4.35/incompatibilities.html">Incompatibilities between Eclipse JDT 4.34 and 4.35</a></li>
35+
<li><a href="4.35/recommended.html">Adopting 4.35 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: 12 additions & 6 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.35 from 4.34">
8+
<topic label="Introduction" href="porting/eclipse_4_35_porting_guide.html"/>
9+
<topic label="FAQ" href="porting/4.35/faq.html" />
10+
<topic label="Incompatibilities" href="porting/4.35/incompatibilities.html" />
11+
<topic label="Adopting 4.34 Mechanisms and API" href="porting/4.35/recommended.html" />
12+
</topic>
713
<topic label="Migrating to Eclipse JDT 4.34 from 4.33">
814
<topic label="Introduction" href="porting/eclipse_4_34_porting_guide.html"/>
915
<topic label="FAQ" href="porting/4.34/faq.html" />
@@ -27,14 +33,14 @@
2733
<topic label="FAQ" href="porting/4.31/faq.html" />
2834
<topic label="Incompatibilities" href="porting/4.31/incompatibilities.html" />
2935
<topic label="Adopting 4.31 Mechanisms and API" href="porting/4.31/recommended.html" />
30-
</topic>
31-
<topic label="Migrating to Eclipse JDT 4.30 from 4.29">
32-
<topic label="Introduction" href="porting/eclipse_4_30_porting_guide.html"/>
33-
<topic label="FAQ" href="porting/4.30/faq.html" />
34-
<topic label="Incompatibilities" href="porting/4.30/incompatibilities.html" />
35-
<topic label="Adopting 4.30 Mechanisms and API" href="porting/4.30/recommended.html" />
3636
</topic>
3737
<topic label="Older Migration Guides">
38+
<topic label="Migrating to Eclipse JDT 4.30 from 4.29">
39+
<topic label="Introduction" href="porting/eclipse_4_30_porting_guide.html"/>
40+
<topic label="FAQ" href="porting/4.30/faq.html" />
41+
<topic label="Incompatibilities" href="porting/4.30/incompatibilities.html" />
42+
<topic label="Adopting 4.30 Mechanisms and API" href="porting/4.30/recommended.html" />
43+
</topic>
3844
<topic label="Migrating to Eclipse JDT 4.29 from 4.28">
3945
<topic label="Introduction" href="porting/eclipse_4_29_porting_guide.html"/>
4046
<topic label="FAQ" href="porting/4.29/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.35 Plug-in Migration FAQ</title>
9+
</head>
10+
<body>
11+
<h1>Eclipse 4.35 Plug-in Migration FAQ</h1>
12+
</body>
13+
</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.34 and 4.35</title>
9+
</head>
10+
<body>
11+
<h1>Incompatibilities Between Eclipse 4.34 and 4.35</h1>
12+
13+
<p>
14+
Eclipse changed in incompatible ways between 4.34 and 4.35 in ways that affect
15+
plug-ins. The following entries describe the areas that changed and provide
16+
instructions for migrating 4.34 plug-ins to 4.35. Note that you only need to look
17+
here if you are experiencing problems running your 4.34 plug-in on 4.35.
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>
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.35 mechanisms and APIs</title>
11+
</head>
12+
13+
<body>
14+
<h1>Adopting 4.35 Mechanisms and APIs</h1>
15+
16+
<p>This section describes changes that are required if you are
17+
trying to change your 4.34 plug-in to adopt the 4.35 mechanisms and
18+
APIs.</p>
19+
20+
<!-- ##############################################
21+
############################################## -->
22+
23+
</body>
24+
25+
</html>

0 commit comments

Comments
 (0)