[evolution-data-server] [Camel] Fix some introspection annotations



commit 67c647ee1d675e0feb3123d0030f9f8ba662d6a3
Author: Corentin Noël <corentin elementary io>
Date:   Mon Dec 19 13:02:37 2016 +0100

    [Camel] Fix some introspection annotations
    
    Signed-off-by: Corentin Noël <corentin elementary io>

 src/camel/camel-block-file.c       |    4 ++--
 src/camel/camel-internet-address.c |    8 ++++----
 src/camel/camel-message-info.c     |    8 ++++----
 3 files changed, 10 insertions(+), 10 deletions(-)
---
diff --git a/src/camel/camel-block-file.c b/src/camel/camel-block-file.c
index b9fae3b..765d178 100644
--- a/src/camel/camel-block-file.c
+++ b/src/camel/camel-block-file.c
@@ -1232,7 +1232,7 @@ camel_key_file_delete (CamelKeyFile *kf)
  * @kf: a #CamelKeyFile
  * @parent: a #camel_block_t
  * @len: how many @records to write
- * @records: an array of #camel_key_t to write
+ * @records: (array length=len): an array of #camel_key_t to write
  *
  * Write a new list of records to the key file.
  *
@@ -1295,7 +1295,7 @@ camel_key_file_write (CamelKeyFile *kf,
  * @kf: a #CamelKeyFile
  * @start: The record pointer.  This will be set to the next record pointer on success.
  * @len: Number of records read, if != NULL.
- * @records: Records, allocated, must be freed with g_free, if != NULL.
+ * @records: (array length=len) (nullable): Records, allocated, must be freed with g_free, if != NULL.
  *
  * Read the next block of data from the key file.  Returns the number of
  * records.
diff --git a/src/camel/camel-internet-address.c b/src/camel/camel-internet-address.c
index ef7ee51..fde7d61 100644
--- a/src/camel/camel-internet-address.c
+++ b/src/camel/camel-internet-address.c
@@ -333,8 +333,8 @@ camel_internet_address_add (CamelInternetAddress *addr,
  * camel_internet_address_get:
  * @addr: a #CamelInternetAddress object
  * @index: address's array index
- * @namep: holder for the returned name, or %NULL, if not required.
- * @addressp: holder for the returned address, or %NULL, if not required.
+ * @namep: (out) (nullable): holder for the returned name, or %NULL, if not required.
+ * @addressp: (out) (nullable): holder for the returned address, or %NULL, if not required.
  *
  * Get the address at @index.
  *
@@ -365,7 +365,7 @@ camel_internet_address_get (CamelInternetAddress *addr,
  * camel_internet_address_find_name:
  * @addr: a #CamelInternetAddress object
  * @name: name to lookup
- * @addressp: holder for address part, or %NULL, if not required.
+ * @addressp: (out) (nullable): holder for address part, or %NULL, if not required.
  *
  * Find address by real name.
  *
@@ -463,7 +463,7 @@ camel_internet_address_ensure_ascii_domains (CamelInternetAddress *addr)
  * camel_internet_address_find_address:
  * @addr: a #CamelInternetAddress object
  * @address: address to lookup
- * @namep: holder for the matching name, or %NULL, if not required.
+ * @namep: (out) (nullable): holder for the matching name, or %NULL, if not required.
  *
  * Find an address by address.
  *
diff --git a/src/camel/camel-message-info.c b/src/camel/camel-message-info.c
index 687823e..6873cd2 100644
--- a/src/camel/camel-message-info.c
+++ b/src/camel/camel-message-info.c
@@ -950,7 +950,7 @@ camel_message_info_init (CamelMessageInfo *mi)
 
 /**
  * camel_message_info_new:
- * @summary: (nullable): parent #CamelFolderSummary object, or %NULL
+ * @summary: (nullable) (type CamelFolderSummary): parent #CamelFolderSummary object, or %NULL
  *
  * Create a new #CamelMessageInfo object, optionally for given @summary.
  *
@@ -980,7 +980,7 @@ camel_message_info_new (CamelFolderSummary *summary)
 /**
  * camel_message_info_clone:
  * @mi: a #CamelMessageInfo to clone
- * @assign_summary: (nullable): parent #CamelFolderSummary object, or %NULL, to set on the clone
+ * @assign_summary: (nullable) (type CamelFolderSummary): parent #CamelFolderSummary object, or %NULL, to 
set on the clone
  *
  * Clones the @mi as a new #CamelMessageInfo and eventually assigns
  * a new #CamelFolderSummary to it. If it's not set, then the same
@@ -1010,7 +1010,7 @@ camel_message_info_clone (const CamelMessageInfo *mi,
 /**
  * camel_message_info_load:
  * @mi: a #CamelMessageInfo to load
- * @record: a #CamelMIRecord to load the @mi from
+ * @record: (type CamelMIRecord): a #CamelMIRecord to load the @mi from
  * @bdata_ptr: a backend specific data (bdata) pointer
  *
  * Load content of @mi from the data stored in @record. The @bdata_ptr points
@@ -1059,7 +1059,7 @@ camel_message_info_load (CamelMessageInfo *mi,
 /**
  * camel_message_info_save:
  * @mi: a #CamelMessageInfo
- * @record: a #CamelMIRecord to populate
+ * @record: (type CamelMIRecord): a #CamelMIRecord to populate
  * @bdata_str: a #GString with a string to save as backend specific data (bdata)
  *
  * Save the @mi content to the message info record @record. It can populate all


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