[glib] Document g_signal_handlers_destroy

[Matthias Clasen <matthiasc src gnome org>]

commit ad5b4bf92e9a2afdea8d817e0d799c4c1ba0d4f7
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat May 31 09:02:27 2014 -0400

    Document g_signal_handlers_destroy

 gobject/gsignal.c |    6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)
---
diff --git a/gobject/gsignal.c b/gobject/gsignal.c
index c81a041..6c57f69 100644
--- a/gobject/gsignal.c
+++ b/gobject/gsignal.c
@@ -2609,7 +2609,11 @@ g_signal_handler_is_connected (gpointer instance,
 
 /**
  * g_signal_handlers_destroy:
- * @instance: (type GObject.Object): The instance where a signal handler is sought.
+ * @instance: (type GObject.Object): The instance whose signal handlers are destroyed
+ *
+ * Destroy all signal handlers of a type instance. This function is
+ * an implementation detail of the #GObject dispose implementation,
+ * and should not be used outside of the type system.
  */
 void
 g_signal_handlers_destroy (gpointer instance)