[gtk+] Start a new migration guide

[Matthias Clasen <matthiasc src gnome org>]

commit 56cc9e2d71f5ea095039388837b2205e85d3d9ab
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Oct 18 15:21:12 2016 -0400

    Start a new migration guide
    
    Remove information that is only relevant for porting to GTK+ 3,
    and put scaffolding in place for information relevant to GTK+ 4.

 docs/reference/gtk/Makefile.am                     |   18 +-
 docs/reference/gtk/gtk-docs.sgml                   |    9 +-
 docs/reference/gtk/migrating-2to3.xml              | 1274 --------------------
 docs/reference/gtk/migrating-2to4.xml              |   15 +
 docs/reference/gtk/migrating-3to4.xml              |   13 +
 docs/reference/gtk/migrating-3xtoy.xml             |  443 -------
 docs/reference/gtk/migrating-GtkGrid.xml           |  231 ----
 docs/reference/gtk/migrating-GtkStyleContext.xml   |  691 -----------
 docs/reference/gtk/migrating-checklist.sgml        |  310 -----
 .../gtk/migrating-smclient-GtkApplication.xml      |   48 -
 .../gtk/migrating-unique-GtkApplication.xml        |  143 ---
 11 files changed, 34 insertions(+), 3161 deletions(-)
---
diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index c07a56e..adcfb7d 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -297,13 +297,8 @@ content_files =                                    \
        gtk4-query-settings.xml                 \
        gtk4-update-icon-cache.xml              \
        input-handling.xml                      \
-       migrating-2to3.xml                      \
-       migrating-3xtoy.xml                     \
-       migrating-checklist.sgml                \
-       migrating-GtkGrid.xml                   \
-       migrating-GtkStyleContext.xml           \
-       migrating-smclient-GtkApplication.xml   \
-       migrating-unique-GtkApplication.xml     \
+       migrating-2to4.xml                      \
+       migrating-3to4.xml                      \
        mir.xml                                 \
        osx.sgml                                \
        overview.xml                            \
@@ -324,13 +319,8 @@ expand_content_files =                             \
        getting_started.xml                     \
        glossary.xml                            \
        input-handling.xml                      \
-       migrating-2to3.xml                      \
-       migrating-3xtoy.xml                     \
-       migrating-checklist.sgml                \
-       migrating-GtkGrid.xml                   \
-       migrating-GtkStyleContext.xml           \
-       migrating-smclient-GtkApplication.xml   \
-       migrating-unique-GtkApplication.xml     \
+       migrating-2to4.xml                      \
+       migrating-3to4.xml                      \
        question_index.sgml                     \
        text_widget.sgml                        \
        tree_widget.sgml
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 38eb57e..0e5030b 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -348,13 +348,8 @@
       </para>
     </partintro>
 
-    <xi:include href="xml/migrating-2to3.xml" />
-    <xi:include href="xml/migrating-GtkStyleContext.xml" />
-    <xi:include href="xml/migrating-unique-GtkApplication.xml" />
-    <xi:include href="xml/migrating-smclient-GtkApplication.xml" />
-    <xi:include href="xml/migrating-GtkGrid.xml" />
-    <xi:include href="xml/migrating-checklist.sgml" />
-    <xi:include href="xml/migrating-3xtoy.xml" />
+    <xi:include href="xml/migrating-2to4.xml" />
+    <xi:include href="xml/migrating-3to4.xml" />
   </part>
 
   <part>
diff --git a/docs/reference/gtk/migrating-2to4.xml b/docs/reference/gtk/migrating-2to4.xml
new file mode 100644
index 0000000..6083338
--- /dev/null
+++ b/docs/reference/gtk/migrating-2to4.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"; [
+<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+<chapter id="gtk-migrating-2-to-4">
+  <title>Migrating from GTK+ 2.x to GTK+ 4</title>
+
+  <para>
+    If your application is still using GTK+ 2, you should first convert it to
+    GTK+ 3, by following the <ulink 
url="https://developer.gnome.org/gtk3/stable/gtk-migrating-2-to-3.html";>migration guide</ulink> in the GTK+ 3
+    documentation.
+  </para>
+
+</chapter>
diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
new file mode 100644
index 0000000..03c135a
--- /dev/null
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"; [
+<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+<chapter id="gtk-migrating-3-to-4">
+  <title>Migrating from GTK+ 3.x to GTK+ 4</title>
+
+  <para>
+    Information about porting from GTK+ 3 to GTK+ 4 will appear here.
+  </para>
+
+</chapter>