[evolution-data-server] I#205 - e-source-selectable: Add annotations to developer comments



commit e0ad69b5bd39bb5e3440f2647915f9378fcf3293
Author: Milan Crha <mcrha redhat com>
Date:   Fri Apr 3 08:49:31 2020 +0200

    I#205 - e-source-selectable: Add annotations to developer comments
    
    Closes https://gitlab.gnome.org/GNOME/evolution-data-server/-/issues/205

 src/libedataserver/e-source-selectable.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)
---
diff --git a/src/libedataserver/e-source-selectable.c b/src/libedataserver/e-source-selectable.c
index 76a92961f..ef089c68b 100644
--- a/src/libedataserver/e-source-selectable.c
+++ b/src/libedataserver/e-source-selectable.c
@@ -162,7 +162,8 @@ e_source_selectable_init (ESourceSelectable *extension)
  * belongs.  A colored block is often displayed next to the data source's
  * display name in user interfaces.
  *
- * Returns: the color specification for the #ESource
+ * Returns: (nullable): the color specification for the #ESource,
+ *    or %NULL, when none is set
  *
  * Since: 3.6
  **/
@@ -183,7 +184,8 @@ e_source_selectable_get_color (ESourceSelectable *extension)
  *
  * The returned string should be freed with g_free() when no longer needed.
  *
- * Returns: a newly-allocated copy of #ESourceSelectable:color
+ * Returns: (nullable): a newly-allocated copy of #ESourceSelectable:color,
+ *    or %NULL, when none is set
  *
  * Since: 3.6
  **/
@@ -208,7 +210,7 @@ e_source_selectable_dup_color (ESourceSelectable *extension)
 /**
  * e_source_selectable_set_color:
  * @extension: an #ESourceSelectable
- * @color: (allow-none): a color specification, or %NULL
+ * @color: (nullable): a color specification, or %NULL
  *
  * Sets the color specification for the #ESource to which @extension
  * belongs.  A colored block is often displayed next to the data source's


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]