[gimp] Use %NULL instead of NULL in gtk-doc comments
- From: Niels De Graef <nielsdg src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp] Use %NULL instead of NULL in gtk-doc comments
- Date: Sun, 3 May 2020 15:41:28 +0000 (UTC)
commit 8d1ad63f3a694b07ee1f4843eaeb7a00f5c53dfb
Author: Niels De Graef <nielsdegraef gmail com>
Date: Sun May 3 17:40:14 2020 +0200
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)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]