Bug 541577 - Create JDT and Platform porting guides for 4.10 and update
links in Welcome page
Change-Id: I635ea37d8c5253456309424a461c4a4fc3b34c68
Signed-off-by: Kalyan Prasad Tatavarthi <kalyan_prasad@in.ibm.com>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.10/faq.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/faq.html
new file mode 100644
index 0000000..bd0e5d6
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/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) 2018 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.10 Plug-in Migration FAQ</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT 4.10 Plug-in Migration FAQ</h1>
+
+<ol>
+ <li>None</li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.10/incompatibilities.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/incompatibilities.html
new file mode 100644
index 0000000..7cff6a2
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/incompatibilities.html
@@ -0,0 +1,19 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) 2018 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>Incompatibilities between Eclipse JDT 4.9 and 4.10</title>
+</head>
+<body>
+<h1>Incompatibilities between Eclipse JDT 4.9 and 4.10</h1>
+
+<p>
+ So far Eclipse did not change incompatibly between 4.9 and 4.10 in ways that affect
+ plug-ins. Plug-ins that ran on 4.9 should run on 4.10 without any problems.
+</p>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.10/recommended.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/recommended.html
new file mode 100644
index 0000000..edac790
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.10/recommended.html
@@ -0,0 +1,23 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) 2018 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.9 mechanisms and APIs</title>
+</head>
+
+<body>
+
+<h1>Adopting JDT 4.10 mechanisms and APIs</h1>
+<p>
+ This section describes changes that are required if you are trying to change
+ your 4.9 plug-in to adopt the 4.10 mechanisms and APIs.
+</p>
+
+<ol>
+ <li>None</li>
+</ol>
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_10_porting_guide.html b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_10_porting_guide.html
new file mode 100644
index 0000000..40f911d
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_10_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 2017 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.10 Plug-in Migration Guide</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT 4.10 Plug-in Migration Guide</h1>
+<p>This guide covers migrating Eclipse JDT 4.9 plug-ins to Eclipse JDT 4.10.</p>
+<p>One of the goals of Eclipse 4.10 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.9 APIs should continue to work in 4.10 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.9 APIs remains valid for
+ 4.10, 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.10 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.9 plug-ins to
+ 4.10.</p>
+<ul>
+ <li><a href="4.10/faq.html">Eclipse JDT 4.10 Plug-in Migration FAQ</a></li>
+ <li><a href="4.10/incompatibilities.html">Incompatibilities between Eclipse JDT 4.9 and 4.10</a></li>
+ <li><a href="4.10/recommended.html">Adopting 4.10 mechanisms and API</a></li>
+</ul>
+
+</body>
+</html>
\ No newline at end of file
diff --git a/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml b/bundles/org.eclipse.jdt.doc.isv/topics_Porting.xml
index fd7f829..446de7f 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 4.10 from 4.9">
+ <topic label="Introduction" href="porting/eclipse_4_10_porting_guide.html"/>
+ <topic label="FAQ" href="porting/4.10/faq.html" />
+ <topic label="Incompatibilities" href="porting/4.10/incompatibilities.html" />
+ <topic label="Adopting 4.10 Mechanisms and API" href="porting/4.10/recommended.html" />
+ </topic>
<topic label="Migrating to Eclipse JDT 4.9 from 4.8">
<topic label="Introduction" href="porting/eclipse_4_9_porting_guide.html"/>
<topic label="FAQ" href="porting/4.9/faq.html" />
diff --git a/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml b/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml
index 54757b8..e1117a0 100644
--- a/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml
+++ b/bundles/org.eclipse.platform.doc.isv/topics_Porting.xml
@@ -5,6 +5,12 @@
<!-- ============================================================================= -->
<toc label="Migration">
<topic label="Deprecated API removals" href="porting/removals.html"/>
+ <topic label="Migrating to Eclipse 4.10 from 4.9">
+ <topic label="Introduction" href="porting/eclipse_4_10_porting_guide.html"/>
+ <topic label="FAQ" href="porting/4.10/faq.html" />
+ <topic label="Incompatibilities" href="porting/4.10/incompatibilities.html" />
+ <topic label="Adopting 4.10 mechanisms and API" href="porting/4.10/recommended.html" />
+ </topic>
<topic label="Migrating to Eclipse 4.9 from 4.8">
<topic label="Introduction" href="porting/eclipse_4_9_porting_guide.html"/>
<topic label="FAQ" href="porting/4.9/faq.html" />