[evolution-data-server] Mute/fix some of the libedataserver annotation warnings



commit 9af58096c79e445c9156c80644e5376f5d4ed990
Author: Milan Crha <mcrha redhat com>
Date:   Mon Nov 7 18:14:37 2016 +0100

    Mute/fix some of the libedataserver annotation warnings
    
    More mute, than fix, for functions possibly not interesting
    for the introspection users.

 src/libedataserver/e-data-server-util.c |   12 ++++++------
 src/libedataserver/e-flag.c             |   16 ++++++++--------
 src/libedataserver/e-memory.c           |   14 +++++++-------
 src/libedataserver/e-source-camel.c     |    2 +-
 src/libedataserver/e-source-registry.c  |    2 +-
 src/libedataserver/e-xml-hash-utils.c   |    8 ++++----
 src/libedataserver/e-xml-utils.c        |    6 +++---
 7 files changed, 30 insertions(+), 30 deletions(-)
---
diff --git a/src/libedataserver/e-data-server-util.c b/src/libedataserver/e-data-server-util.c
index abdbb61..94aed30 100644
--- a/src/libedataserver/e-data-server-util.c
+++ b/src/libedataserver/e-data-server-util.c
@@ -1145,7 +1145,7 @@ e_queue_transfer (GQueue *src_queue,
 }
 
 /**
- * e_weak_ref_new:
+ * e_weak_ref_new: (skip)
  * @object: (allow-none): a #GObject or %NULL
  *
  * Allocates a new #GWeakRef and calls g_weak_ref_set() with @object.
@@ -1168,7 +1168,7 @@ e_weak_ref_new (gpointer object)
 }
 
 /**
- * e_weak_ref_free:
+ * e_weak_ref_free: (skip)
  * @weak_ref: a #GWeakRef
  *
  * Frees a #GWeakRef created by e_weak_ref_new().
@@ -1650,7 +1650,7 @@ struct _EAsyncClosure {
 };
 
 /**
- * e_async_closure_new:
+ * e_async_closure_new: (skip)
  *
  * Creates a new #EAsyncClosure for use with asynchronous functions.
  *
@@ -1687,7 +1687,7 @@ e_async_closure_unlock_mutex_cb (gpointer user_data)
 }
 
 /**
- * e_async_closure_wait:
+ * e_async_closure_wait: (skip)
  * @closure: an #EAsyncClosure
  *
  * Call this function immediately after starting an asynchronous operation.
@@ -1727,7 +1727,7 @@ e_async_closure_wait (EAsyncClosure *closure)
 }
 
 /**
- * e_async_closure_free:
+ * e_async_closure_free: (skip)
  * @closure: an #EAsyncClosure
  *
  * Frees the @closure and the resources it holds.
@@ -1753,7 +1753,7 @@ e_async_closure_free (EAsyncClosure *closure)
 }
 
 /**
- * e_async_closure_callback:
+ * e_async_closure_callback: (skip)
  * @object: a #GObject or %NULL, it is not used by the function at all
  * @result: a #GAsyncResult
  * @closure: an #EAsyncClosure
diff --git a/src/libedataserver/e-flag.c b/src/libedataserver/e-flag.c
index 28882a7..894e567 100644
--- a/src/libedataserver/e-flag.c
+++ b/src/libedataserver/e-flag.c
@@ -33,7 +33,7 @@ gboolean      g_cond_timed_wait               (GCond *cond,
 #endif /* G_DISABLE_DEPRECATED */
 
 /**
- * e_flag_new:
+ * e_flag_new: (skip)
  *
  * Creates a new #EFlag object.  It is initially unset.
  *
@@ -55,7 +55,7 @@ e_flag_new (void)
 }
 
 /**
- * e_flag_is_set:
+ * e_flag_is_set: (skip)
  * @flag: an #EFlag
  *
  * Returns the state of @flag.
@@ -79,7 +79,7 @@ e_flag_is_set (EFlag *flag)
 }
 
 /**
- * e_flag_set:
+ * e_flag_set: (skip)
  * @flag: an #EFlag
  *
  * Sets @flag.  All threads waiting on @flag are woken up.  Threads that
@@ -100,7 +100,7 @@ e_flag_set (EFlag *flag)
 }
 
 /**
- * e_flag_clear:
+ * e_flag_clear: (skip)
  * @flag: an #EFlag
  *
  * Unsets @flag.  Subsequent calls to e_flag_wait() or e_flag_wait_until()
@@ -119,7 +119,7 @@ e_flag_clear (EFlag *flag)
 }
 
 /**
- * e_flag_wait:
+ * e_flag_wait: (skip)
  * @flag: an #EFlag
  *
  * Blocks until @flag is set.  If @flag is already set, the function returns
@@ -139,7 +139,7 @@ e_flag_wait (EFlag *flag)
 }
 
 /**
- * e_flag_timed_wait:
+ * e_flag_timed_wait: (skip)
  * @flag: an #EFlag
  * @abs_time: a #GTimeVal, determining the final time
  *
@@ -179,7 +179,7 @@ e_flag_timed_wait (EFlag *flag,
 G_GNUC_END_IGNORE_DEPRECATIONS
 
 /**
- * e_flag_wait_until:
+ * e_flag_wait_until: (skip)
  * @flag: an #EFlag
  * @end_time: the monotonic time to wait until
  *
@@ -213,7 +213,7 @@ e_flag_wait_until (EFlag *flag,
 }
 
 /**
- * e_flag_free:
+ * e_flag_free: (skip)
  * @flag: an #EFlag
  *
  * Destroys @flag.
diff --git a/src/libedataserver/e-memory.c b/src/libedataserver/e-memory.c
index 7be55ea..d934e8e 100644
--- a/src/libedataserver/e-memory.c
+++ b/src/libedataserver/e-memory.c
@@ -65,7 +65,7 @@ struct _EMemChunk {
 };
 
 /**
- * e_memchunk_new:
+ * e_memchunk_new: (skip)
  * @atomcount: the number of atoms stored in a single malloc'd block of memory
  * @atomsize: the size of each allocation
  *
@@ -93,7 +93,7 @@ e_memchunk_new (gint atomcount,
 }
 
 /**
- * e_memchunk_alloc:
+ * e_memchunk_alloc: (skip)
  * @memchunk: an #EMemChunk
  *
  * Allocate a new atom size block of memory from an #EMemChunk.
@@ -130,7 +130,7 @@ e_memchunk_alloc (EMemChunk *memchunk)
 }
 
 /**
- * e_memchunk_alloc0:
+ * e_memchunk_alloc0: (skip)
  * @memchunk: an #EMemChunk
  *
  * Allocate a new atom size block of memory from an #EMemChunk,
@@ -151,7 +151,7 @@ e_memchunk_alloc0 (EMemChunk *memchunk)
 }
 
 /**
- * e_memchunk_free:
+ * e_memchunk_free: (skip)
  * @memchunk: an #EMemChunk
  * @mem: address of atom to free
  *
@@ -179,7 +179,7 @@ e_memchunk_free (EMemChunk *memchunk,
 }
 
 /**
- * e_memchunk_empty:
+ * e_memchunk_empty: (skip)
  * @memchunk: an #EMemChunk
  *
  * Clean out the memchunk buffers.  Marks all allocated memory as free blocks,
@@ -233,7 +233,7 @@ tree_search (struct _cleaninfo *a,
 }
 
 /**
- * e_memchunk_clean:
+ * e_memchunk_clean: (skip)
  * @memchunk: an #EMemChunk
  *
  * Scan all empty blocks and check for blocks which can be free'd
@@ -310,7 +310,7 @@ e_memchunk_clean (EMemChunk *memchunk)
 }
 
 /**
- * e_memchunk_destroy:
+ * e_memchunk_destroy: (skip)
  * @memchunk: an #EMemChunk
  *
  * Free the memchunk header, and all associated memory.
diff --git a/src/libedataserver/e-source-camel.c b/src/libedataserver/e-source-camel.c
index a554e15..5dbdc76 100644
--- a/src/libedataserver/e-source-camel.c
+++ b/src/libedataserver/e-source-camel.c
@@ -741,7 +741,7 @@ e_source_camel_generate_subtype (const gchar *protocol,
  * This is essentially the glue that binds #ESource to #CamelService.
  * See e_source_camel_configure_service().
  *
- * Returns: a configured #CamelSettings instance
+ * Returns: (transfer none): a configured #CamelSettings instance
  *
  * Since: 3.6
  **/
