changeset 19966:96cab0f92851

merge of 'cecaf2df51b21064a99e3ca0588ae11a7b499b42' and 'ecbd9baf78c40e50643e5b185f453eb151aba5b9'
author Will Thompson <will.thompson@collabora.co.uk>
date Wed, 12 Sep 2007 13:44:12 +0000
parents 6f4facc932b6 (current diff) 47ad1aeae4aa (diff)
children e806fbd9ead8
files libpurple/dnsquery.h pidgin/pixmaps/emotes/default/24/madtongue.png
diffstat 1 files changed, 11 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/libpurple/dnsquery.h	Wed Sep 12 13:26:20 2007 +0000
+++ b/libpurple/dnsquery.h	Wed Sep 12 13:44:12 2007 +0000
@@ -45,16 +45,21 @@
 typedef void  (*PurpleDnsQueryFailedCallback) (PurpleDnsQueryData *query_data, const gchar *error_message);
 
 /**
- * DNS Request UI operations
+ * DNS Request UI operations;  UIs should implement this if they want to do DNS
+ * lookups themselves, rather than relying on the core.
+ *
+ * @see @ref ui-ops
  */
 typedef struct
 {
-	/* If implemented, the UI is responsible for DNS queries */
-	gboolean (*resolve_host)(PurpleDnsQueryData *query_data, PurpleDnsQueryResolvedCallback resolved_cb, PurpleDnsQueryFailedCallback failed_cb);
+	/** If implemented, the UI is responsible for DNS queries */
+	gboolean (*resolve_host)(PurpleDnsQueryData *query_data,
+	                         PurpleDnsQueryResolvedCallback resolved_cb,
+	                         PurpleDnsQueryFailedCallback failed_cb);
 
-	/* After destroy is called, query_data will be feed, so this must
-	 * cancel any further use of it the UI would do. Unneeded if 
-	 * resolve_host is not implemented.
+	/** Called just before @a query_data is freed; this should cancel any
+	 *  further use of @q query_data the UI would make. Unneeded if
+	 *  #resolve_host is not implemented.
 	 */
 	void (*destroy)(PurpleDnsQueryData *query_data);