comparison libpurple/internal.h @ 25741:7183d12b96ed

propagate from branch 'im.pidgin.pidgin' (head 311b4db51b575e1baa7f78d751ff926475edecc3) to branch 'im.pidgin.cpw.malu.xmpp.ibb_ft' (head 2547f95c32d530b4f5c2d0cb5e65860482dc8138)
author Marcus Lundblad <ml@update.uu.se>
date Thu, 13 Nov 2008 19:50:53 +0000
parents 8282911d5e17
children 584063555949
comparison
equal deleted inserted replaced
25740:6ef1197c2db6 25741:7183d12b96ed
229 #define purple_strlcat(dest, src) g_strlcat(dest, src, sizeof(dest)) 229 #define purple_strlcat(dest, src) g_strlcat(dest, src, sizeof(dest))
230 230
231 #define PURPLE_WEBSITE "http://pidgin.im/" 231 #define PURPLE_WEBSITE "http://pidgin.im/"
232 #define PURPLE_DEVEL_WEBSITE "http://developer.pidgin.im/" 232 #define PURPLE_DEVEL_WEBSITE "http://developer.pidgin.im/"
233 233
234
235 /* INTERNAL FUNCTIONS */
236
237 #include "account.h"
238 #include "connection.h"
239
234 /* This is for the accounts code to notify the buddy icon code that 240 /* This is for the accounts code to notify the buddy icon code that
235 * it's done loading. We may want to replace this with a signal. */ 241 * it's done loading. We may want to replace this with a signal. */
236 void 242 void
237 _purple_buddy_icons_account_loaded_cb(void); 243 _purple_buddy_icons_account_loaded_cb(void);
238 244
245 * icon subsystem about the old icons directory so it can 251 * icon subsystem about the old icons directory so it can
246 * migrate any icons in use. */ 252 * migrate any icons in use. */
247 void 253 void
248 _purple_buddy_icon_set_old_icons_dir(const char *dirname); 254 _purple_buddy_icon_set_old_icons_dir(const char *dirname);
249 255
256 /**
257 * Creates a connection to the specified account and either connects
258 * or attempts to register a new account. If you are logging in,
259 * the connection uses the current active status for this account.
260 * So if you want to sign on as "away," for example, you need to
261 * have called purple_account_set_status(account, "away").
262 * (And this will call purple_account_connect() automatically).
263 *
264 * @note This function should only be called by purple_account_connect()
265 * in account.c. If you're trying to sign on an account, use that
266 * function instead.
267 *
268 * @param account The account the connection should be connecting to.
269 * @param regist Whether we are registering a new account or just
270 * trying to do a normal signon.
271 * @param password The password to use.
272 */
273 void _purple_connection_new(PurpleAccount *account, gboolean regist,
274 const char *password);
275 /**
276 * Tries to unregister the account on the server. If the account is not
277 * connected, also creates a new connection.
278 *
279 * @note This function should only be called by purple_account_unregister()
280 * in account.c.
281 *
282 * @param account The account to unregister
283 * @param password The password to use.
284 * @param cb Optional callback to be called when unregistration is complete
285 * @param user_data user data to pass to the callback
286 */
287 void _purple_connection_new_unregister(PurpleAccount *account, const char *password,
288 PurpleAccountUnregistrationCb cb, void *user_data);
289 /**
290 * Disconnects and destroys a PurpleConnection.
291 *
292 * @note This function should only be called by purple_account_disconnect()
293 * in account.c. If you're trying to sign off an account, use that
294 * function instead.
295 *
296 * @param gc The purple connection to destroy.
297 */
298 void _purple_connection_destroy(PurpleConnection *gc);
299
250 #endif /* _PURPLE_INTERNAL_H_ */ 300 #endif /* _PURPLE_INTERNAL_H_ */