Mercurial > pidgin
changeset 30565:53dcfcc71953
jabber: Comment the problematic behavior of jabber_add_(feature|identity)
| author | Paul Aurich <paul@darkrain42.org> |
|---|---|
| date | Mon, 20 Sep 2010 03:25:12 +0000 |
| parents | 3f5ff1ea4802 |
| children | 0d2503e532a7 |
| files | libpurple/protocols/jabber/jabber.h |
| diffstat | 1 files changed, 17 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/libpurple/protocols/jabber/jabber.h Mon Sep 20 00:51:21 2010 +0000 +++ b/libpurple/protocols/jabber/jabber.h Mon Sep 20 03:25:12 2010 +0000 @@ -338,11 +338,25 @@ */ char *jabber_parse_error(JabberStream *js, xmlnode *packet, PurpleConnectionError *reason); -void jabber_add_feature(const gchar *namespace, JabberFeatureEnabled cb); /* cb may be NULL */ +/** + * Add a feature to the list of features advertised via disco#info. If you + * call this while accounts are connected, Bad Things(TM) will happen because + * the Entity Caps hash will be out-of-date (which should be fixed :/) + * + * @param namespace The namespace of the feature + * @param cb A callback determining whether or not this feature + * will advertised; may be NULL. + */ +void jabber_add_feature(const gchar *namespace, JabberFeatureEnabled cb); void jabber_remove_feature(const gchar *namespace); -/** Adds an identity to this jabber library instance. For list of valid values visit the - * website of the XMPP Registrar ( http://www.xmpp.org/registrar/disco-categories.html#client ). +/** Adds an identity to this jabber library instance. For list of valid values + * visit the website of the XMPP Registrar + * (http://www.xmpp.org/registrar/disco-categories.html#client). + * + * Like with jabber_add_feature, if you call this while accounts are connected, + * Bad Things will happen. + * * @param category the category of the identity. * @param type the type of the identity. * @param language the language localization of the name. Can be NULL.