From e6607e1ad370f87e0788f5d34ea653f3bdbc7708 Mon Sep 17 00:00:00 2001 From: DarkTrick Date: Thu, 8 Jul 2021 08:41:40 +0000 Subject: [PATCH 1/3] Updated GValue Reference: Formatting, mention g_value_unset, link both GValue documents --- gobject/gparamspecs.c | 4 ++++ gobject/gvalue.c | 10 +++++++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/gobject/gparamspecs.c b/gobject/gparamspecs.c index 8ca4b620ff..60edc976ea 100644 --- a/gobject/gparamspecs.c +++ b/gobject/gparamspecs.c @@ -52,6 +52,10 @@ * Parameter names need to start with a letter (a-z or A-Z). Subsequent * characters can be letters, numbers or a '-'. * All other characters are replaced by a '-' during construction. + * + * Information on #GValue is divided. See also #GValue for + * more information. + * */ diff --git a/gobject/gvalue.c b/gobject/gvalue.c index 9c6c90d4d6..3f9d50afb2 100644 --- a/gobject/gvalue.c +++ b/gobject/gvalue.c @@ -44,9 +44,13 @@ * of a type identifier and a specific value of that type. * The type identifier within a #GValue structure always determines the * type of the associated value. + * * To create an undefined #GValue structure, simply create a zero-filled * #GValue structure. To initialize the #GValue, use the g_value_init() - * function. A #GValue cannot be used until it is initialized. + * function. A #GValue cannot be used until it is initialized. Before + * destruction you must always use g_value_unset() to make sure allocated + * memory is freed. + * * The basic type operations (such as freeing and copying) are determined * by the #GTypeValueTable associated with the type ID stored in the #GValue. * Other #GValue operations (such as converting values between types) are @@ -109,6 +113,10 @@ * return 0; * } * ]| + * + * Information on GValue is divided. See also [gobject-Standard-Parameter-and-Value-Types] for + * more information. + * */ -- GitLab From e7acfcf6c942f1d0a57ac637b322a6bf403faaa5 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Fri, 9 Jul 2021 21:02:31 +0000 Subject: [PATCH 2/3] Apply 1 suggestion(s) to 1 file(s) --- gobject/gparamspecs.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/gobject/gparamspecs.c b/gobject/gparamspecs.c index 60edc976ea..d4ad8c21af 100644 --- a/gobject/gparamspecs.c +++ b/gobject/gparamspecs.c @@ -53,8 +53,7 @@ * characters can be letters, numbers or a '-'. * All other characters are replaced by a '-' during construction. * - * Information on #GValue is divided. See also #GValue for - * more information. + * See also #GValue for more information. * */ -- GitLab From 746cdda145d31525a11e18e57d83f0e056c7d9b3 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Fri, 9 Jul 2021 21:02:36 +0000 Subject: [PATCH 3/3] Apply 1 suggestion(s) to 1 file(s) --- gobject/gvalue.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/gobject/gvalue.c b/gobject/gvalue.c index 3f9d50afb2..c7b8d6485c 100644 --- a/gobject/gvalue.c +++ b/gobject/gvalue.c @@ -114,8 +114,8 @@ * } * ]| * - * Information on GValue is divided. See also [gobject-Standard-Parameter-and-Value-Types] for - * more information. + * See also [gobject-Standard-Parameter-and-Value-Types] for more information on + * validation of #GValue. * */ -- GitLab