From 8d1ad63f3a694b07ee1f4843eaeb7a00f5c53dfb Mon Sep 17 00:00:00 2001 From: Niels De Graef Date: Sun, 3 May 2020 17:40:14 +0200 Subject: [PATCH] Use %NULL instead of NULL in gtk-doc comments This allows comments in bindings to other languages to use their equivalent of `NULL`, e.g. `None` in python or `null` in Vala. --- app/core/gimptag.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/app/core/gimptag.c b/app/core/gimptag.c index 0b1012a3c0..ccc78f988c 100644 --- a/app/core/gimptag.c +++ b/app/core/gimptag.c @@ -56,7 +56,7 @@ gimp_tag_init (GimpTag *tag) * If given tag name is not valid, an attempt will be made to fix it. * * Returns: (nullable) (transfer full): a new #GimpTag object, - * or NULL if tag string is invalid and cannot be fixed. + * or %NULL if tag string is invalid and cannot be fixed. **/ GimpTag * gimp_tag_new (const char *tag_string) @@ -90,13 +90,13 @@ gimp_tag_new (const char *tag_string) * gimp_tag_try_new: * @tag_string: a tag name. * - * Similar to gimp_tag_new(), but returns NULL if tag is surely not equal + * Similar to gimp_tag_new(), but returns %NULL if tag is surely not equal * to any of currently created tags. It is useful for tag querying to avoid * unneeded comparisons. If tag is created, however, it does not mean that * it would necessarily match with some other tag. * * Returns: (nullable) (transfer full): new #GimpTag object, - * or NULL if tag will not match with any other #GimpTag. + * or %NULL if tag will not match with any other #GimpTag. **/ GimpTag * gimp_tag_try_new (const char *tag_string) @@ -318,9 +318,9 @@ gimp_tag_has_prefix (GimpTag *tag, * * Tries to create a valid tag string from given @tag_string. * - * Returns: a newly allocated tag string in case given @tag_string was - * valid or could be fixed, otherwise NULL. Allocated value should be freed - * using g_free(). + * Returns: (transfer full) (nullable): a newly allocated tag string in case + * given @tag_string was valid or could be fixed, otherwise %NULL. Allocated + * value should be freed using g_free(). **/ gchar * gimp_tag_string_make_valid (const gchar *tag_string)