[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]