-
Notifications
You must be signed in to change notification settings - Fork 77
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Migration guide for Eclipse 4.34 from 4.33 (#2543)
- Loading branch information
1 parent
e96f8b8
commit 4b8fac9
Showing
10 changed files
with
247 additions
and
14 deletions.
There are no files selected for viewing
20 changes: 20 additions & 0 deletions
20
eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.34/faq.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css"> | ||
| <title>Eclipse JDT 4.34 Plug-in Migration FAQ</title> | ||
| </head> | ||
|
|
||
| <body> | ||
|
|
||
| <h1>Eclipse JDT 4.34 Plug-in Migration FAQ</h1> | ||
|
|
||
| <ol> | ||
| <li>None</li> | ||
| </ol> | ||
|
|
||
| </body> | ||
| </html> |
19 changes: 19 additions & 0 deletions
19
eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.34/incompatibilities.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" type="text/css"> | ||
| <title>Incompatibilities between Eclipse 4.33 and 4.34</title> | ||
| </head> | ||
| <body> | ||
| <h1>Incompatibilities Between Eclipse 4.33 and 4.34</h1> | ||
|
|
||
| <p> | ||
| So far Eclipse did not change incompatibly between 4.33 and 4.34 in ways that affect | ||
| plug-ins. Plug-ins that ran on 4.33 should run on 4.34 without any problems. | ||
| </p> | ||
|
|
||
| </body> | ||
| </html> |
23 changes: 23 additions & 0 deletions
23
eclipse.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/4.34/recommended.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css"> | ||
| <title>Adopting JDT 4.34 mechanisms and APIs</title> | ||
| </head> | ||
|
|
||
| <body> | ||
|
|
||
| <h1>Adopting JDT 4.34 Mechanisms and APIs</h1> | ||
| <p> | ||
| This section describes changes that are required if you are trying to change | ||
| your 4.33 plug-in to adopt the 4.34 mechanisms and APIs. | ||
| </p> | ||
|
|
||
| <ol> | ||
| <li>None</li> | ||
| </ol> | ||
| </body> | ||
| </html> |
39 changes: 39 additions & 0 deletions
39
...e.platform.common/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_34_porting_guide.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,39 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
|
|
||
| <head> | ||
|
|
||
| <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." > | ||
|
|
||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css"> | ||
| <title>Eclipse JDT 4.34 Plug-in Migration Guide</title> | ||
| </head> | ||
|
|
||
| <body> | ||
|
|
||
| <h1>Eclipse JDT 4.34 Plug-in Migration Guide</h1> | ||
| <p>This guide covers migrating Eclipse JDT 4.33 plug-ins to Eclipse JDT 4.34.</p> | ||
| <p>One of the goals of Eclipse 4.34 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.33 APIs should continue to work in 4.34 in spite of the | ||
| API changes.</p> | ||
| <p>The key kinds of compatibility are API contract compatibility and binary compatibility. | ||
| API contract compatibility means that valid use of 4.33 APIs remains valid for | ||
| 4.34, 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.34 libraries.</p> | ||
| <p>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.33 plug-ins to | ||
| 4.34.</p> | ||
| <ul> | ||
| <li><a href="4.34/faq.html">Eclipse JDT 4.34 Plug-in Migration FAQ</a></li> | ||
| <li><a href="4.34/incompatibilities.html">Incompatibilities between Eclipse JDT 4.33 and 4.34</a></li> | ||
| <li><a href="4.34/recommended.html">Adopting 4.34 mechanisms and API</a></li> | ||
| </ul> | ||
|
|
||
| </body> | ||
| </html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
13 changes: 13 additions & 0 deletions
13
eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.34/faq.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css"> | ||
| <title>Eclipse 4.34 Plug-in Migration FAQ</title> | ||
| </head> | ||
| <body> | ||
| <h1>Eclipse 4.34 Plug-in Migration FAQ</h1> | ||
| </body> | ||
| </html> |
47 changes: 47 additions & 0 deletions
47
....platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.34/incompatibilities.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,47 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" type="text/css"> | ||
| <title>Incompatibilities between Eclipse 4.33 and 4.34</title> | ||
| </head> | ||
| <body> | ||
| <h1>Incompatibilities Between Eclipse 4.33 and 4.34</h1> | ||
|
|
||
| <p> | ||
| Eclipse changed in incompatible ways between 4.33 and 4.34 in ways that affect | ||
| plug-ins. The following entries describe the areas that changed and provide | ||
| instructions for migrating 4.33 plug-ins to 4.34. Note that you only need to look | ||
| here if you are experiencing problems running your 4.33 plug-in on 4.34. | ||
| </p> | ||
| <p> | ||
| See also the list of <a href="../removals.html">deprecated API removals</a> for this release. | ||
| </p> | ||
|
|
||
| <ol> | ||
| <li><a href="#upstream-bundles">Several bundles renamed for 3rd party libraries</a></li> | ||
| </ol> | ||
|
|
||
| <hr> | ||
|
|
||
| <!-- ############################################## --> | ||
|
|
||
| <h2>1. <a name="native-fragments-merge">Multiple Platform-specific Fragments Merged Into Their Host</a></h2> | ||
| <p> | ||
| The following platform-specific fragments have been merged into their respective host bundle: | ||
| <ul> | ||
| <li><code>org.eclipse.core.resources.win32.win32.x86_64</code></li> | ||
| <li><code>org.eclipse.core.filesystem.win32.x86_64</code></li> | ||
| <li><code>org.eclipse.core.net.linux</code></li> | ||
| <li><code>org.eclipse.core.net.win32</code></li> | ||
| </ul> | ||
| </p> | ||
| <p> | ||
| 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 <em>feature.xml</em> or listed as content of a product definition it just has to be removed. | ||
| </p> | ||
|
|
||
| </body> | ||
| </html> |
25 changes: 25 additions & 0 deletions
25
eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/4.34/recommended.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
|
|
||
| <head> | ||
| <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."> | ||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../../book.css" type="text/css"> | ||
| <title>Adopting 4.34 mechanisms and APIs</title> | ||
| </head> | ||
|
|
||
| <body> | ||
| <h1>Adopting 4.34 Mechanisms and APIs</h1> | ||
|
|
||
| <p>This section describes changes that are required if you are | ||
| trying to change your 4.33 plug-in to adopt the 4.34 mechanisms and | ||
| APIs.</p> | ||
|
|
||
| <!-- ############################################## | ||
| ############################################## --> | ||
|
|
||
| </body> | ||
|
|
||
| </html> |
35 changes: 35 additions & 0 deletions
35
...tform.common/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_34_porting_guide.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||
| <html lang="en"> | ||
| <head> | ||
| <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." > | ||
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| <meta http-equiv="Content-Style-Type" content="text/css"> | ||
| <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css"> | ||
| <title>Eclipse 4.34 Plug-in Migration Guide</title> | ||
| </head> | ||
|
|
||
| <body> | ||
|
|
||
| <h1>Eclipse 4.34 Plug-in Migration Guide</h1> | ||
| <p>This guide covers migrating Eclipse 4.33 plug-ins to Eclipse 4.34.</p> | ||
| <p>One of the goals of Eclipse 4.34 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.33 APIs should continue to work in 4.34 in spite of any API changes.</p> | ||
| <p>The key kinds of compatibility are API contract compatibility and binary compatibility. | ||
| API contract compatibility means that valid use of 4.33 APIs remains valid for | ||
| 4.34, 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.34 libraries.</p> | ||
| <p>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.33 plug-ins to | ||
| 4.34.</p> | ||
| <ul> | ||
| <li><a href="4.34/faq.html">Eclipse 4.34 Plug-in Migration FAQ</a></li> | ||
| <li><a href="4.34/incompatibilities.html">Incompatibilities between Eclipse 4.33 and 4.34</a></li> | ||
| <li><a href="4.34/recommended.html">Adopting 4.34 mechanisms and API</a></li> | ||
| </ul> | ||
|
|
||
| </body> | ||
| </html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters