--- a/libpurple/purplenotification.h Tue Oct 01 01:18:36 2024 -0500 +++ b/libpurple/purplenotification.h Tue Oct 01 01:20:45 2024 -0500 @@ -38,43 +38,6 @@ G_BEGIN_DECLS /** - * PurpleNotificationType: - * @PURPLE_NOTIFICATION_TYPE_UNKNOWN: This type is unknown. - * @PURPLE_NOTIFICATION_TYPE_GENERIC: A generic notification that is just text - * that may have links. - * @PURPLE_NOTIFICATION_TYPE_CONNECTION_ERROR: A notification that is for a - * connection error. - * @PURPLE_NOTIFICATION_TYPE_AUTHORIZATION_REQUEST: A notification for a - * contact authorization - * request. - * @PURPLE_NOTIFICATION_TYPE_ADD_CONTACT: A notification for when a contact add - * you to their contact list. - * @PURPLE_NOTIFICATION_TYPE_FILE_TRANSFER: A notification for a file transfer. - * @PURPLE_NOTIFICATION_TYPE_CHAT_INVITE: A notification when the user has been - * invited to a chat. - * @PURPLE_NOTIFICATION_TYPE_MENTION: A notification that the user has been - * mentioned. - * @PURPLE_NOTIFICATION_TYPE_REACTION: A notification when a reaction has been - * added to message. - * - * The different types of notifications. - * - * Since: 3.0 - */ -PURPLE_AVAILABLE_TYPE_IN_3_0 -typedef enum { - PURPLE_NOTIFICATION_TYPE_UNKNOWN, - PURPLE_NOTIFICATION_TYPE_GENERIC, - PURPLE_NOTIFICATION_TYPE_CONNECTION_ERROR, - PURPLE_NOTIFICATION_TYPE_AUTHORIZATION_REQUEST, - PURPLE_NOTIFICATION_TYPE_ADD_CONTACT, - PURPLE_NOTIFICATION_TYPE_FILE_TRANSFER, - PURPLE_NOTIFICATION_TYPE_CHAT_INVITE, - PURPLE_NOTIFICATION_TYPE_MENTION, - PURPLE_NOTIFICATION_TYPE_REACTION, -} PurpleNotificationType; - -/** * PurpleNotification: * * An object that represents a notification. @@ -97,26 +60,6 @@ }; /** - * purple_notification_new: - * @type: The [enum@NotificationType] of the notification. - * @account: (nullable): The [class@Account] that created the notification if - * applicable. - * @data: The data for the notification. - * @data_destroy_func: A GDestroyNotify to call to free @data. - * - * Creates a new notification with the given properties. @account is optional. - * - * Once the notification is prepared, it should be added to a - * [class@NotificationManager] to be presented to the user. - * - * Returns: (transfer full): The new notification. - * - * Since: 3.0 - */ -PURPLE_DEPRECATED_FOR(purple_notification_new_generic) -PurpleNotification *purple_notification_new(PurpleNotificationType type, PurpleAccount *account, gpointer data, GDestroyNotify data_destroy_func); - -/** * purple_notification_new_generic: * @id: (nullable): An id for the notification. * @title: (nullable): The title for the notification. @@ -136,55 +79,6 @@ PurpleNotification *purple_notification_new_generic(const char *id, const char *title); /** - * purple_notification_new_from_add_contact_request: - * @request: (transfer full): The [class@AddContactRequest] instance. - * - * Creates a new [class@Notification] for @request. This helper will - * automatically fill out the notification according to the information in - * @request. - * - * Returns: (transfer full): The new notification. - * - * Since: 3.0 - * - * Deprecated: 3.0 - */ -PURPLE_DEPRECATED_FOR(purple_notification_add_contact_new) -PurpleNotification *purple_notification_new_from_add_contact_request(PurpleAddContactRequest *request); - -/** - * purple_notification_new_from_authorization_request: - * @authorization_request: (transfer full): The [class@AuthorizationRequest] - * instance. - * - * Creates a new [class@Notification] for the @authorization_request. This - * helper will automatically fill out the notification according to the - * information in @authorization_request. - * - * Returns: (transfer full): The new notification. - * - * Since: 3.0 - */ -PURPLE_DEPRECATED_FOR(purple_notification_authorization_request_new) -PurpleNotification *purple_notification_new_from_authorization_request(PurpleAuthorizationRequest *authorization_request); - -/** - * purple_notification_new_from_connection_error: - * @account: The [class@Purple.Account] that had the connection error. - * @info: (transfer none): The [struct@Purple.ConnectionErrorInfo] for the error. - * - * Creates a new [class@Purple.Notification] for @account with the @info for - * the connection. This helper will automatically fill out the notification - * according to the given parameters. - * - * Returns: (transfer full): The new notification. - * - * Since: 3.0 - */ -PURPLE_DEPRECATED_FOR(purple_notification_connection_error_new) -PurpleNotification *purple_notification_new_from_connection_error(PurpleAccount *account, PurpleConnectionErrorInfo *info); - -/** * purple_notification_get_id: * @notification: The instance. * @@ -198,19 +92,6 @@ const char *purple_notification_get_id(PurpleNotification *notification); /** - * purple_notification_get_notification_type: - * @notification: The instance. - * - * Gets the [enum@NotificationType] of @notification. - * - * Returns: The type of @notification. - * - * Since: 3.0 - */ -PURPLE_DEPRECATED -PurpleNotificationType purple_notification_get_notification_type(PurpleNotification *notification); - -/** * purple_notification_get_account: * @notification: The instance. * @@ -428,19 +309,6 @@ void purple_notification_set_persistent(PurpleNotification *notification, gboolean persistent); /** - * purple_notification_get_data: - * @notification: The instance. - * - * Gets the data that @notification was created with. - * - * Returns: (transfer none): The data for @notification. - * - * Since: 3.0 - */ -PURPLE_DEPRECATED -gpointer purple_notification_get_data(PurpleNotification *notification); - -/** * purple_notification_compare: * @a: The first notification to compare. * @b: The second notification to compare.