--- a/libpurple/request/purplerequestfield.h Fri Jul 11 02:46:28 2025 -0500 +++ b/libpurple/request/purplerequestfield.h Sun Jul 13 00:01:48 2025 -0500 @@ -72,6 +72,8 @@ * A callback to check whether a field is valid. * * Returns: %TRUE if the field is valid, otherwise %FALSE. + * + * Since: 3.0 */ typedef gboolean (*PurpleRequestFieldValidator)(PurpleRequestField *field, char **errmsg, gpointer user_data); @@ -89,6 +91,8 @@ * @label: The text label. * * Sets the label text of a field. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL void purple_request_field_set_label(PurpleRequestField *field, const char *label); @@ -99,6 +103,8 @@ * @visible: TRUE if visible, or FALSE if not. * * Sets whether or not a field is visible. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL void purple_request_field_set_visible(PurpleRequestField *field, gboolean visible); @@ -112,6 +118,8 @@ * * This is optionally used by the UIs to provide such features as * auto-completion for type hints like "account" and "screenname". + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL void purple_request_field_set_type_hint(PurpleRequestField *field, @@ -138,6 +146,8 @@ * @required: TRUE if required, or FALSE. * * Sets whether or not a field is required. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL void purple_request_field_set_required(PurpleRequestField *field, gboolean required); @@ -162,6 +172,8 @@ * Returns the ID of a field. * * Returns: The ID + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL const char *purple_request_field_get_id(PurpleRequestField *field); @@ -173,6 +185,8 @@ * Returns the label text of a field. * * Returns: The label text. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL const char *purple_request_field_get_label(PurpleRequestField *field); @@ -184,6 +198,8 @@ * Returns whether or not a field is visible. * * Returns: TRUE if the field is visible. FALSE otherwise. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL gboolean purple_request_field_is_visible(PurpleRequestField *field); @@ -195,6 +211,8 @@ * Returns the field's type hint. * * Returns: The field's type hint. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL const char *purple_request_field_get_type_hint(PurpleRequestField *field); @@ -219,6 +237,8 @@ * Returns whether or not a field is required. * * Returns: TRUE if the field is required, or FALSE. + * + * Since: 2.0 */ PURPLE_AVAILABLE_IN_ALL gboolean purple_request_field_is_required(PurpleRequestField *field);