| blist.h | | blist.h | |
| | | | |
| skipping to change at line 74 | | skipping to change at line 74 | |
| #define PURPLE_BLIST_NODE_IS_BUDDY(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_BUDDY_NODE) | | #define PURPLE_BLIST_NODE_IS_BUDDY(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_BUDDY_NODE) | |
| #define PURPLE_BLIST_NODE_IS_CONTACT(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_CONTACT_NODE) | | #define PURPLE_BLIST_NODE_IS_CONTACT(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_CONTACT_NODE) | |
| #define PURPLE_BLIST_NODE_IS_GROUP(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_GROUP_NODE) | | #define PURPLE_BLIST_NODE_IS_GROUP(n) (purple_blist_node_get_type(n) == P
URPLE_BLIST_GROUP_NODE) | |
| | | | |
| #define PURPLE_BUDDY_IS_ONLINE(b) \ | | #define PURPLE_BUDDY_IS_ONLINE(b) \ | |
| ((b) != NULL && purple_account_is_connected(purple_buddy_get_account
(b)) && \ | | ((b) != NULL && purple_account_is_connected(purple_buddy_get_account
(b)) && \ | |
| purple_presence_is_online(purple_buddy_get_presence(b))) | | purple_presence_is_online(purple_buddy_get_presence(b))) | |
| | | | |
| typedef enum | | typedef enum | |
| { | | { | |
|
| PURPLE_BLIST_NODE_FLAG_NO_SAVE = 1 << 0, /**< node should not b
e saved with the buddy list */ | | PURPLE_BLIST_NODE_FLAG_NO_SAVE = 1 << 0 /**< node should not be
saved with the buddy list */ | |
| | | | |
| } PurpleBlistNodeFlags; | | } PurpleBlistNodeFlags; | |
| | | | |
|
| #define PURPLE_BLIST_NODE_HAS_FLAG(b, f) (((PurpleBlistNode*)(b))->flags &
(f)) | | #define PURPLE_BLIST_NODE_HAS_FLAG(b, f) (purple_blist_node_get_flags((Purp
leBlistNode*)(b)) & (f)) | |
| #define PURPLE_BLIST_NODE_SHOULD_SAVE(b) (! PURPLE_BLIST_NODE_HAS_FLAG(b, P
URPLE_BLIST_NODE_FLAG_NO_SAVE)) | | #define PURPLE_BLIST_NODE_SHOULD_SAVE(b) (! PURPLE_BLIST_NODE_HAS_FLAG(b, P
URPLE_BLIST_NODE_FLAG_NO_SAVE)) | |
| | | | |
|
| #define PURPLE_BLIST_NODE_NAME(n) ((n)->type == PURPLE_BLIST_CHAT_NODE ? p | | #define PURPLE_BLIST_NODE_NAME(n) (purple_blist_node_get_type(n) == PURPLE_ | |
| urple_chat_get_name((PurpleChat*)n) : \ | | BLIST_CHAT_NODE ? purple_chat_get_name((PurpleChat*)n) : \ | |
| (n)->type == PURPLE_BLIST_BUDDY_NODE ? | | purple_blist_node_get_type(n) == PURPLE | |
| purple_buddy_get_name((PurpleBuddy*)n) : NULL) | | _BLIST_BUDDY_NODE ? purple_buddy_get_name((PurpleBuddy*)n) : NULL) | |
| | | | |
| #include "account.h" | | #include "account.h" | |
| #include "buddyicon.h" | | #include "buddyicon.h" | |
| #include "status.h" | | #include "status.h" | |
| | | | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| /* Data Structures *
/ | | /* Data Structures *
/ | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| | | | |
|
| | | #if !(defined PURPLE_HIDE_STRUCTS) || (defined _PURPLE_BLIST_C_) | |
| | | | |
| /** | | /** | |
| * A Buddy list node. This can represent a group, a buddy, or anything els
e. | | * A Buddy list node. This can represent a group, a buddy, or anything els
e. | |
| * This is a base class for struct buddy and struct group and for anything | | * This is a base class for struct buddy and struct group and for anything | |
| * else that wants to put itself in the buddy list. */ | | * else that wants to put itself in the buddy list. */ | |
| struct _PurpleBlistNode { | | struct _PurpleBlistNode { | |
| PurpleBlistNodeType type; /**< The type of node this is
*/ | | PurpleBlistNodeType type; /**< The type of node this is
*/ | |
| PurpleBlistNode *prev; /**< The sibling before this b
uddy. */ | | PurpleBlistNode *prev; /**< The sibling before this b
uddy. */ | |
| PurpleBlistNode *next; /**< The sibling after this bu
ddy. */ | | PurpleBlistNode *next; /**< The sibling after this bu
ddy. */ | |
| PurpleBlistNode *parent; /**< The parent of this node
*/ | | PurpleBlistNode *parent; /**< The parent of this node
*/ | |
| PurpleBlistNode *child; /**< The child of this node
*/ | | PurpleBlistNode *child; /**< The child of this node
*/ | |
| | | | |
| skipping to change at line 156 | | skipping to change at line 158 | |
| * A chat. This contains everything Purple needs to put a chat room in the | | * A chat. This contains everything Purple needs to put a chat room in the | |
| * buddy list. | | * buddy list. | |
| */ | | */ | |
| struct _PurpleChat { | | struct _PurpleChat { | |
| PurpleBlistNode node; /**< The node that this chat inherits fro
m */ | | PurpleBlistNode node; /**< The node that this chat inherits fro
m */ | |
| char *alias; /**< The display name of this chat. */ | | char *alias; /**< The display name of this chat. */ | |
| GHashTable *components; /**< the stuff the protocol needs to know t
o join the chat */ | | GHashTable *components; /**< the stuff the protocol needs to know t
o join the chat */ | |
| PurpleAccount *account; /**< The account this chat is attached to */ | | PurpleAccount *account; /**< The account this chat is attached to */ | |
| }; | | }; | |
| | | | |
|
| | | #endif /* PURPLE_HIDE_STRUCTS && PURPLE_BLIST_STRUCTS */ | |
| | | | |
| /** | | /** | |
| * The Buddy List | | * The Buddy List | |
| */ | | */ | |
| struct _PurpleBuddyList { | | struct _PurpleBuddyList { | |
| PurpleBlistNode *root; /**< The first node in the buddy lis
t */ | | PurpleBlistNode *root; /**< The first node in the buddy lis
t */ | |
| GHashTable *buddies; /**< Every buddy in this list */ | | GHashTable *buddies; /**< Every buddy in this list */ | |
| void *ui_data; /**< UI-specific data. */ | | void *ui_data; /**< UI-specific data. */ | |
| }; | | }; | |
| | | | |
| /** | | /** | |
| | | | |
| skipping to change at line 331 | | skipping to change at line 335 | |
| void purple_blist_update_buddy_status(PurpleBuddy *buddy, PurpleStatus *old
_status); | | void purple_blist_update_buddy_status(PurpleBuddy *buddy, PurpleStatus *old
_status); | |
| | | | |
| /** | | /** | |
| * Updates a node's custom icon. | | * Updates a node's custom icon. | |
| * | | * | |
| * @param node The PurpleBlistNode whose custom icon has changed. | | * @param node The PurpleBlistNode whose custom icon has changed. | |
| * @since 2.5.0 | | * @since 2.5.0 | |
| */ | | */ | |
| void purple_blist_update_node_icon(PurpleBlistNode *node); | | void purple_blist_update_node_icon(PurpleBlistNode *node); | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_BLIST_C_) | |
| /** | | /** | |
| * Updates a buddy's icon. | | * Updates a buddy's icon. | |
| * | | * | |
| * @param buddy The buddy whose buddy icon has changed | | * @param buddy The buddy whose buddy icon has changed | |
| * @deprecated Use purple_blist_update_node_icon() instead. | | * @deprecated Use purple_blist_update_node_icon() instead. | |
| */ | | */ | |
| void purple_blist_update_buddy_icon(PurpleBuddy *buddy); | | void purple_blist_update_buddy_icon(PurpleBuddy *buddy); | |
| #endif | | #endif | |
| | | | |
| /** | | /** | |
| | | | |
| skipping to change at line 557 | | skipping to change at line 561 | |
| void purple_blist_merge_contact(PurpleContact *source, PurpleBlistNode *nod
e); | | void purple_blist_merge_contact(PurpleContact *source, PurpleBlistNode *nod
e); | |
| | | | |
| /** | | /** | |
| * Returns the highest priority buddy for a given contact. | | * Returns the highest priority buddy for a given contact. | |
| * | | * | |
| * @param contact The contact | | * @param contact The contact | |
| * @return The highest priority buddy | | * @return The highest priority buddy | |
| */ | | */ | |
| PurpleBuddy *purple_contact_get_priority_buddy(PurpleContact *contact); | | PurpleBuddy *purple_contact_get_priority_buddy(PurpleContact *contact); | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_BLIST_C_) | |
| /** | | /** | |
| * Sets the alias for a contact. | | * Sets the alias for a contact. | |
| * | | * | |
| * @param contact The contact | | * @param contact The contact | |
| * @param alias The alias to set, or NULL to unset | | * @param alias The alias to set, or NULL to unset | |
| * | | * | |
| * @deprecated Use purple_blist_alias_contact() instead. | | * @deprecated Use purple_blist_alias_contact() instead. | |
| */ | | */ | |
| void purple_contact_set_alias(PurpleContact *contact, const char *alias); | | void purple_contact_set_alias(PurpleContact *contact, const char *alias); | |
| #endif | | #endif | |
| | | | |
End of changes. 7 change blocks. |
| 8 lines changed or deleted | | 12 lines changed or added | |
|
| cmds.h | | cmds.h | |
| | | | |
| skipping to change at line 41 | | skipping to change at line 41 | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| /*@{*/ | | /*@{*/ | |
| | | | |
| /** The possible results of running a command with purple_cmd_do_command().
*/ | | /** The possible results of running a command with purple_cmd_do_command().
*/ | |
| typedef enum _PurpleCmdStatus { | | typedef enum _PurpleCmdStatus { | |
| PURPLE_CMD_STATUS_OK, | | PURPLE_CMD_STATUS_OK, | |
| PURPLE_CMD_STATUS_FAILED, | | PURPLE_CMD_STATUS_FAILED, | |
| PURPLE_CMD_STATUS_NOT_FOUND, | | PURPLE_CMD_STATUS_NOT_FOUND, | |
| PURPLE_CMD_STATUS_WRONG_ARGS, | | PURPLE_CMD_STATUS_WRONG_ARGS, | |
| PURPLE_CMD_STATUS_WRONG_PRPL, | | PURPLE_CMD_STATUS_WRONG_PRPL, | |
|
| PURPLE_CMD_STATUS_WRONG_TYPE, | | PURPLE_CMD_STATUS_WRONG_TYPE | |
| } PurpleCmdStatus; | | } PurpleCmdStatus; | |
| | | | |
| /** Commands registered with the core return one of these values when run. | | /** Commands registered with the core return one of these values when run. | |
| * Normally, a command will want to return one of the first two; in some | | * Normally, a command will want to return one of the first two; in some | |
| * unusual cases, you might want to have several functions called for a | | * unusual cases, you might want to have several functions called for a | |
| * particular command; in this case, they should return | | * particular command; in this case, they should return | |
| * #PURPLE_CMD_RET_CONTINUE to cause the core to fall through to other | | * #PURPLE_CMD_RET_CONTINUE to cause the core to fall through to other | |
| * commands with the same name. | | * commands with the same name. | |
| */ | | */ | |
| typedef enum _PurpleCmdRet { | | typedef enum _PurpleCmdRet { | |
| PURPLE_CMD_RET_OK, /**< Everything's okay; Don't look for anot
her command to call. */ | | PURPLE_CMD_RET_OK, /**< Everything's okay; Don't look for anot
her command to call. */ | |
| PURPLE_CMD_RET_FAILED, /**< The command failed, but stop looking.*
/ | | PURPLE_CMD_RET_FAILED, /**< The command failed, but stop looking.*
/ | |
|
| PURPLE_CMD_RET_CONTINUE, /**< Continue, looking for other commands w
ith the same name to call. */ | | PURPLE_CMD_RET_CONTINUE /**< Continue, looking for other commands wi
th the same name to call. */ | |
| } PurpleCmdRet; | | } PurpleCmdRet; | |
| | | | |
| #define PURPLE_CMD_FUNC(func) ((PurpleCmdFunc)func) | | #define PURPLE_CMD_FUNC(func) ((PurpleCmdFunc)func) | |
| | | | |
| /** A function implementing a command, as passed to purple_cmd_register(). | | /** A function implementing a command, as passed to purple_cmd_register(). | |
| * | | * | |
| * @todo document the arguments to these functions. | | * @todo document the arguments to these functions. | |
| * */ | | * */ | |
| typedef PurpleCmdRet (*PurpleCmdFunc)(PurpleConversation *, const gchar *cm
d, | | typedef PurpleCmdRet (*PurpleCmdFunc)(PurpleConversation *, const gchar *cm
d, | |
| gchar **args, gchar **error, void *data); | | gchar **args, gchar **error, void *data); | |
| | | | |
| skipping to change at line 79 | | skipping to change at line 79 | |
| typedef guint PurpleCmdId; | | typedef guint PurpleCmdId; | |
| | | | |
| typedef enum _PurpleCmdPriority { | | typedef enum _PurpleCmdPriority { | |
| PURPLE_CMD_P_VERY_LOW = -1000, | | PURPLE_CMD_P_VERY_LOW = -1000, | |
| PURPLE_CMD_P_LOW = 0, | | PURPLE_CMD_P_LOW = 0, | |
| PURPLE_CMD_P_DEFAULT = 1000, | | PURPLE_CMD_P_DEFAULT = 1000, | |
| PURPLE_CMD_P_PRPL = 2000, | | PURPLE_CMD_P_PRPL = 2000, | |
| PURPLE_CMD_P_PLUGIN = 3000, | | PURPLE_CMD_P_PLUGIN = 3000, | |
| PURPLE_CMD_P_ALIAS = 4000, | | PURPLE_CMD_P_ALIAS = 4000, | |
| PURPLE_CMD_P_HIGH = 5000, | | PURPLE_CMD_P_HIGH = 5000, | |
|
| PURPLE_CMD_P_VERY_HIGH = 6000, | | PURPLE_CMD_P_VERY_HIGH = 6000 | |
| } PurpleCmdPriority; | | } PurpleCmdPriority; | |
| | | | |
| /** Flags used to set various properties of commands. Every command should | | /** Flags used to set various properties of commands. Every command should | |
| * have at least one of #PURPLE_CMD_FLAG_IM and #PURPLE_CMD_FLAG_CHAT set
in | | * have at least one of #PURPLE_CMD_FLAG_IM and #PURPLE_CMD_FLAG_CHAT set
in | |
| * order to be even slighly useful. | | * order to be even slighly useful. | |
| * | | * | |
| * @see purple_cmd_register | | * @see purple_cmd_register | |
| */ | | */ | |
| typedef enum _PurpleCmdFlag { | | typedef enum _PurpleCmdFlag { | |
| /** Command is usable in IMs. */ | | /** Command is usable in IMs. */ | |
| PURPLE_CMD_FLAG_IM = 0x01, | | PURPLE_CMD_FLAG_IM = 0x01, | |
| /** Command is usable in multi-user chats. */ | | /** Command is usable in multi-user chats. */ | |
| PURPLE_CMD_FLAG_CHAT = 0x02, | | PURPLE_CMD_FLAG_CHAT = 0x02, | |
| /** Command is usable only for a particular prpl. */ | | /** Command is usable only for a particular prpl. */ | |
| PURPLE_CMD_FLAG_PRPL_ONLY = 0x04, | | PURPLE_CMD_FLAG_PRPL_ONLY = 0x04, | |
| /** Incorrect arguments to this command should be accepted anyway. *
/ | | /** Incorrect arguments to this command should be accepted anyway. *
/ | |
|
| PURPLE_CMD_FLAG_ALLOW_WRONG_ARGS = 0x08, | | PURPLE_CMD_FLAG_ALLOW_WRONG_ARGS = 0x08 | |
| } PurpleCmdFlag; | | } PurpleCmdFlag; | |
| | | | |
| /*@}*/ | | /*@}*/ | |
| | | | |
| #ifdef __cplusplus | | #ifdef __cplusplus | |
| extern "C" { | | extern "C" { | |
| #endif | | #endif | |
| | | | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| /** @name Commands API *
/ | | /** @name Commands API *
/ | |
| | | | |
End of changes. 4 change blocks. |
| 4 lines changed or deleted | | 4 lines changed or added | |
|
| connection.h | | connection.h | |
| | | | |
| skipping to change at line 47 | | skipping to change at line 47 | |
| { | | { | |
| PURPLE_CONNECTION_HTML = 0x0001, /**< Connection sends/receive
s in 'HTML'. */ | | PURPLE_CONNECTION_HTML = 0x0001, /**< Connection sends/receive
s in 'HTML'. */ | |
| PURPLE_CONNECTION_NO_BGCOLOR = 0x0002, /**< Connection does not send
/receive | | PURPLE_CONNECTION_NO_BGCOLOR = 0x0002, /**< Connection does not send
/receive | |
| background colors.
*/ | | background colors.
*/ | |
| PURPLE_CONNECTION_AUTO_RESP = 0x0004, /**< Send auto responses whe
n away. */ | | PURPLE_CONNECTION_AUTO_RESP = 0x0004, /**< Send auto responses whe
n away. */ | |
| PURPLE_CONNECTION_FORMATTING_WBFO = 0x0008, /**< The text buffer mus
t be formatted as a whole */ | | PURPLE_CONNECTION_FORMATTING_WBFO = 0x0008, /**< The text buffer mus
t be formatted as a whole */ | |
| PURPLE_CONNECTION_NO_NEWLINES = 0x0010, /**< No new lines are allowe
d in outgoing messages */ | | PURPLE_CONNECTION_NO_NEWLINES = 0x0010, /**< No new lines are allowe
d in outgoing messages */ | |
| PURPLE_CONNECTION_NO_FONTSIZE = 0x0020, /**< Connection does not sen
d/receive font sizes */ | | PURPLE_CONNECTION_NO_FONTSIZE = 0x0020, /**< Connection does not sen
d/receive font sizes */ | |
| PURPLE_CONNECTION_NO_URLDESC = 0x0040, /**< Connection does not sup
port descriptions with links */ | | PURPLE_CONNECTION_NO_URLDESC = 0x0040, /**< Connection does not sup
port descriptions with links */ | |
| PURPLE_CONNECTION_NO_IMAGES = 0x0080, /**< Connection does not supp
ort sending of images */ | | PURPLE_CONNECTION_NO_IMAGES = 0x0080, /**< Connection does not supp
ort sending of images */ | |
|
| PURPLE_CONNECTION_ALLOW_CUSTOM_SMILEY = 0x0100, /**< Connection supp
orts sending and receiving custom smileys */ | | PURPLE_CONNECTION_ALLOW_CUSTOM_SMILEY = 0x0100 /**< Connection suppo
rts sending and receiving custom smileys */ | |
| | | | |
| } PurpleConnectionFlags; | | } PurpleConnectionFlags; | |
| | | | |
| typedef enum | | typedef enum | |
| { | | { | |
| PURPLE_DISCONNECTED = 0, /**< Disconnected. */ | | PURPLE_DISCONNECTED = 0, /**< Disconnected. */ | |
| PURPLE_CONNECTED, /**< Connected. */ | | PURPLE_CONNECTED, /**< Connected. */ | |
| PURPLE_CONNECTING /**< Connecting. */ | | PURPLE_CONNECTING /**< Connecting. */ | |
| | | | |
| } PurpleConnectionState; | | } PurpleConnectionState; | |
| | | | |
| skipping to change at line 270 | | skipping to change at line 270 | |
| | | | |
| #ifdef __cplusplus | | #ifdef __cplusplus | |
| extern "C" { | | extern "C" { | |
| #endif | | #endif | |
| | | | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| /** @name Connection API *
/ | | /** @name Connection API *
/ | |
| /**************************************************************************
/ | | /**************************************************************************
/ | |
| /*@{*/ | | /*@{*/ | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_CONNECTION_C_) | |
| /** | | /** | |
| * This function should only be called by purple_account_connect() | | * This function should only be called by purple_account_connect() | |
| * in account.c. If you're trying to sign on an account, use that | | * in account.c. If you're trying to sign on an account, use that | |
| * function instead. | | * function instead. | |
| * | | * | |
| * Creates a connection to the specified account and either connects | | * Creates a connection to the specified account and either connects | |
| * or attempts to register a new account. If you are logging in, | | * or attempts to register a new account. If you are logging in, | |
| * the connection uses the current active status for this account. | | * the connection uses the current active status for this account. | |
| * So if you want to sign on as "away," for example, you need to | | * So if you want to sign on as "away," for example, you need to | |
| * have called purple_account_set_status(account, "away"). | | * have called purple_account_set_status(account, "away"). | |
| | | | |
| skipping to change at line 294 | | skipping to change at line 294 | |
| * @param regist Whether we are registering a new account or just | | * @param regist Whether we are registering a new account or just | |
| * trying to do a normal signon. | | * trying to do a normal signon. | |
| * @param password The password to use. | | * @param password The password to use. | |
| * | | * | |
| * @deprecated As this is internal, we should make it private in 3.0.0. | | * @deprecated As this is internal, we should make it private in 3.0.0. | |
| */ | | */ | |
| void purple_connection_new(PurpleAccount *account, gboolean regist, | | void purple_connection_new(PurpleAccount *account, gboolean regist, | |
| cons
t char *password); | | cons
t char *password); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_CONNECTION_C_) | |
| /** | | /** | |
| * This function should only be called by purple_account_unregister() | | * This function should only be called by purple_account_unregister() | |
| * in account.c. | | * in account.c. | |
| * | | * | |
| * Tries to unregister the account on the server. If the account is not | | * Tries to unregister the account on the server. If the account is not | |
| * connected, also creates a new connection. | | * connected, also creates a new connection. | |
| * | | * | |
| * @param account The account to unregister | | * @param account The account to unregister | |
| * @param password The password to use. | | * @param password The password to use. | |
| * @param cb Optional callback to be called when unregistration is complete | | * @param cb Optional callback to be called when unregistration is complete | |
| * @param user_data user data to pass to the callback | | * @param user_data user data to pass to the callback | |
| * | | * | |
| * @deprecated As this is internal, we should make it private in 3.0.0. | | * @deprecated As this is internal, we should make it private in 3.0.0. | |
| */ | | */ | |
| void purple_connection_new_unregister(PurpleAccount *account, const char *p
assword, PurpleAccountUnregistrationCb cb, void *user_data); | | void purple_connection_new_unregister(PurpleAccount *account, const char *p
assword, PurpleAccountUnregistrationCb cb, void *user_data); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_CONNECTION_C_) | |
| /** | | /** | |
| * Disconnects and destroys a PurpleConnection. | | * Disconnects and destroys a PurpleConnection. | |
| * | | * | |
| * This function should only be called by purple_account_disconnect() | | * This function should only be called by purple_account_disconnect() | |
| * in account.c. If you're trying to sign off an account, use that | | * in account.c. If you're trying to sign off an account, use that | |
| * function instead. | | * function instead. | |
| * | | * | |
| * @param gc The purple connection to destroy. | | * @param gc The purple connection to destroy. | |
| * | | * | |
| * @deprecated As this is internal, we should make it private in 3.0.0. | | * @deprecated As this is internal, we should make it private in 3.0.0. | |
| | | | |
End of changes. 4 change blocks. |
| 4 lines changed or deleted | | 4 lines changed or added | |
|
| notify.h | | notify.h | |
| | | | |
| skipping to change at line 229 | | skipping to change at line 229 | |
| * @param data Data returned by the purple_notify_searchresults(). | | * @param data Data returned by the purple_notify_searchresults(). | |
| */ | | */ | |
| void purple_notify_searchresults_new_rows(PurpleConnection *gc, | | void purple_notify_searchresults_new_rows(PurpleConnection *gc, | |
|
PurpleNotifySearchResults *results, | |
PurpleNotifySearchResults *results, | |
|
void *data); | |
void *data); | |
| | | | |
| /** | | /** | |
| * Adds a stock button that will be displayed in the search results dialog. | | * Adds a stock button that will be displayed in the search results dialog. | |
| * | | * | |
| * @param results The search results object. | | * @param results The search results object. | |
|
| * @param type Type of the button. (TODO: Only one button of a given typ | | * @param type Type of the button. (TODO: Only one button of a given typ | |
| e can be displayed.) | | e | |
| | | * can be displayed.) | |
| * @param cb Function that will be called on the click event. | | * @param cb Function that will be called on the click event. | |
| */ | | */ | |
| void purple_notify_searchresults_button_add(PurpleNotifySearchResults *resu
lts, | | void purple_notify_searchresults_button_add(PurpleNotifySearchResults *resu
lts, | |
|
PurpleNotifySearchButtonType type, | |
PurpleNotifySearchButtonType type, | |
|
PurpleNotifySearchResultsCallback cb); | |
PurpleNotifySearchResultsCallback cb); | |
| | | | |
| /** | | /** | |
|
| * Adds a plain labelled button that will be displayed in the search result | | * Adds a plain labelled button that will be displayed in the search result | |
| s dialog. | | s | |
| | | * dialog. | |
| * | | * | |
| * @param results The search results object | | * @param results The search results object | |
| * @param label The label to display | | * @param label The label to display | |
| * @param cb Function that will be called on the click event | | * @param cb Function that will be called on the click event | |
| */ | | */ | |
| void purple_notify_searchresults_button_add_labeled(PurpleNotifySearchResul
ts *results, | | void purple_notify_searchresults_button_add_labeled(PurpleNotifySearchResul
ts *results, | |
| const char *label, | | const char *label, | |
| PurpleNotifySearchResults
Callback cb); | | PurpleNotifySearchResults
Callback cb); | |
| | | | |
| /** | | /** | |
| | | | |
| skipping to change at line 280 | | skipping to change at line 282 | |
|
PurpleNotifySearchColumn *column); | |
PurpleNotifySearchColumn *column); | |
| | | | |
| /** | | /** | |
| * Adds a new row of the results to the search results object. | | * Adds a new row of the results to the search results object. | |
| * | | * | |
| * @param results The search results object. | | * @param results The search results object. | |
| * @param row The row of the results. | | * @param row The row of the results. | |
| */ | | */ | |
| void purple_notify_searchresults_row_add(PurpleNotifySearchResults *results
, | | void purple_notify_searchresults_row_add(PurpleNotifySearchResults *results
, | |
| G
List *row); | | G
List *row); | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_NOTIFY_C_) | |
| /** | | /** | |
| * Returns a number of the rows in the search results object. | | * Returns a number of the rows in the search results object. | |
| * | | * | |
| * @deprecated This function will be removed in Pidgin 3.0.0 unless | | * @deprecated This function will be removed in Pidgin 3.0.0 unless | |
| * there is sufficient demand to keep it. Using this | | * there is sufficient demand to keep it. Using this | |
| * function encourages looping through the results | | * function encourages looping through the results | |
| * inefficiently. Instead of using this function you | | * inefficiently. Instead of using this function you | |
| * should iterate through the results using a loop | | * should iterate through the results using a loop | |
| * similar to this: | | * similar to this: | |
| * for (l = results->rows; l != NULL; l = l->next) | | * for (l = results->rows; l != NULL; l = l->next) | |
| * If you really need to get the number of rows you | | * If you really need to get the number of rows you | |
| * can use g_list_length(results->rows). | | * can use g_list_length(results->rows). | |
| * | | * | |
| * @param results The search results object. | | * @param results The search results object. | |
| * | | * | |
| * @return Number of the result rows. | | * @return Number of the result rows. | |
| */ | | */ | |
| guint purple_notify_searchresults_get_rows_count(PurpleNotifySearchResults
*results); | | guint purple_notify_searchresults_get_rows_count(PurpleNotifySearchResults
*results); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_NOTIFY_C_) | |
| /** | | /** | |
| * Returns a number of the columns in the search results object. | | * Returns a number of the columns in the search results object. | |
| * | | * | |
| * @deprecated This function will be removed in Pidgin 3.0.0 unless | | * @deprecated This function will be removed in Pidgin 3.0.0 unless | |
| * there is sufficient demand to keep it. Using this | | * there is sufficient demand to keep it. Using this | |
| * function encourages looping through the columns | | * function encourages looping through the columns | |
| * inefficiently. Instead of using this function you | | * inefficiently. Instead of using this function you | |
| * should iterate through the columns using a loop | | * should iterate through the columns using a loop | |
| * similar to this: | | * similar to this: | |
| * for (l = results->columns; l != NULL; l = l->next) | | * for (l = results->columns; l != NULL; l = l->next) | |
| * If you really need to get the number of columns you | | * If you really need to get the number of columns you | |
| * can use g_list_length(results->columns). | | * can use g_list_length(results->columns). | |
| * | | * | |
| * @param results The search results object. | | * @param results The search results object. | |
| * | | * | |
| * @return Number of the columns. | | * @return Number of the columns. | |
| */ | | */ | |
| guint purple_notify_searchresults_get_columns_count(PurpleNotifySearchResul
ts *results); | | guint purple_notify_searchresults_get_columns_count(PurpleNotifySearchResul
ts *results); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_NOTIFY_C_) | |
| /** | | /** | |
| * Returns a row of the results from the search results object. | | * Returns a row of the results from the search results object. | |
| * | | * | |
| * @deprecated This function will be removed in Pidgin 3.0.0 unless | | * @deprecated This function will be removed in Pidgin 3.0.0 unless | |
| * there is sufficient demand to keep it. Using this | | * there is sufficient demand to keep it. Using this | |
| * function encourages looping through the results | | * function encourages looping through the results | |
| * inefficiently. Instead of using this function you | | * inefficiently. Instead of using this function you | |
| * should iterate through the results using a loop | | * should iterate through the results using a loop | |
| * similar to this: | | * similar to this: | |
| * for (l = results->rows; l != NULL; l = l->next) | | * for (l = results->rows; l != NULL; l = l->next) | |
| | | | |
| skipping to change at line 345 | | skipping to change at line 347 | |
| * | | * | |
| * @param results The search results object. | | * @param results The search results object. | |
| * @param row_id Index of the row to be returned. | | * @param row_id Index of the row to be returned. | |
| * | | * | |
| * @return Row of the results. | | * @return Row of the results. | |
| */ | | */ | |
| GList *purple_notify_searchresults_row_get(PurpleNotifySearchResults *resul
ts, | | GList *purple_notify_searchresults_row_get(PurpleNotifySearchResults *resul
ts, | |
|
unsigned int row_id); | |
unsigned int row_id); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_NOTIFY_C_) | |
| /** | | /** | |
| * Returns a title of the search results object's column. | | * Returns a title of the search results object's column. | |
| * | | * | |
| * @deprecated This function will be removed in Pidgin 3.0.0 unless | | * @deprecated This function will be removed in Pidgin 3.0.0 unless | |
| * there is sufficient demand to keep it. Using this | | * there is sufficient demand to keep it. Using this | |
| * function encourages looping through the columns | | * function encourages looping through the columns | |
| * inefficiently. Instead of using this function you | | * inefficiently. Instead of using this function you | |
| * should iterate through the name of a particular | | * should iterate through the name of a particular | |
| * column you can use | | * column you can use | |
| * g_list_nth_data(results->columns, row_id). | | * g_list_nth_data(results->columns, row_id). | |
| | | | |
| skipping to change at line 461 | | skipping to change at line 463 | |
| const char *primary,
const char *secondary, | | const char *primary,
const char *secondary, | |
| const char *text, Pu
rpleNotifyCloseCallback cb, gpointer user_data); | | const char *text, Pu
rpleNotifyCloseCallback cb, gpointer user_data); | |
| | | | |
| /** | | /** | |
| * Displays user information with formatted text, passing information givin
g | | * Displays user information with formatted text, passing information givin
g | |
| * the connection and username from which the user information came. | | * the connection and username from which the user information came. | |
| * | | * | |
| * The text is essentially a stripped-down format of HTML, the same that | | * The text is essentially a stripped-down format of HTML, the same that | |
| * IMs may send. | | * IMs may send. | |
| * | | * | |
|
| * @param gc The PurpleConnection handle associated with | | * @param gc The PurpleConnection handle associated with the inform | |
| the information. | | ation. | |
| * @param who The username associated with the in | | * @param who The username associated with the information. | |
| formation. | | * @param user_info The PurpleNotifyUserInfo which contains the informatio | |
| * @param user_info The PurpleNotifyUserInfo which contains the in | | n | |
| formation | | * @param cb The callback to call when the user closes the notifica | |
| * @param cb The callback to call when the user closes | | tion. | |
| * the notification. | | * @param user_data The data to pass to the callback. | |
| * @param user_data The data to pass to the callback. | | | |
| * | | * | |
|
| * @return A UI-specific handle. | | * @return A UI-specific handle. | |
| */ | | */ | |
| void *purple_notify_userinfo(PurpleConnection *gc, const char *who, | | void *purple_notify_userinfo(PurpleConnection *gc, const char *who, | |
| PurpleNotifyUserInfo *use
r_info, PurpleNotifyCloseCallback cb, | | PurpleNotifyUserInfo *use
r_info, PurpleNotifyCloseCallback cb, | |
| gpointer user_data); | | gpointer user_data); | |
| | | | |
| /** | | /** | |
|
| * Create a new PurpleNotifyUserInfo which is suitable for passing to purpl | | * Create a new PurpleNotifyUserInfo which is suitable for passing to | |
| e_notify_userinfo() | | * purple_notify_userinfo() | |
| * | | * | |
|
| * @return A new PurpleNotifyUserInfo, which the caller must destroy when d
one | | * @return A new PurpleNotifyUserInfo, which the caller must destroy when
done | |
| */ | | */ | |
| PurpleNotifyUserInfo *purple_notify_user_info_new(void); | | PurpleNotifyUserInfo *purple_notify_user_info_new(void); | |
| | | | |
| /** | | /** | |
| * Destroy a PurpleNotifyUserInfo | | * Destroy a PurpleNotifyUserInfo | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| */ | | */ | |
| void purple_notify_user_info_destroy(PurpleNotifyUserInfo *user_info); | | void purple_notify_user_info_destroy(PurpleNotifyUserInfo *user_info); | |
| | | | |
| /** | | /** | |
|
| * Retrieve the array of PurpleNotifyUserInfoEntry objects from a PurpleNot | | * Retrieve the array of PurpleNotifyUserInfoEntry objects from a | |
| ifyUserInfo | | * PurpleNotifyUserInfo | |
| * | | * | |
|
| * This GList may be manipulated directly with normal GList functions such | | * This GList may be manipulated directly with normal GList functions such | |
| as g_list_insert(). Only | | * as g_list_insert(). Only PurpleNotifyUserInfoEntry are allowed in the | |
| * PurpleNotifyUserInfoEntry are allowed in the list. If a PurpleNotifyUse | | * list. If a PurpleNotifyUserInfoEntry item is added to the list, it | |
| rInfoEntry item is added to the list, | | * should not be g_free()'d by the caller; PurpleNotifyUserInfo will g_free | |
| * it should not be g_free()'d by the caller; PurpleNotifyUserInfo will g_f | | * it when destroyed. | |
| ree it when destroyed. | | | |
| * | | * | |
|
| * To remove a PurpleNotifyUserInfoEntry, use purple_notify_user_info_remov | | * To remove a PurpleNotifyUserInfoEntry, use | |
| e_entry(). Do not use the GList directly. | | * purple_notify_user_info_remove_entry(). Do not use the GList directly. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * | | * | |
|
| * @constreturn A GList of PurpleNotifyUserInfoEntry objects | | * @constreturn A GList of PurpleNotifyUserInfoEntry objects | |
| */ | | */ | |
| GList *purple_notify_user_info_get_entries(PurpleNotifyUserInfo *user_info)
; | | GList *purple_notify_user_info_get_entries(PurpleNotifyUserInfo *user_info)
; | |
| | | | |
| /** | | /** | |
|
| * Create a textual representation of a PurpleNotifyUserInfo, separating en | | * Create a textual representation of a PurpleNotifyUserInfo, separating | |
| tries with newline | | * entries with newline | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param newline The separation character | | * @param newline The separation character | |
| */ | | */ | |
| char *purple_notify_user_info_get_text_with_newline(PurpleNotifyUserInfo *u
ser_info, const char *newline); | | char *purple_notify_user_info_get_text_with_newline(PurpleNotifyUserInfo *u
ser_info, const char *newline); | |
| | | | |
| /** | | /** | |
| * Add a label/value pair to a PurpleNotifyUserInfo object. | | * Add a label/value pair to a PurpleNotifyUserInfo object. | |
| * PurpleNotifyUserInfo keeps track of the order in which pairs are added. | | * PurpleNotifyUserInfo keeps track of the order in which pairs are added. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param label A label, which for example might be displayed | | * @param label A label, which for example might be displayed by a | |
| by a UI with a colon after it ("Status:"). Do not include a colon. | | * UI with a colon after it ("Status:"). Do not include | |
| * If NULL, value will be displayed without a lab | | * a colon. If NULL, value will be displayed without a | |
| el. | | * label. | |
| * @param value The value, which might be displayed by a UI af | | * @param value The value, which might be displayed by a UI after | |
| ter the label. | | * the label. If NULL, label will still be displayed; | |
| * If NULL, label will still be displayed; the UI | | * the UI should then treat label as independent and not | |
| should then treat label as independent | | * include a colon if it would otherwise. | |
| * and not include a colon if it would otherwise. | | | |
| */ | | */ | |
| void purple_notify_user_info_add_pair(PurpleNotifyUserInfo *user_info, cons
t char *label, const char *value); | | void purple_notify_user_info_add_pair(PurpleNotifyUserInfo *user_info, cons
t char *label, const char *value); | |
| | | | |
| /** | | /** | |
| * Prepend a label/value pair to a PurpleNotifyUserInfo object | | * Prepend a label/value pair to a PurpleNotifyUserInfo object | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param label A label, which for example might be displayed | | * @param label A label, which for example might be displayed by a | |
| by a UI with a colon after it ("Status:"). Do not include a colon. | | * UI with a colon after it ("Status:"). Do not include | |
| * If NULL, value will be displayed without a lab | | * a colon. If NULL, value will be displayed without a | |
| el. | | * label. | |
| * @param value The value, which might be displayed by a UI af | | * @param value The value, which might be displayed by a UI after | |
| ter the label. | | * the label. If NULL, label will still be displayed; | |
| * If NULL, label will still be displayed; the UI | | * the UI should then treat label as independent and not | |
| should then treat label as independent | | * include a colon if it would otherwise. | |
| * and not include a colon if it would otherwise. | | | |
| */ | | */ | |
| void purple_notify_user_info_prepend_pair(PurpleNotifyUserInfo *user_info,
const char *label, const char *value); | | void purple_notify_user_info_prepend_pair(PurpleNotifyUserInfo *user_info,
const char *label, const char *value); | |
| | | | |
| /** | | /** | |
|
| * Remove a PurpleNotifyUserInfoEntry from a PurpleNotifyUserInfo object wi | | * Remove a PurpleNotifyUserInfoEntry from a PurpleNotifyUserInfo object | |
| thout freeing the entry. | | * without freeing the entry. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| */ | | */ | |
| void purple_notify_user_info_remove_entry(PurpleNotifyUserInfo *user_info,
PurpleNotifyUserInfoEntry *user_info_entry); | | void purple_notify_user_info_remove_entry(PurpleNotifyUserInfo *user_info,
PurpleNotifyUserInfoEntry *user_info_entry); | |
|
| | | | |
| /** | | /** | |
| * Create a new PurpleNotifyUserInfoEntry | | * Create a new PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * If added to a PurpleNotifyUserInfo object, this should not be free()'d, | | * If added to a PurpleNotifyUserInfo object, this should not be free()'d, | |
| as PurpleNotifyUserInfo will do so | | * as PurpleNotifyUserInfo will do so when destroyed. | |
| * when destroyed. purple_notify_user_info_add_pair() and purple_notify_us | | * purple_notify_user_info_add_pair() and | |
| er_info_prepend_pair() are convenience | | * purple_notify_user_info_prepend_pair() are convenience methods for | |
| * methods for creating entries and adding them to a PurpleNotifyUserInfo. | | * creating entries and adding them to a PurpleNotifyUserInfo. | |
| * | | * | |
|
| * @param label A label, which for example might be displayed | | * @param label A label, which for example might be displayed by a UI | |
| by a UI with a colon after it ("Status:"). Do not include a colon. | | * with a colon after it ("Status:"). Do not include a | |
| * If NULL, value will be displayed without a lab | | * colon. If NULL, value will be displayed without a label. | |
| el. | | * @param value The value, which might be displayed by a UI after the | |
| * @param value The value, which might be displayed by a UI af | | * label. If NULL, label will still be displayed; the UI | |
| ter the label. | | * should then treat label as independent and not include a | |
| * If NULL, label will still be displayed; the UI | | * colon if it would otherwise. | |
| should then treat label as independent | | | |
| * and not include a colon if it would otherwise. | | | |
| * | | * | |
| * @result A new PurpleNotifyUserInfoEntry | | * @result A new PurpleNotifyUserInfoEntry | |
| */ | | */ | |
| PurpleNotifyUserInfoEntry *purple_notify_user_info_entry_new(const char *la
bel, const char *value); | | PurpleNotifyUserInfoEntry *purple_notify_user_info_entry_new(const char *la
bel, const char *value); | |
| | | | |
| /** | | /** | |
| * Add a section break. A UI might display this as a horizontal line. | | * Add a section break. A UI might display this as a horizontal line. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| */ | | */ | |
| void purple_notify_user_info_add_section_break(PurpleNotifyUserInfo *user_i
nfo); | | void purple_notify_user_info_add_section_break(PurpleNotifyUserInfo *user_i
nfo); | |
| | | | |
| /** | | /** | |
| * Prepend a section break. A UI might display this as a horizontal line. | | * Prepend a section break. A UI might display this as a horizontal line. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @since 2.5.0 | | * @since 2.5.0 | |
| */ | | */ | |
| void purple_notify_user_info_prepend_section_break(PurpleNotifyUserInfo *us
er_info); | | void purple_notify_user_info_prepend_section_break(PurpleNotifyUserInfo *us
er_info); | |
| | | | |
| /** | | /** | |
|
| * Add a section header. A UI might display this in a different font from | | * Add a section header. A UI might display this in a different font | |
| other text. | | * from other text. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param label The name of the section | | * @param label The name of the section | |
| */ | | */ | |
| void purple_notify_user_info_add_section_header(PurpleNotifyUserInfo *user_
info, const char *label); | | void purple_notify_user_info_add_section_header(PurpleNotifyUserInfo *user_
info, const char *label); | |
| | | | |
| /** | | /** | |
|
| * Prepend a section header. A UI might display this in a different font f | | * Prepend a section header. A UI might display this in a different font | |
| rom other text. | | * from other text. | |
| * | | * | |
|
| * @param user_info The PurpleNotifyUserInfo | | * @param user_info The PurpleNotifyUserInfo | |
| * @param label The name of the section | | * @param label The name of the section | |
| * @since 2.5.0 | | * @since 2.5.0 | |
| */ | | */ | |
| void purple_notify_user_info_prepend_section_header(PurpleNotifyUserInfo *u
ser_info, const char *label); | | void purple_notify_user_info_prepend_section_header(PurpleNotifyUserInfo *u
ser_info, const char *label); | |
| | | | |
| /** | | /** | |
|
| * Remove the last item which was added to a PurpleNotifyUserInfo. This cou | | * Remove the last item which was added to a PurpleNotifyUserInfo. This | |
| ld be used to remove a section header which is not needed. | | * could be used to remove a section header which is not needed. | |
| */ | | */ | |
| void purple_notify_user_info_remove_last_item(PurpleNotifyUserInfo *user_in
fo); | | void purple_notify_user_info_remove_last_item(PurpleNotifyUserInfo *user_in
fo); | |
| | | | |
| /** | | /** | |
| * Get the label for a PurpleNotifyUserInfoEntry | | * Get the label for a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @result The label | | * @return The label | |
| */ | | */ | |
| const gchar *purple_notify_user_info_entry_get_label(PurpleNotifyUserInfoEn
try *user_info_entry); | | const gchar *purple_notify_user_info_entry_get_label(PurpleNotifyUserInfoEn
try *user_info_entry); | |
| | | | |
| /** | | /** | |
| * Set the label for a PurpleNotifyUserInfoEntry | | * Set the label for a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * @param label The label | | * @param label The label | |
| */ | | */ | |
| void purple_notify_user_info_entry_set_label(PurpleNotifyUserInfoEntry *use
r_info_entry, const char *label); | | void purple_notify_user_info_entry_set_label(PurpleNotifyUserInfoEntry *use
r_info_entry, const char *label); | |
| | | | |
| /** | | /** | |
| * Get the value for a PurpleNotifyUserInfoEntry | | * Get the value for a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @result The value | | * @result The value | |
| */ | | */ | |
| const gchar *purple_notify_user_info_entry_get_value(PurpleNotifyUserInfoEn
try *user_info_entry); | | const gchar *purple_notify_user_info_entry_get_value(PurpleNotifyUserInfoEn
try *user_info_entry); | |
| | | | |
| /** | | /** | |
| * Set the value for a PurpleNotifyUserInfoEntry | | * Set the value for a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * @param value The value | | * @param value The value | |
| */ | | */ | |
| void purple_notify_user_info_entry_set_value(PurpleNotifyUserInfoEntry *use
r_info_entry, const char *value); | | void purple_notify_user_info_entry_set_value(PurpleNotifyUserInfoEntry *use
r_info_entry, const char *value); | |
| | | | |
| /** | | /** | |
| * Get the type of a PurpleNotifyUserInfoEntry | | * Get the type of a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @result The PurpleNotifyUserInfoEn
tryType | | * @return The PurpleNotifyUserInfoEntryType | |
| */ | | */ | |
| PurpleNotifyUserInfoEntryType purple_notify_user_info_entry_get_type(Purple
NotifyUserInfoEntry *user_info_entry); | | PurpleNotifyUserInfoEntryType purple_notify_user_info_entry_get_type(Purple
NotifyUserInfoEntry *user_info_entry); | |
| | | | |
| /** | | /** | |
| * Set the type of a PurpleNotifyUserInfoEntry | | * Set the type of a PurpleNotifyUserInfoEntry | |
| * | | * | |
|
| * @param user_info_entry The PurpleNotifyUserInfoEntry | | * @param user_info_entry The PurpleNotifyUserInfoEntry | |
| * @param type The PurpleNotifyUserInfoEntryType | | * @param type The PurpleNotifyUserInfoEntryType | |
| */ | | */ | |
| void purple_notify_user_info_entry_set_type(PurpleNotifyUserInfoEntry *user
_info_entry, | | void purple_notify_user_info_entry_set_type(PurpleNotifyUserInfoEntry *user
_info_entry, | |
|
PurpleNotifyUserInfoEntryType type); | |
PurpleNotifyUserInfoEntryType type); | |
| | | | |
| /** | | /** | |
| * Opens a URI or somehow presents it to the user. | | * Opens a URI or somehow presents it to the user. | |
| * | | * | |
| * @param handle The plugin or connection handle. | | * @param handle The plugin or connection handle. | |
| * @param uri The URI to display or go to. | | * @param uri The URI to display or go to. | |
| * | | * | |
| | | | |
End of changes. 41 change blocks. |
| 100 lines changed or deleted | | 97 lines changed or added | |
|
| plugin.h | | plugin.h | |
| | | | |
| skipping to change at line 533 | | skipping to change at line 533 | |
| */ | | */ | |
| void purple_plugins_probe(const char *ext); | | void purple_plugins_probe(const char *ext); | |
| | | | |
| /** | | /** | |
| * Returns whether or not plugin support is enabled. | | * Returns whether or not plugin support is enabled. | |
| * | | * | |
| * @return TRUE if plugin support is enabled, or FALSE otherwise. | | * @return TRUE if plugin support is enabled, or FALSE otherwise. | |
| */ | | */ | |
| gboolean purple_plugins_enabled(void); | | gboolean purple_plugins_enabled(void); | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Registers a function that will be called when probing is finished. | | * Registers a function that will be called when probing is finished. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @param data Data to pass to the callback. | | * @param data Data to pass to the callback. | |
| * @deprecated If you need this, ask for a plugin-probe signal to be added. | | * @deprecated If you need this, ask for a plugin-probe signal to be added. | |
| */ | | */ | |
| void purple_plugins_register_probe_notify_cb(void (*func)(void *), void *da
ta); | | void purple_plugins_register_probe_notify_cb(void (*func)(void *), void *da
ta); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Unregisters a function that would be called when probing is finished. | | * Unregisters a function that would be called when probing is finished. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @deprecated If you need this, ask for a plugin-probe signal to be added. | | * @deprecated If you need this, ask for a plugin-probe signal to be added. | |
| */ | | */ | |
| void purple_plugins_unregister_probe_notify_cb(void (*func)(void *)); | | void purple_plugins_unregister_probe_notify_cb(void (*func)(void *)); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Registers a function that will be called when a plugin is loaded. | | * Registers a function that will be called when a plugin is loaded. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @param data Data to pass to the callback. | | * @param data Data to pass to the callback. | |
| * @deprecated Use the plugin-load signal instead. | | * @deprecated Use the plugin-load signal instead. | |
| */ | | */ | |
| void purple_plugins_register_load_notify_cb(void (*func)(PurplePlugin *, vo
id *), | | void purple_plugins_register_load_notify_cb(void (*func)(PurplePlugin *, vo
id *), | |
|
void *data); | |
void *data); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Unregisters a function that would be called when a plugin is loaded. | | * Unregisters a function that would be called when a plugin is loaded. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @deprecated Use the plugin-load signal instead. | | * @deprecated Use the plugin-load signal instead. | |
| */ | | */ | |
| void purple_plugins_unregister_load_notify_cb(void (*func)(PurplePlugin *,
void *)); | | void purple_plugins_unregister_load_notify_cb(void (*func)(PurplePlugin *,
void *)); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Registers a function that will be called when a plugin is unloaded. | | * Registers a function that will be called when a plugin is unloaded. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @param data Data to pass to the callback. | | * @param data Data to pass to the callback. | |
| * @deprecated Use the plugin-unload signal instead. | | * @deprecated Use the plugin-unload signal instead. | |
| */ | | */ | |
| void purple_plugins_register_unload_notify_cb(void (*func)(PurplePlugin *,
void *), | | void purple_plugins_register_unload_notify_cb(void (*func)(PurplePlugin *,
void *), | |
|
void *data); | |
void *data); | |
| #endif | | #endif | |
| | | | |
|
| #ifndef PURPLE_DISABLE_DEPRECATED | | #if !(defined PURPLE_DISABLE_DEPRECATED) || (defined _PURPLE_PLUGIN_C_) | |
| /** | | /** | |
| * Unregisters a function that would be called when a plugin is unloaded. | | * Unregisters a function that would be called when a plugin is unloaded. | |
| * | | * | |
| * @param func The callback function. | | * @param func The callback function. | |
| * @deprecated Use the plugin-unload signal instead. | | * @deprecated Use the plugin-unload signal instead. | |
| */ | | */ | |
| void purple_plugins_unregister_unload_notify_cb(void (*func)(PurplePlugin *
, | | void purple_plugins_unregister_unload_notify_cb(void (*func)(PurplePlugin *
, | |
|
void *)); | |
void *)); | |
| #endif | | #endif | |
| | | | |
| | | | |
End of changes. 6 change blocks. |
| 6 lines changed or deleted | | 6 lines changed or added | |
|
| prpl.h | | prpl.h | |
| | | | |
| skipping to change at line 190 | | skipping to change at line 190 | |
| * | | * | |
| * Gadu-Gadu doesn't need a screenname to register new account. | | * Gadu-Gadu doesn't need a screenname to register new account. | |
| */ | | */ | |
| OPT_PROTO_REGISTER_NOSCREENNAME = 0x00000200, | | OPT_PROTO_REGISTER_NOSCREENNAME = 0x00000200, | |
| | | | |
| /** | | /** | |
| * Indicates that slash commands are native to this protocol. | | * Indicates that slash commands are native to this protocol. | |
| * Used as a hint that unknown commands should not be sent as messag
es. | | * Used as a hint that unknown commands should not be sent as messag
es. | |
| * @since 2.1.0 | | * @since 2.1.0 | |
| */ | | */ | |
|
| OPT_PROTO_SLASH_COMMANDS_NATIVE = 0x00000400, | | OPT_PROTO_SLASH_COMMANDS_NATIVE = 0x00000400 | |
| | | | |
| } PurpleProtocolOptions; | | } PurpleProtocolOptions; | |
| | | | |
| /** | | /** | |
| * A protocol plugin information structure. | | * A protocol plugin information structure. | |
| * | | * | |
| * Every protocol plugin initializes this structure. It is the gateway | | * Every protocol plugin initializes this structure. It is the gateway | |
| * between purple and the protocol plugin. Many of these callbacks can be | | * between purple and the protocol plugin. Many of these callbacks can be | |
| * NULL. If a callback must be implemented, it has a comment indicating so
. | | * NULL. If a callback must be implemented, it has a comment indicating so
. | |
| */ | | */ | |
| | | | |
| skipping to change at line 275 | | skipping to change at line 275 | |
| * PRPL is unable to send the message for another reason, return | | * PRPL is unable to send the message for another reason, return | |
| * some other negative value. You can use one of the valid | | * some other negative value. You can use one of the valid | |
| * errno values, or just big something. If the message should | | * errno values, or just big something. If the message should | |
| * not be echoed to the conversation window, return 0. | | * not be echoed to the conversation window, return 0. | |
| */ | | */ | |
| int (*send_im)(PurpleConnection *, const char *who, | | int (*send_im)(PurpleConnection *, const char *who, | |
| const char *message, | | const char *message, | |
| PurpleMessageFlags flags); | | PurpleMessageFlags flags); | |
| | | | |
| void (*set_info)(PurpleConnection *, const char *info); | | void (*set_info)(PurpleConnection *, const char *info); | |
|
| | | | |
| | | /** | |
| | | * @return If this protocol requires the PURPLE_TYPING message to | |
| | | * be sent repeatedly to signify that the user is still | |
| | | * typing, then the PRPL should return the number of | |
| | | * seconds to wait before sending a subsequent notification. | |
| | | * Otherwise the PRPL should return 0. | |
| | | */ | |
| unsigned int (*send_typing)(PurpleConnection *, const char *name, Pu
rpleTypingState state); | | unsigned int (*send_typing)(PurpleConnection *, const char *name, Pu
rpleTypingState state); | |
|
| | | | |
| /** | | /** | |
| * Should arrange for purple_notify_userinfo() to be called with | | * Should arrange for purple_notify_userinfo() to be called with | |
| * @a who's user info. | | * @a who's user info. | |
| */ | | */ | |
| void (*get_info)(PurpleConnection *, const char *who); | | void (*get_info)(PurpleConnection *, const char *who); | |
| void (*set_status)(PurpleAccount *account, PurpleStatus *status); | | void (*set_status)(PurpleAccount *account, PurpleStatus *status); | |
| | | | |
| void (*set_idle)(PurpleConnection *, int idletime); | | void (*set_idle)(PurpleConnection *, int idletime); | |
| void (*change_passwd)(PurpleConnection *, const char *old_pass, | | void (*change_passwd)(PurpleConnection *, const char *old_pass, | |
| const char *new_pass); | | const char *new_pass); | |
| | | | |
| skipping to change at line 628 | | skipping to change at line 637 | |
| /** | | /** | |
| * Notifies Purple that a user's idle state and time have changed. | | * Notifies Purple that a user's idle state and time have changed. | |
| * | | * | |
| * This is meant to be called from protocol plugins. | | * This is meant to be called from protocol plugins. | |
| * | | * | |
| * @param account The account the user is on. | | * @param account The account the user is on. | |
| * @param name The screen name of the user. | | * @param name The screen name of the user. | |
| * @param idle The user's idle state. | | * @param idle The user's idle state. | |
| * @param idle_time The user's idle time. This is the time at | | * @param idle_time The user's idle time. This is the time at | |
| * which the user became idle, in seconds since | | * which the user became idle, in seconds since | |
|
| * the epoch. | | * the epoch. If the PRPL does not know this value | |
| | | * then it should pass 0. | |
| */ | | */ | |
| void purple_prpl_got_user_idle(PurpleAccount *account, const char *name, | | void purple_prpl_got_user_idle(PurpleAccount *account, const char *name, | |
| gboolean idle, time
_t idle_time); | | gboolean idle, time
_t idle_time); | |
| | | | |
| /** | | /** | |
| * Notifies Purple of a user's log-in time. | | * Notifies Purple of a user's log-in time. | |
| * | | * | |
| * This is meant to be called from protocol plugins. | | * This is meant to be called from protocol plugins. | |
| * | | * | |
| * @param account The account the user is on. | | * @param account The account the user is on. | |
| | | | |
End of changes. 4 change blocks. |
| 2 lines changed or deleted | | 12 lines changed or added | |
|