From 390549f6c4968b14ce4a141781f1131f6a09eafe Mon Sep 17 00:00:00 2001
From: Alexander Larsson <alexl@redhat.com>
Date: Thu, 28 May 2009 15:33:52 +0200
Subject: [PATCH] Document g_socket_control_message_deserialize

---
 gio/gsocketcontrolmessage.c | 18 +++++++++++++-----
 1 file 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
  */
-- 
2.7.4