Bug 507292 - Create platform porting guide for 4.7 and update links in
Welcome page
Change-Id: Ic420012f8e0aeacb65ceee619f28e8b893c1a892
Signed-off-by: Sopot Cela <scela@redhat.com>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.7/faq.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/faq.html
new file mode 100644
index 0000000..7851fca
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/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) 2016 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 Oxygen (4.7) Plug-in Migration FAQ</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT Neon (4.7) Plug-in Migration FAQ</h1>
+
+<ol>
+ <li>None</li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.7/incompatibilities.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/incompatibilities.html
new file mode 100644
index 0000000..d98a51c
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/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) 2016 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.6 and 4.7</title>
+</head>
+<body>
+<h1>Incompatibilities between Eclipse JDT 4.6 and 4.7</h1>
+
+<p>
+ Eclipse did not change incompatibly between 4.6 and 4.7 in ways that affect
+ plug-ins. Plugins that ran on 4.6 should run on 4.7 without any problems.
+</p>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.7/recommended.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/recommended.html
new file mode 100644
index 0000000..7289374
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.7/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) 2016 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 Oxygen (4.7) mechanisms and APIs</title>
+</head>
+
+<body>
+
+<h1>Adopting JDT Oxygen (4.7) mechanisms and APIs</h1>
+<p>
+ This section describes changes that are required if you are trying to change
+ your 4.6 plug-in to adopt the 4.7 mechanisms and APIs.
+</p>
+
+<ol>
+ <li>None</li>
+</ol>
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_7_porting_guide.html b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_7_porting_guide.html
new file mode 100644
index 0000000..979ba05
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_7_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 2016 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 Oxygen (4.7) Plug-in Migration Guide</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT Oxygen (4.7) Plug-in Migration Guide</h1>
+<p>This guide covers migrating Eclipse JDT 4.6 plug-ins to Eclipse JDT 4.7.</p>
+<p>One of the goals of Eclipse 4.7 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.6 APIs should continue to work in 4.7 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.6 APIs remains valid for
+ 4.7, 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.7 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.6 plug-ins to
+ 4.7.</p>
+<ul>
+ <li><a href="4.7/faq.html">Eclipse JDT 4.7 Plug-in Migration FAQ</a></li>
+ <li><a href="4.7/incompatibilities.html">Incompatibilities between Eclipse JDT 4.6 and 4.7</a></li>
+ <li><a href="4.7/recommended.html">Adopting 4.7 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 ff154fe..aa81076 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.7 from 4.6">
+ <topic label="Introduction" href="porting/eclipse_4_7_porting_guide.html"/>
+ <topic label="FAQ" href="porting/4.7/faq.html" />
+ <topic label="Incompatibilities" href="porting/4.7/incompatibilities.html" />
+ <topic label="Adopting 4.7 Mechanisms and API" href="porting/4.7/recommended.html" />
+ </topic>
<topic label="Migrating to Eclipse JDT 4.6 from 4.5">
<topic label="Introduction" href="porting/eclipse_4_6_porting_guide.html"/>
<topic label="FAQ" href="porting/4.6/faq.html" />
