pidgin3: comparison libpurple/account.h

-:89ded010f76c
+:4cbae4a1bac1
 void purple_account_set_privacy_type(PurpleAccount *account, PurpleAccountPrivacyType privacy_type);
 /**
 * purple_account_set_status_types:
 * @account:      The account.
-* @status_types: The list of status types.
+* @status_types: (element-type PurpleStatusType): The list of status types.
 *
 * Sets the account's status types.
 */
 void purple_account_set_status_types(PurpleAccount *account, GList *status_types);
 * purple_account_set_status_list:
 * @account:   The account.
 * @status_id: The ID of the status.
 * @active:    Whether @a status_id is to be activated (%TRUE) or
 *             deactivated (%FALSE).
-* @attrs:     A list of <type>const char *</type> attribute names followed by
+* @attrs:     (element-type PurpleStatusAttribute): A list of <type>const char *</type> attribute names followed by
 *             <type>const char *</type> attribute values for the status.
 *             (For example, one pair might be <literal>"message"</literal>
 *             followed by <literal>"hello, talk to me!"</literal>.)
 *
 * Activates or deactivates a status.  All changes to the statuses of
 * purple_account_privacy_get_permitted:
 * @account:	The account.
 *
 * Returns the account's permit list.
 *
-* Returns: (transfer none):     A list of the permitted users
+* Returns: (transfer none) (element-type utf8): A list of the permitted users
 */
 GSList *purple_account_privacy_get_permitted(PurpleAccount *account);
 /**
 * purple_account_privacy_get_denied:
 * @account:	The account.
 *
 * Returns the account's deny list.
 *
-* Returns: (transfer none):     A list of the denied users
+* Returns: (transfer none) (element-type utf8): A list of the denied users
 */
 GSList *purple_account_privacy_get_denied(PurpleAccount *account);
 /**
 * purple_account_privacy_check:
 * Returns the active status for this account.  This looks through
 * the PurplePresence associated with this account and returns the
 * PurpleStatus that has its active flag set to "TRUE."  There can be
 * only one active PurpleStatus in a PurplePresence.
 *
-* Returns: The active status.
+* Returns: (transfer none): The active status.
 */
 PurpleStatus *purple_account_get_active_status(const PurpleAccount *account);
 /**
 * purple_account_get_status:
 * @account:   The account.
 * @status_id: The status ID.
 *
 * Returns the account status with the specified ID.
 *
-* Returns: The status, or %NULL if it was never registered.
+* Returns: (transfer none): The status, or %NULL if it was never registered.
 */
 PurpleStatus *purple_account_get_status(const PurpleAccount *account,
 									const char *status_id);
 /**
 * purple_account_get_presence:
 * @account: The account.
 *
 * Returns the account's presence.
 *
-* Returns: The account's presence.
+* Returns: (transfer none): The account's presence.
 */
 PurplePresence *purple_account_get_presence(const PurpleAccount *account);
 /**
 * purple_account_is_status_active:
 * purple_account_get_status_types:
 * @account: The account.
 *
 * Returns the account's status types.
 *
-* Returns: (transfer none): The account's status types.
+* Returns: (transfer none) (element-type PurpleStatusType): The account's status types.
 */
 GList *purple_account_get_status_types(const PurpleAccount *account);
 /**
 * purple_account_get_int:
 void purple_account_add_buddy(PurpleAccount *account, PurpleBuddy *buddy, const char *message);
 /**
 * purple_account_add_buddies:
 * @account: The account.
-* @buddies: The list of PurpleBlistNodes representing the buddies to add.
+* @buddies: (element-type PurpleBuddy) The list of PurpleBlistNodes representing the buddies to add.
 * @message: The invite message.  This may be ignored by a protocol.
 *
 * Adds a list of buddies to the server-side buddy list.
 */
 void purple_account_add_buddies(PurpleAccount *account, GList *buddies, const char *message);
 								PurpleGroup *group);
 /**
 * purple_account_remove_buddies:
 * @account: The account.
-* @buddies: The list of buddies to remove.
+* @buddies: (element-type PurpleBuddy): The list of buddies to remove.
-* @groups: The list of groups to remove buddies from.  Each node of this
+* @groups: (element-type PurpleGroup): The list of groups to remove buddies from.  Each node of this
 *               list should match the corresponding node of buddies.
 *
 * Removes a list of buddies from the server-side buddy list.
 *
 * Note: The lists buddies and groups are parallel lists.  Be sure that node n of

Mercurial > pidgin3 / file comparison

comparison: libpurple/account.h

libpurple/account.h