[evolution-data-server] [Camel] Fix some introspection annotations
- From: Corentin Noël <corentinnoel src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [evolution-data-server] [Camel] Fix some introspection annotations
- Date: Mon, 19 Dec 2016 12:06:27 +0000 (UTC)
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]