[evolution-data-server/tintou/303] I#303 - camel-folder: Add nullable and optional annotations to out parameters.

[Corentin Noël <corentinnoel src gnome org>]

commit dca1f37aae642cffef797ee477d9aa539b30ecdd
Author: Corentin Noël <corentin noel collabora com>
Date:   Mon Mar 1 17:18:49 2021 +0100

    I#303 - camel-folder: Add nullable and optional annotations to out parameters.
    
    Also add (nullable) for the actually nullable in parameters.
    Partial fix to https://gitlab.gnome.org/GNOME/evolution-data-server/-/issues/303

 src/camel/camel-folder.c | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)
---
diff --git a/src/camel/camel-folder.c b/src/camel/camel-folder.c
index 594504c6a..50bb9b3b0 100644
--- a/src/camel/camel-folder.c
+++ b/src/camel/camel-folder.c
@@ -3094,10 +3094,11 @@ camel_folder_unlock (CamelFolder *folder)
  * camel_folder_append_message_sync:
  * @folder: a #CamelFolder
  * @message: a #CamelMimeMessage
- * @info: a #CamelMessageInfo with additional flags/etc to set on the
+ * @info: (nullable): a #CamelMessageInfo with additional flags/etc to set on the
  *        new message, or %NULL
- * @appended_uid: if non-%NULL, the UID of the appended message will
- *                be returned here, if it is known
+ * @appended_uid: (out) (optional) (nullable): if non-%NULL, the UID
+ *                of the appended message will be returned here, if it
+ *                is known
  * @cancellable: optional #GCancellable object, or %NULL
  * @error: return location for a #GError, or %NULL
  *
@@ -3179,8 +3180,8 @@ folder_append_message_thread (GTask *task,
  * camel_folder_append_message:
  * @folder: a #CamelFolder
  * @message: a #CamelMimeMessage
- * @info: a #CamelMessageInfo with additional flags/etc to set on the
- *        new message, or %NULL
+ * @info: (nullable): a #CamelMessageInfo with additional flags/etc to set
+ *        on the new message, or %NULL
  * @io_priority: the I/O priority of the request
  * @cancellable: optional #GCancellable object, or %NULL
  * @callback: a #GAsyncReadyCallback to call when the request is satisfied
@@ -3231,8 +3232,9 @@ camel_folder_append_message (CamelFolder *folder,
  * camel_folder_append_message_finish:
  * @folder: a #CamelFolder
  * @result: a #GAsyncResult
- * @appended_uid: if non-%NULL, the UID of the appended message will
- *                be returned here, if it is known
+ * @appended_uid: (out) (optional) (nullable): if non-%NULL, the UID of
+ *                the appended message will be returned here, if it is
+ *                known
  * @error: return location for a #GError, or %NULL
  *
  * Finishes the operation started with camel_folder_append_message_finish().
@@ -4417,9 +4419,9 @@ uid_index_pair_free (gpointer ptr)
  * @message_uids: (element-type utf8): message UIDs in @source
  * @destination: the destination #CamelFolder
  * @delete_originals: whether or not to delete the original messages
- * @transferred_uids: (element-type utf8) (out): if non-%NULL, the UIDs of the
- *                    resulting messages in @destination will be stored here,
- *                    if known.
+ * @transferred_uids: (element-type utf8) (out) (optional) (nullable): if
+ *                    non-%NULL, the UIDs of the resulting messages in
+ *                    @destination will be stored here, if known.
  * @cancellable: optional #GCancellable object, or %NULL
  * @error: return location for a #GError, or %NULL
  *
@@ -4689,9 +4691,9 @@ camel_folder_transfer_messages_to (CamelFolder *source,
  * camel_folder_transfer_messages_to_finish:
  * @source: a #CamelFolder
  * @result: a #GAsyncResult
- * @transferred_uids: (element-type utf8) (out): if non-%NULL, the UIDs of the
- *                    resulting messages in @destination will be stored here,
- *                    if known.
+ * @transferred_uids: (element-type utf8) (out) (optional) (nullable): if
+ *                    non-%NULL, the UIDs of the resulting messages in
+ *                    @destination will be stored here, if known.
  * @error: return location for a #GError, or %NULL
  *
  * Finishes the operation started with camel_folder_transfer_messages_to().