diff --git a/src/libedataserver/e-source-registry.c b/src/libedataserver/e-source-registry.c
index 235be5e..b7348fc 100644
--- a/src/libedataserver/e-source-registry.c
+++ b/src/libedataserver/e-source-registry.c
@@ -2613,7 +2613,7 @@ source_registry_prune_nodes (GNode *node,
 }
 
 /**
- * e_source_registry_build_display_tree:
+ * e_source_registry_build_display_tree: (skip):
  * @registry: an #ESourceRegistry
  * @extension_name: (allow-none): an extension name, or %NULL
  *
diff --git a/src/libedataserver/e-xml-hash-utils.c b/src/libedataserver/e-xml-hash-utils.c
index 816f6e3..90536e0 100644
--- a/src/libedataserver/e-xml-hash-utils.c
+++ b/src/libedataserver/e-xml-hash-utils.c
@@ -118,7 +118,7 @@ foreach_save_func (gpointer key,
 }
 
 /**
- * e_xml_from_hash:
+ * e_xml_from_hash: (skip)
  * @hash: (element-type utf8 utf8): The #GHashTable to extract the XML from
  * @type: The #EXmlHashType used to store the XML
  * @root_name: The name to call the new #xmlDoc
@@ -126,7 +126,7 @@ foreach_save_func (gpointer key,
  * Uses the key/value pair representation of an XML structure in @hash
  * to build an equivalent #xmlDoc. This is the reverse of e_xml_to_hash().
  *
- * Returns: the #xmlDoc created from the data in @hash
+ * Returns: (transfer full): the #xmlDoc created from the data in @hash
  **/
 xmlDoc *
 e_xml_from_hash (GHashTable *hash,
@@ -180,13 +180,13 @@ struct EXmlHash {
 };
 
 /**
- * e_xmlhash_new:
+ * e_xmlhash_new: (skip)
  * @filename: the name of an XML file
  *
  * Creates a new #EXmlHash from the file @filename. If @filename does
  * not already exist, an empty #EXmlHash will be created.
  *
- * Returns: The new #EXmlHash structure, or %NULL if unable to parse
+ * Returns: (transfer full): The new #EXmlHash structure, or %NULL if unable to parse
  *          @filename.
  **/
 EXmlHash *
diff --git a/src/libedataserver/e-xml-utils.c b/src/libedataserver/e-xml-utils.c
index 5545afd..56f0f66 100644
--- a/src/libedataserver/e-xml-utils.c
+++ b/src/libedataserver/e-xml-utils.c
@@ -38,14 +38,14 @@
 #endif
 
 /**
- * e_xml_parse_file:
+ * e_xml_parse_file: (skip)
  * @filename: path to an XML file
  *
  * Reads a local XML file and parses the contents into an XML document
  * structure.  If the XML file cannot be read or its contents are malformed,
  * the function returns %NULL.
  *
- * Returns: an XML document structure, or %NULL
+ * Returns: (transfer full): an XML document structure, or %NULL
  **/
 xmlDocPtr
 e_xml_parse_file (const gchar *filename)
@@ -151,7 +151,7 @@ e_xml_save_file (const gchar *filename,
 }
 
 /**
- * e_xml_get_child_by_name:
+ * e_xml_get_child_by_name: (skip)
  * @parent: an XML node structure
  * @child_name: element name of a child node
  *


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