diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index dc4ce0568f..fa9c8dab05 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-09-10  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/migrating-GtkBuilder.sgml: Add a paragraph about
+	using gtk-builder-convert.
+
 2007-09-07  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/tmpl/gtkprintunixdialog.sgml: Additions
diff --git a/docs/reference/gtk/migrating-GtkBuilder.sgml b/docs/reference/gtk/migrating-GtkBuilder.sgml
index 2806ff9027..721392e387 100644
--- a/docs/reference/gtk/migrating-GtkBuilder.sgml
+++ b/docs/reference/gtk/migrating-GtkBuilder.sgml
@@ -8,6 +8,16 @@
     provided by #GladeXML in the libglade library.
   </para>
 
+  <para>
+    A good way to start a migration from libglade to GtkBuilder is
+    to run the <link linkend="gtk-builder-convert">gtk-builder-convert</link>
+    utility on your glade file, and inspect the resulting output.
+    If your code uses the @root parameter of glade_xml_new(), you 
+    may want to split your glade file into multiple GtkBuilder files
+    by using the <option>--root</option> option of 
+    <application>gtk-builder-convert</application>.
+  </para>
+
   <para>
     While GtkBuilder strives to be a complete replacement for
     libglade, there are a number of areas where it is currently
@@ -21,9 +31,8 @@
         to implement, see 
         <ulink url="http://bugzilla.gnome.org/show_bug.cgi?id=447998">bug 
         447998</ulink>. As a workaround, you can split your glade file 
-        into multiple GtkBuilder input files. The 
-        <application>gtk-builder-convert</application> conversion script 
-        has a <option>--root</option> option that can help with this.
+        into multiple GtkBuilder input files using the <option>--root</option>
+        that was mentioned above.
       </para></listitem>
 
       <listitem><para>