Mercurial > pidgin
changeset 19774: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);