From 47bc8603b0cb1676ce5887de3aeba511a5f85ad6 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Thu, 19 Jan 2017 13:52:52 -0500
Subject: [PATCH] Add a section about initialization to the migration guide

Just the facts.
---
 docs/reference/gtk/migrating-3to4.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 537aad0aa7..f33cc15c4f 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -261,6 +261,18 @@
         use.
       </para>
     </section>
+
+    <section>
+      <title>Stop passing commandline arguments to gtk_init()</title>
+      <para>
+        The gtk_init() and gtk_init_check() functions no longer accept commandline
+        arguments. Just call them without arguments. Other initialization functions
+        that were purely related to commandline argument handling, such as
+        gtk_parse_args() and gtk_get_option_group(), are gone. The APIs to
+        initialize GDK separately are also gone, but it is very unlikely
+        that you are affected by that.
+      </para>
+    </section>
   </section>
 
 </chapter>