diff options
author | Corentin Noël <corentin.noel@collabora.com> | 2019-04-27 15:42:51 +0200 |
---|---|---|
committer | Corentin Noël <corentin.noel@collabora.com> | 2019-04-30 00:19:51 +0200 |
commit | 43120612908ca7443079791ff94528fd5ca4157b (patch) | |
tree | b5c78e242357530e35258bba7f7a3fa0b1118bb0 | |
parent | 0ac857cc859eaf5ca27c78da07f2ade048f64cdb (diff) | |
download | libical-git-43120612908ca7443079791ff94528fd5ca4157b.tar.gz |
[libical-glib] Add annotations for i_cal_memory_ functions
Add array and array length annotations
-rw-r--r-- | src/libical-glib/api/i-cal-memory.xml | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/src/libical-glib/api/i-cal-memory.xml b/src/libical-glib/api/i-cal-memory.xml index 3dd9dd9e..e20814b3 100644 --- a/src/libical-glib/api/i-cal-memory.xml +++ b/src/libical-glib/api/i-cal-memory.xml @@ -47,16 +47,16 @@ <comment xml:space="preserve">Free the buffer.</comment> </method> <method name="i_cal_memory_append_string" corresponds="icalmemory_append_string" since="1.0"> - <parameter type="gchar **" name="buf" comment="The buffer to be appended. It should not be the memory in ical."/> - <parameter type="gchar **" name="pos" comment="The position at which the new string to be appended."/> - <parameter type="size_t *" name="buf_size" comment="THe size of the buffer before appended"/> - <parameter type="const gchar *" name="string" comment="The string to be allocated"/> + <parameter type="gchar **" name="buf" annotation="array length=buf_size, element-type gchar, inout" comment="The buffer to be appended. It should not be the memory in ical."/> + <parameter type="gchar **" name="pos" annotation="array, element-type gchar, inout" comment="The position at which the new string to be appended."/> + <parameter type="size_t *" name="buf_size" comment="The size of the buffer before appended"/> + <parameter type="const gchar *" name="str" comment="The string to be allocated"/> <comment xml:space="preserve">Append the string to the buffer. Only use them on normally allocated memory, or on buffers created from icalmemory_new_buffer, never with buffers created by icalmemory_tmp_buffer. If icalmemory_append_string has to resize a buffer on the ring, the ring will loose track of it an you will have memory problems.</comment> </method> <method name="i_cal_memory_append_char" corresponds="icalmemory_append_char" since="1.0"> - <parameter type="gchar **" name="buf" comment="The buffer to be appended. It should not be the memory in ical."/> - <parameter type="gchar **" name="pos" comment="The position at which the new string to be appended."/> - <parameter type="size_t *" name="buf_size" comment="THe size of the buffer before appended"/> + <parameter type="gchar **" name="buf" annotation="array length=buf_size, element-type gchar, inout" comment="The buffer to be appended. It should not be the memory in ical."/> + <parameter type="gchar **" name="pos" annotation="array, element-type gchar, inout" comment="The position at which the new string to be appended."/> + <parameter type="size_t *" name="buf_size" comment="The size of the buffer before appended"/> <parameter type="gchar" name="ch" comment="The character to be allocated"/> <comment xml:space="preserve">Append the character to the buffer. Only use them on normally allocated memory, or on buffers created from icalmemory_new_buffer, never with buffers created by icalmemory_tmp_buffer. If icalmemory_append_string has to resize a buffer on the ring, the ring will loose track of it an you will have memory problems.</comment> </method> |