diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 465d982d5..b8ba680e9 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,11 @@
+2008-06-11  Matthias Clasen  <mclasen@redhat.com>
+
+	Bug 528719 – Improvement to the documentation of the
+	"g_object_connect" interface
+
+	* gobject/tmpl/objects.sgml: Improve the documentation of
+	g_object_connect. Proposed by Areg Bketovski
+
 2008-06-11  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 528172 – gtk_signal_handlers_unblock_* functions return value
diff --git a/docs/reference/gobject/tmpl/objects.sgml b/docs/reference/gobject/tmpl/objects.sgml
index 3fba8cc27..6465e0088 100644
--- a/docs/reference/gobject/tmpl/objects.sgml
+++ b/docs/reference/gobject/tmpl/objects.sgml
@@ -683,21 +683,21 @@ The signal specs expected by this function have the form
 <varlistentry>
 <term>signal</term>
 <listitem><para>
-equivalent to <literal>g_signal_connect_data (...)</literal>
+equivalent to <literal>g_signal_connect_data (..., NULL, 0)</literal>
 </para></listitem>
 </varlistentry>
 <varlistentry>
 <term>object_signal</term>
 <term>object-signal</term>
 <listitem><para>
-equivalent to <literal>g_signal_connect_object (...)</literal>
+equivalent to <literal>g_signal_connect_object (..., 0)</literal>
 </para></listitem>
 </varlistentry>
 <varlistentry>
 <term>swapped_signal</term>
 <term>swapped-signal</term>
 <listitem><para>
-equivalent to <literal>g_signal_connect_data (..., G_CONNECT_SWAPPED)</literal>
+equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)</literal>
 </para></listitem>
 </varlistentry>
 <varlistentry>
@@ -711,7 +711,7 @@ equivalent to <literal>g_signal_connect_object (..., G_CONNECT_SWAPPED)</literal
 <term>signal_after</term>
 <term>signal-after</term>
 <listitem><para>
-equivalent to <literal>g_signal_connect_data (..., G_CONNECT_AFTER)</literal>
+equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_AFTER)</literal>
 </para></listitem>
 </varlistentry>
 <varlistentry>
@@ -725,7 +725,7 @@ equivalent to <literal>g_signal_connect_object (..., G_CONNECT_AFTER)</literal>
 <term>swapped_signal_after</term>
 <term>swapped-signal-after</term>
 <listitem><para>
-equivalent to <literal>g_signal_connect_data (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)</literal>
+equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED | G_CONNECT_AFTER)</literal>
 </para></listitem>
 </varlistentry>
 <varlistentry>