Revert "Rename all user datas in callbacks to user_data"

This reverts commit 1422e5f812. The renaming of parameters implicitly introduced "closure" annotations in the documentation which are wrong on callbacks.
This commit is contained in:
badcel 2023-01-09 13:11:21 +01:00
parent 19a02d7d14
commit b24f6ca27d
No known key found for this signature in database
GPG Key ID: 70A8373EEB2233E0
3 changed files with 13 additions and 13 deletions

View File

@ -138,8 +138,8 @@ typedef enum
* single dash followed by a single letter (for a short name) or two dashes
* followed by a long option name.
* @value: The value to be parsed.
* @user_data: User data added to the #GOptionGroup containing the option when
* it was created with g_option_group_new()
* @data: User data added to the #GOptionGroup containing the option when it
* was created with g_option_group_new()
* @error: A return location for errors. The error code %G_OPTION_ERROR_FAILED
* is intended to be used for errors in #GOptionArgFunc callbacks.
*
@ -151,15 +151,15 @@ typedef enum
*/
typedef gboolean (*GOptionArgFunc) (const gchar *option_name,
const gchar *value,
gpointer user_data,
gpointer data,
GError **error);
/**
* GOptionParseFunc:
* @context: The active #GOptionContext
* @group: The group to which the function belongs
* @user_data: User data added to the #GOptionGroup containing the option when
* it was created with g_option_group_new()
* @data: User data added to the #GOptionGroup containing the option when it
* was created with g_option_group_new()
* @error: A return location for error details
*
* The type of function that can be called before and after parsing.
@ -169,22 +169,22 @@ typedef gboolean (*GOptionArgFunc) (const gchar *option_name,
*/
typedef gboolean (*GOptionParseFunc) (GOptionContext *context,
GOptionGroup *group,
gpointer user_data,
gpointer data,
GError **error);
/**
* GOptionErrorFunc:
* @context: The active #GOptionContext
* @group: The group to which the function belongs
* @user_data: User data added to the #GOptionGroup containing the option when
* it was created with g_option_group_new()
* @data: User data added to the #GOptionGroup containing the option when it
* was created with g_option_group_new()
* @error: The #GError containing details about the parse error
*
* The type of function to be used as callback when a parse error occurs.
*/
typedef void (*GOptionErrorFunc) (GOptionContext *context,
GOptionGroup *group,
gpointer user_data,
gpointer data,
GError **error);
/**

View File

@ -55,7 +55,7 @@ typedef gboolean (*GTraverseFunc) (gpointer key,
/**
* GTraverseNodeFunc:
* @node: a #GTreeNode
* @user_data: user data passed to g_tree_foreach_node()
* @data: user data passed to g_tree_foreach_node()
*
* Specifies the type of function passed to g_tree_foreach_node(). It is
* passed each node, together with the @user_data parameter passed to
@ -66,7 +66,7 @@ typedef gboolean (*GTraverseFunc) (gpointer key,
* Since: 2.68
*/
typedef gboolean (*GTraverseNodeFunc) (GTreeNode *node,
gpointer user_data);
gpointer data);
/* Balanced binary trees
*/

View File

@ -172,7 +172,7 @@ typedef void (*GFreeFunc) (gpointer data);
/**
* GTranslateFunc:
* @str: the untranslated string
* @user_data: user data specified when installing the function, e.g.
* @data: user data specified when installing the function, e.g.
* in g_option_group_set_translate_func()
*
* The type of functions which are used to translate user-visible
@ -182,7 +182,7 @@ typedef void (*GFreeFunc) (gpointer data);
* The returned string is owned by GLib and must not be freed.
*/
typedef const gchar * (*GTranslateFunc) (const gchar *str,
gpointer user_data);
gpointer data);
/* Define some mathematical constants that aren't available