Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarkus Keller2013-05-22 13:41:03 +0000
committerMarkus Keller2013-05-22 13:41:03 +0000
commitd894db1aa3170e205e7c28b53c12a0a5ecbb7c25 (patch)
tree6e245849f66938959fb9779e02961bff154824f1
parenta752246fdc1823cdee405aff0a45376c6f173a34 (diff)
downloadeclipse.platform.common-d894db1aa3170e205e7c28b53c12a0a5ecbb7c25.tar.gz
eclipse.platform.common-d894db1aa3170e205e7c28b53c12a0a5ecbb7c25.tar.xz
eclipse.platform.common-d894db1aa3170e205e7c28b53c12a0a5ecbb7c25.zip
3.9 (Kepler) migration guide: Single JUnit 4 bundleI20130523-1400I20130522-2000
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/porting/3.9/faq.html20
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/porting/3.9/incompatibilities.html41
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/porting/3.9/recommended.html32
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/porting/eclipse_3_9_porting_guide.html39
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/toc.xml2
-rw-r--r--bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml6
6 files changed, 139 insertions, 1 deletions
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/3.9/faq.html b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/faq.html
new file mode 100644
index 000000000..672c925b9
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/faq.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) IBM Corporation and others 2012. 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 3.9 (Kepler) Plug-in Migration FAQ</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT 3.9 (Kepler) Plug-in Migration FAQ</h1>
+
+<ol>
+ <li>None</li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/3.9/incompatibilities.html b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/incompatibilities.html
new file mode 100644
index 000000000..1b17d738b
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/incompatibilities.html
@@ -0,0 +1,41 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) IBM Corporation and others 2013. 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>Incompatibilities between Eclipse JDT 3.8 and 3.9 (Kepler)</title>
+</head>
+<body>
+<h1>Incompatibilities between Eclipse JDT 3.8 and 3.9 (Kepler)</h1>
+
+<p>
+ Eclipse changed in incompatible ways between 3.8 and 3.9 in ways that affect JDT
+ plug-ins. The following entries describe the areas that changed and provide
+ instructions for migrating 3.8 plug-ins to 3.9. Note that you only need to look
+ here if you are experiencing problems compiling or running your 3.8 plug-in on 3.9.
+</p>
+
+<ol>
+ <li><a href="#junit">SDK ships only one org.junit plug-in (4.11)</a></li>
+</ol>
+<hr>
+
+<!-- ############################################## -->
+<h2>1. <a name="junit">SDK ships only one org.junit plug-in (4.11)</a></h2>
+<p><strong>What is affected:</strong> Clients that require the <code>org.junit4</code> bundle,
+or <code>org.junit</code> with an upper version bound</p>
+<p><strong>Description:</strong> The <code>org.junit</code> bundle has been updated to
+<a href="http://htmlpreview.github.com/?https://github.com/junit-team/junit/blob/master/doc/ReleaseNotes4.11.html">JUnit 4.11</a>.
+The <code>org.junit4</code> compatibility bundle has been removed, and <code>org.junit</code> version 3.8.2 is no longer shipped with the Eclipse SDK.
+Note that JUnit 4 still contains the JUnit 3 APIs. If you need <code>org.junit_3.8.2</code> back for
+whatever reason, you can still get it from <a href="http://download.eclipse.org/tools/orbit/downloads/">Orbit</a>.
+<p><strong>Action required:</strong> Clients that require <code>org.junit4</code> should switch over to <code>org.junit</code>.
+Your <code>Require-Bundle:</code> entries should just point to
+<code>org.junit;bundle-version="4.11.0"</code> (or an earlier version, if you like).
+
+<!-- ############################################## -->
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/3.9/recommended.html b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/recommended.html
new file mode 100644
index 000000000..8f9ff1b8c
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/3.9/recommended.html
@@ -0,0 +1,32 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) IBM Corporation and others 2013. 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 3.9 (Kepler) mechanisms and APIs</title>
+</head>
+
+<body>
+
+<h1>Adopting JDT 3.9 mechanisms and APIs</h1>
+<p>
+ This section describes changes that are required if you are trying to change
+ your 3.8 plug-in to adopt the 3.9 mechanisms and APIs.
+</p>
+
+<ol>
+ <li>None</li>
+</ol>
+
+<hr>
+
+<!-- ############################################## -->
+
+
+
+<!-- ############################################## -->
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_3_9_porting_guide.html b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_3_9_porting_guide.html
new file mode 100644
index 000000000..1340a026a
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_3_9_porting_guide.html
@@ -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 Corporation and others 2013. 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 3.9 (Kepler) Plug-in Migration Guide</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT 3.9 (Kepler) Plug-in Migration Guide</h1>
+<p>This guide covers migrating Eclipse JDT 3.8 plug-ins to Eclipse JDT 3.9.</p>
+<p>One of the goals of Eclipse 3.9 was to move Eclipse forward while remaining compatible
+ with previous versions to the greatest extent possible. That is, plug-ins written
+ against the Eclipse 3.8 APIs should continue to work in 3.9 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 3.8 APIs remains valid for
+ 3.9, 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 (&quot;binary&quot;) code to no longer link and run with the
+ new 3.9 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 3.8 plug-ins to
+ 3.9.</p>
+<ul>
+ <li><a href="3.9/faq.html">Eclipse JDT 3.9 Plug-in Migration FAQ</a></li>
+ <li><a href="3.9/incompatibilities.html">Incompatibilities between Eclipse JDT 3.8 and 3.9</a></li>
+ <li><a href="3.9/recommended.html">Adopting 3.9 mechanisms and API</a></li>
+</ul>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/toc.xml b/bundles/org.eclipse.jdt.doc.isv/toc.xml
index 4fb18768e..dc6becd2a 100644
--- a/bundles/org.eclipse.jdt.doc.isv/toc.xml
+++ b/bundles/org.eclipse.jdt.doc.isv/toc.xml
@@ -11,7 +11,7 @@
<topic label="Reference">
<link toc="topics_Reference.xml" />
</topic>
- <topic label="3.8 Plug-in Migration Guide">
+ <topic label="3.9 Plug-in Migration Guide">
<link toc="topics_Porting.xml"/>
</topic>
<topic label="Questions Index" href="questions/index.html">
diff --git a/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml b/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml
index 18b0b42cd..d90fbfd75 100644
--- a/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml
+++ b/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml
@@ -4,6 +4,12 @@
<!-- Define topics for the porting guide index -->
<!-- ============================================================================= -->
<toc label="Migration">
+ <topic label="Migrating to Eclipse JDT 3.9 (Kepler) from 3.8">
+ <topic label="Introduction" href="porting/eclipse_3_9_porting_guide.html"/>
+ <topic label="FAQ" href="porting/3.9/faq.html" />
+ <topic label="Incompatibilities" href="porting/3.9/incompatibilities.html" />
+ <topic label="Adopting 3.9 Mechanisms and API" href="porting/3.9/recommended.html" />
+ </topic>
<topic label="Migrating to Eclipse JDT 3.8 from 3.7">
<topic label="Introduction" href="porting/eclipse_3_8_porting_guide.html"/>
<topic label="FAQ" href="porting/3.8/faq.html" />

Back to the top