comparison libpurple/request.h @ 32226:02a2e8183b1d

Clean the API documentation in preparation for 3.0.0 by removing all the old @since tags.

32224:9d5b87e1a4d0

 * Returns the group for the field.
 *
 * @param field The field.
 *
 * @return The UI data.
 *
 * @since 2.6.0
 */
PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);

/**
 * Returns the ID of a field.

 * Returns the ui_data for a field.
 *
 * @param field The field.
 *
 * @return The UI data.
 *
 * @since 2.6.0
 */
gpointer purple_request_field_get_ui_data(const PurpleRequestField *field);

/**
 * Sets the ui_data for a field.
 *
 * @param field The field.
 * @param ui_data The UI data.
 *
 * @return The UI data.
 *
 * @since 2.6.0
 */
void purple_request_field_set_ui_data(PurpleRequestField *field,
                                      gpointer ui_data);

/*@}*/

	PurpleAccount *account, const char *who, PurpleConversation *conv,
	void *user_data, size_t action_count, va_list actions);

/**
 * Version of purple_request_action() supplying an image for the UI to
 * optionally display as an icon in the dialog; see its documentation
 * @since 2.7.0
 */
void *purple_request_action_with_icon(void *handle, const char *title,
	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	gconstpointer icon_data, gsize icon_size, void *user_data,
	size_t action_count, ...);

/**
 * <tt>va_list</tt> version of purple_request_action_with_icon();
 * see its documentation.
 * @since 2.7.0
 */
void *purple_request_action_with_icon_varg(void *handle, const char *title,
	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	gconstpointer icon_data, gsize icon_size,

32226:02a2e8183b1d

 * Returns the group for the field.
 *
 * @param field The field.
 *
 * @return The UI data.
 */
PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);

/**
 * Returns the ID of a field.

 * Returns the ui_data for a field.
 *
 * @param field The field.
 *
 * @return The UI data.
 */
gpointer purple_request_field_get_ui_data(const PurpleRequestField *field);

/**
 * Sets the ui_data for a field.
 *
 * @param field The field.
 * @param ui_data The UI data.
 *
 * @return The UI data.
 */
void purple_request_field_set_ui_data(PurpleRequestField *field,
                                      gpointer ui_data);

/*@}*/

	PurpleAccount *account, const char *who, PurpleConversation *conv,
	void *user_data, size_t action_count, va_list actions);

/**
 * Version of purple_request_action() supplying an image for the UI to
 * optionally display as an icon in the dialog; see its documentation.
 */
void *purple_request_action_with_icon(void *handle, const char *title,
	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	gconstpointer icon_data, gsize icon_size, void *user_data,
	size_t action_count, ...);

/**
 * <tt>va_list</tt> version of purple_request_action_with_icon();
 * see its documentation.
 */
void *purple_request_action_with_icon_varg(void *handle, const char *title,
	const char *primary, const char *secondary, int default_action,
	PurpleAccount *account, const char *who, PurpleConversation *conv,
	gconstpointer icon_data, gsize icon_size,