/**
* g_completion_add_items:
* @cmp: the #GCompletion.
- * @items: the list of items to add.
+ * @items: (transfer none): the list of items to add.
*
* Adds items to the #GCompletion.
*
/**
* g_completion_remove_items:
* @cmp: the #GCompletion.
- * @items: the items to remove.
+ * @items: (transfer none): the items to remove.
*
- * Removes items from a #GCompletion.
+ * Removes items from a #GCompletion. The items are not freed, so if the memory
+ * was dynamically allocated, free @items with g_list_free_full() after calling
+ * this function.
*
* Deprecated: 2.26: Rarely used API
**/
* g_completion_clear_items:
* @cmp: the #GCompletion.
*
- * Removes all items from the #GCompletion.
+ * Removes all items from the #GCompletion. The items are not freed, so if the
+ * memory was dynamically allocated, it should be freed after calling this
+ * function.
*
* Deprecated: 2.26: Rarely used API
**/
* common to all items that matched @prefix, or %NULL if
* no items matched @prefix. This string should be freed
* when no longer needed.
- * @Returns: the list of items whose strings begin with @prefix. This
- * should not be changed.
+ * @Returns: (transfer none): the list of items whose strings begin with
+ * @prefix. This should not be changed.
*
* Attempts to complete the string @prefix using the #GCompletion
* target items.
* g_completion_free:
* @cmp: the #GCompletion.
*
- * Frees all memory used by the #GCompletion.
+ * Frees all memory used by the #GCompletion. The items are not freed, so if
+ * the memory was dynamically allocated, it should be freed after calling this
+ * function.
*
* Deprecated: 2.26: Rarely used API
**/