diff --git a/docs/reference/gobject/tmpl/objects.sgml b/docs/reference/gobject/tmpl/objects.sgml
index bfe0fa196..b5a86c880 100644
--- a/docs/reference/gobject/tmpl/objects.sgml
+++ b/docs/reference/gobject/tmpl/objects.sgml
@@ -288,23 +288,98 @@ to match the one used with g_object_add_weak_pointer().
-
+A convenience function to connect multiple signals at once.
+
+The signal specs expected by this function have the form
+"modifier::signal_name", where modifier can be one of the following:
+
+
+signal
+
+equivalent to g_signal_connect_data (...)
+
+
+
+object_signal
+
+equivalent to g_signal_connect_object (...)
+
+
+
+swapped_signal
+
+equivalent to g_signal_connect_data (..., G_CONNECT_SWAPPED)
+
+
+
+swapped_object_signal
+
+equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED)
+
+
+
+signal_after
+
+equivalent to g_signal_connect_data (..., G_CONNECT_AFTER)
+
+
+
+object_signal_after
+
+equivalent to g_signal_connect_object (..., G_CONNECT_AFTER)
+
+
+
+swapped_signal_after
+
+equivalent to g_signal_connect_data (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)
+
+
+
+swapped_object_signal_after
+
+equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)
+
+
+
+
+
+
+ menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW,
+ "type", GTK_WINDOW_POPUP,
+ "child", menu,
+ NULL),
+ "signal::event", gtk_menu_window_event, menu,
+ "signal::size_request", gtk_menu_window_size_request, menu,
+ "signal::destroy", gtk_widget_destroyed, &menu->toplevel,
+ NULL);
+
+
-@object:
-@signal_spec:
-@Varargs:
-@Returns:
+@object: a #GObject
+@signal_spec: the spec for the first signal
+@Varargs: #GCallback for the first signal, followed by data for the first signal,
+ followed optionally by more signal spec/callback/data triples,
+ followed by %NULL
+@Returns: @object
-
+A convenience function to disconnect multiple signals at once.
+
+
+The signal specs expected by this function have the form "any_signal", which
+means to disconnect any signal with matching callback and data, or
+"any_signal::signal_name", which only disconnects the signal named "signal_name".
-@object:
-@signal_spec:
-@Varargs:
+@object: a #GObject
+@signal_spec: the spec for the first signal
+@Varargs: #GCallback for the first signal, followed by data for the first signal,
+ followed optionally by more signal spec/callback/data triples,
+ followed by %NULL
@@ -524,22 +599,24 @@ Gets a property of an object.
-
+Sets properties on an object.
-@object:
-@first_property_name:
-@var_args:
+@object: a #GObject
+@first_property_name: name of the first property to set
+@var_args: value for the first property, followed optionally by more
+ name/value pairs, followed by %NULL
-
+Gets properties of an object.
-@object:
-@first_property_name:
-@var_args:
+@object: a #GObject
+@first_property_name: name of the first property to get
+@var_args: return location for the first property, followed optionally by more
+ name/return location pairs, followed by %NULL