summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCorentin Noël <corentin.noel@collabora.com>2021-11-05 11:24:17 +0100
committerAllen Winter <allen.winter@kdab.com>2021-11-06 17:30:50 -0400
commit9610861396fb24512a6c4d2946e38dec2f24ad45 (patch)
tree6eb0ac94c851ec5286856b3132dee5e8a9d223e7
parent72e1a534087a966df3f82a8d24932353cb8aea58 (diff)
downloadlibical-git-9610861396fb24512a6c4d2946e38dec2f24ad45.tar.gz
libical-glib: Enhance comments on i_cal_time_get_timezone
This ICalTimezone lifetime is a little bit special to reduce the allocated memory.
-rw-r--r--src/libical-glib/api/i-cal-time.xml4
1 files changed, 2 insertions, 2 deletions
diff --git a/src/libical-glib/api/i-cal-time.xml b/src/libical-glib/api/i-cal-time.xml
index 4fd0fb6b..570777d7 100644
--- a/src/libical-glib/api/i-cal-time.xml
+++ b/src/libical-glib/api/i-cal-time.xml
@@ -85,8 +85,8 @@
</method>
<method name="i_cal_time_get_timezone" corresponds="(void *)icaltime_get_timezone" kind="get" since="1.0">
<parameter type="const ICalTime *" name="tt" annotation="in, transfer none" comment="The #ICalTime to be queried"/>
- <returns type="ICalTimezone *" annotation="transfer full" translator_argus="(GObject *)tt, TRUE" comment="The timezone information" />
- <comment xml:space="preserve">Returns the timezone.</comment>
+ <returns type="ICalTimezone *" annotation="transfer none" translator_argus="(GObject *)tt, TRUE" comment="The timezone information" />
+ <comment xml:space="preserve">Returns the timezone, the #ICalTimezone object is cached and can be either unreferenced once the last instance is used or can be kept until i_cal_object_free_global_objects() is called (usually at the very end of the program).</comment>
</method>
<method name="i_cal_time_set_timezone" corresponds="icaltime_set_timezone" kind="set" since="1.0">
<parameter type="ICalTime *" name="tt" native_op="POINTER" comment="The #ICalTime"/>