[glib] Document g_socket_control_message_deserialize

[Alexander Larsson <alexl src gnome org>]

commit 390549f6c4968b14ce4a141781f1131f6a09eafe
Author: Alexander Larsson <alexl redhat com>
Date:   Thu May 28 15:33:52 2009 +0200

    Document g_socket_control_message_deserialize
---
 gio/gsocketcontrolmessage.c |   18 +++++++++++++-----
 1 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/gio/gsocketcontrolmessage.c b/gio/gsocketcontrolmessage.c
index 7af3990..2a384a7 100644
--- a/gio/gsocketcontrolmessage.c
+++ b/gio/gsocketcontrolmessage.c
@@ -153,12 +153,20 @@ g_socket_control_message_class_init (GSocketControlMessageClass *class)
 
 /**
  * g_socket_control_message_deserialize:
- * @level:
- * @type:
- * @size:
- * @data:
+ * @level: a socket level
+ * @type: a socket control message type for the given @level
+ * @size: the size of the data in bytes
+ * @data: pointer to the message data
  *
- * Returns: the deserialized message
+ * Tries to deserialize a socket control message of a given
+ * @level and @type. This will ask all known (to GType) subclasses
+ * of #GSocketControlMessage if they can understand this kind
+ * of message and if so deserialize it into a #GSocketControlMessage.
+ *
+ * If there is no implementation for this kind of control message, %NULL
+ * will be returned.
+ *
+ * Returns: the deserialized message or %NULL
  *
  * Since: 2.22
  */