summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristophe Fergeau <cfergeau@redhat.com>2014-05-23 15:17:08 +0200
committerChristophe Fergeau <cfergeau@redhat.com>2014-05-23 21:38:01 +0200
commit8d8c470027441849c790b4ff03bc1f94cdd9231a (patch)
tree35ead765671050680bdf9da3aac46a74add21c03
parentf455391c8a0e3b81ce0f48fb41e74b16d6b70494 (diff)
Fix gtk-doc 'transfer' annotations
Some functions were documented as (transfer none) instead of (transfer full) even though the caller of the function owns the returned object. This will cause some leaks when using gobject-introspection.
-rw-r--r--src/ibusattribute.h8
-rw-r--r--src/ibusbus.h12
-rw-r--r--src/ibusengine.h2
-rw-r--r--src/ibusinputcontext.h8
-rw-r--r--src/ibusserializable.h4
5 files changed, 17 insertions, 17 deletions
diff --git a/src/ibusattribute.h b/src/ibusattribute.h
index 7f287bac..e7150b29 100644
--- a/src/ibusattribute.h
+++ b/src/ibusattribute.h
@@ -132,7 +132,7 @@ GType ibus_attribute_get_type ();
* @value: Value of the attribute.
* @start_index: Where attribute starts.
* @end_index: Where attribute ends.
- * @returns: (transfer none): A newly allocated IBusAttribute.
+ * @returns: (transfer full): A newly allocated IBusAttribute.
*
* New an IBusAttribute.
*/
@@ -184,7 +184,7 @@ guint ibus_attribute_get_end_index
* @underline_type: Type of underline.
* @start_index: Where attribute starts.
* @end_index: Where attribute ends.
- * @returns: (transfer none): A newly allocated #IBusAttribute.
+ * @returns: (transfer full): A newly allocated #IBusAttribute.
*
* New an underline #IBusAttribute.
*/
@@ -196,7 +196,7 @@ IBusAttribute *ibus_attr_underline_new (guint underline_type,
* @color: Color in RGB.
* @start_index: Where attribute starts.
* @end_index: Where attribute ends.
- * @returns: (transfer none): A newly allocated #IBusAttribute.
+ * @returns: (transfer full): A newly allocated #IBusAttribute.
*
* New an foreground #IBusAttribute.
*/
@@ -208,7 +208,7 @@ IBusAttribute *ibus_attr_foreground_new (guint color,
* @color: Color in RGB.
* @start_index: Where attribute starts.
* @end_index: Where attribute ends.
- * @returns: (transfer none): A newly allocated #IBusAttribute.
+ * @returns: (transfer full): A newly allocated #IBusAttribute.
*
* New an background #IBusAttribute.
*/
diff --git a/src/ibusbus.h b/src/ibusbus.h
index fc37b258..bb74c671 100644
--- a/src/ibusbus.h
+++ b/src/ibusbus.h
@@ -638,7 +638,7 @@ gboolean ibus_bus_register_component_async_finish
/**
* ibus_bus_list_engines:
* @bus: An #IBusBus.
- * @returns: (transfer container) (element-type IBusEngineDesc): A List of engines.
+ * @returns: (transfer full) (element-type IBusEngineDesc): A List of engines.
*
* List engines synchronously.
*/
@@ -669,7 +669,7 @@ void ibus_bus_list_engines_async
* @res: A #GAsyncResult obtained from the #GAsyncReadyCallback passed to
* ibus_bus_list_engines_async().
* @error: Return location for error or %NULL.
- * @returns: (transfer container) (element-type IBusEngineDesc): A List of engines.
+ * @returns: (transfer full) (element-type IBusEngineDesc): A List of engines.
*
* Finishes an operation started with ibus_bus_list_engines_async().
*/
@@ -682,7 +682,7 @@ GList *ibus_bus_list_engines_async_finish
/**
* ibus_bus_list_active_engines:
* @bus: An #IBusBus.
- * @returns: (transfer container) (element-type IBusEngineDesc): A List of active engines.
+ * @returns: (transfer full) (element-type IBusEngineDesc): A List of active engines.
*
* List active engines synchronously.
*
@@ -722,7 +722,7 @@ void ibus_bus_list_active_engines_async
* @res: A #GAsyncResult obtained from the #GAsyncReadyCallback passed to
* ibus_bus_list_active_engines_async().
* @error: Return location for error or %NULL.
- * @returns: (transfer container) (element-type IBusEngineDesc): A List of active engines.
+ * @returns: (transfer full) (element-type IBusEngineDesc): A List of active engines.
*
* Finishes an operation started with ibus_bus_list_active_engines_async().
*
@@ -929,7 +929,7 @@ gboolean ibus_bus_is_global_engine_enabled_async_finish
/**
* ibus_bus_get_global_engine:
* @bus: An #IBusBus.
- * @returns: (transfer none): The description of current global engine,
+ * @returns: (transfer full): The description of current global engine,
* or %NULL if there is no global engine.
*
* Get the description of current global engine synchronously.
@@ -962,7 +962,7 @@ void ibus_bus_get_global_engine_async
* @res: A #GAsyncResult obtained from the #GAsyncReadyCallback passed to
* ibus_bus_get_global_engine_async_finish().
* @error: Return location for error or %NULL.
- * @returns: (transfer none): The description of current global engine,
+ * @returns: (transfer full): The description of current global engine,
* or %NULL if there is no global engine.
*
* Finishes an operation started with ibus_bus_get_global_engine_async_finish().
diff --git a/src/ibusengine.h b/src/ibusengine.h
index e77fdb27..300637ec 100644
--- a/src/ibusengine.h
+++ b/src/ibusengine.h
@@ -419,7 +419,7 @@ void ibus_engine_delete_surrounding_text(IBusEngine *engine,
/**
* ibus_engine_get_surrounding_text:
* @engine: An IBusEngine.
- * @text: (out) (transfer none) (allow-none): Location to store surrounding text.
+ * @text: (out) (transfer full) (allow-none): Location to store surrounding text.
* @cursor_pos: (out) (allow-none): Cursor position in characters in @text.
* @anchor_pos: (out) (allow-none): Anchor position of selection in @text.
*
diff --git a/src/ibusinputcontext.h b/src/ibusinputcontext.h
index 0fd6ef88..298d7108 100644
--- a/src/ibusinputcontext.h
+++ b/src/ibusinputcontext.h
@@ -136,7 +136,7 @@ IBusInputContext *
* ibus_input_context_get_input_context:
* @path: The path to the object that emitting the signal.
* @connection: An #GDBusConnection.
- * @returns: (transfer none): An existing #IBusInputContext.
+ * @returns: (transfer full): An existing #IBusInputContext.
*
* Gets an existing IBusInputContext.
*/
@@ -167,7 +167,7 @@ void ibus_input_context_get_input_context_async
* @res: A #GAsyncResult obtained from the #GAsyncReadyCallback pass to
* ibus_input_context_get_input_context_async().
* @error: Return location for error or %NULL.
- * @returns: (transfer none): An existing #IBusInputContext.
+ * @returns: (transfer full): An existing #IBusInputContext.
*
* Finishes an operation started with ibus_input_contex_get_input_context_async().
*/
@@ -392,7 +392,7 @@ void ibus_input_context_get_engine_async
* @res: A #GAsyncResult obtained from the #GAsyncReadyCallback passed to
* ibus_input_context_get_engine_async().
* @error: Return location for error or %NULL.
- * @returns: (transfer none): An IME engine description for the context, or %NULL.
+ * @returns: (transfer full): An IME engine description for the context, or %NULL.
*
* Finishes an operation started with ibus_input_context_get_engine_async().
*/
@@ -405,7 +405,7 @@ IBusEngineDesc *
/**
* ibus_input_context_get_engine:
* @context: An IBusInputContext.
- * @returns: (transfer none): An IME engine description for the context, or NULL.
+ * @returns: (transfer full): An IME engine description for the context, or NULL.
*
* Returns an IME engine description for the context.
* A synchronous IPC will be performed.
diff --git a/src/ibusserializable.h b/src/ibusserializable.h
index d12c47be..a344edbe 100644
--- a/src/ibusserializable.h
+++ b/src/ibusserializable.h
@@ -234,7 +234,7 @@ void ibus_serializable_remove_qattachment
/**
* ibus_serializable_copy:
* @serializable: An #IBusSerializable.
- * @returns: (transfer none): A newly allocated clone object; or %NULL
+ * @returns: (transfer full): A newly allocated clone object; or %NULL
* if @object is not serializable.
*
* Clone an #IBusSerializable.
@@ -259,7 +259,7 @@ GVariant *ibus_serializable_serialize (IBusSerializable *ser
/**
* ibus_serializable_deserialize:
* @variant: A #GVariant.
- * @returns: (transfer none): The deserialized #IBusSerializable.
+ * @returns: (transfer full): The deserialized #IBusSerializable.
*
* Deserialize a #GVariant to an #IBusSerializable/
* The deserialize method should be implemented in extended class.