[gtk+/gi-annotations: 23/28] Update GI annotations in 'Clipboards'

[Pavel Holejsovsky <pholejs src gnome org>]

commit 69fe4043763f4ba4e7e2333076d83c673bf09ee9
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Fri Jan 14 15:46:33 2011 +0100

    Update GI annotations in 'Clipboards'

 gtk/gtkclipboard.c |   31 ++++++++++++++++---------------
 1 files changed, 16 insertions(+), 15 deletions(-)
---
diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c
index 0c40639..5335c4e 100644
--- a/gtk/gtkclipboard.c
+++ b/gtk/gtkclipboard.c
@@ -565,10 +565,10 @@ gtk_clipboard_set_contents (GtkClipboard         *clipboard,
 }
 
 /**
- * gtk_clipboard_set_with_data:
+ * gtk_clipboard_set_with_data: (skip)
  * @clipboard: a #GtkClipboard
- * @targets: array containing information about the available forms for the
- *     clipboard data
+ * @targets: (array length=n_targets): array containing information
+ *     about the available forms for the clipboard data
  * @n_targets: number of elements in @targets
  * @get_func: (scope async): function to call to get the actual clipboard data
  * @clear_func: (scope async): when the clipboard contents are set again,
@@ -602,10 +602,10 @@ gtk_clipboard_set_with_data (GtkClipboard          *clipboard,
 }
 
 /**
- * gtk_clipboard_set_with_owner:
+ * gtk_clipboard_set_with_owner: (skip)
  * @clipboard: a #GtkClipboard
- * @targets: array containing information about the available forms for
- *     the clipboard data
+ * @targets: (array length=n_targets): array containing information
+ *     about the available forms for the clipboard data
  * @n_targets: number of elements in @targets
  * @get_func: (scope async): function to call to get the actual clipboard data
  * @clear_func: (scope async): when the clipboard contents are set again,
@@ -1405,8 +1405,8 @@ clipboard_rich_text_received_func (GtkClipboard *clipboard,
  * gtk_clipboard_wait_for_rich_text:
  * @clipboard: a #GtkClipboard
  * @buffer: a #GtkTextBuffer
- * @format: return location for the format of the returned data
- * @length: return location for the length of the returned data
+ * @format: (out): return location for the format of the returned data
+ * @length: (out): return location for the length of the returned data
  *
  * Requests the contents of the clipboard as rich text.  This function
  * waits for the data to be received using the main loop, so events,
@@ -1532,7 +1532,7 @@ clipboard_uris_received_func (GtkClipboard *clipboard,
  * for the data to be received using the main loop, so events,
  * timeouts, etc, may be dispatched during the wait.
  *
- * Return value: (array zero-terminated=1) (element-type utf8) (transfer full): a newly-allocated
+ * Return value: (array zero-terminated=1) (transfer full): a newly-allocated
  * 		 %NULL-terminated array of strings which must
  *               be freed with g_strfreev(), or %NULL if
  *               retrieving the selection data failed. (This
@@ -1730,9 +1730,10 @@ gtk_clipboard_wait_is_uris_available (GtkClipboard *clipboard)
 /**
  * gtk_clipboard_wait_for_targets
  * @clipboard: a #GtkClipboard
- * @targets: location to store an array of targets. The result
- *           stored here must be freed with g_free().
- * @n_targets: location to store number of items in @targets.
+ * @targets: (out) (array length=n_targets) (transfer full): location
+ *           to store an array of targets. The result stored here must
+ *           be freed with g_free().
+ * @n_targets: (out): location to store number of items in @targets.
  *
  * Returns a list of targets that are present on the clipboard, or %NULL
  * if there aren't any targets available. The returned list must be 
@@ -1932,9 +1933,9 @@ gtk_clipboard_store_timeout (GtkClipboard *clipboard)
 /**
  * gtk_clipboard_set_can_store:
  * @clipboard: a #GtkClipboard
- * @targets: (allow-none): array containing information about which forms 
- *           should be stored or %NULL to indicate that all forms should 
- *           be stored.
+ * @targets: (allow-none) (array length=n_targets): array containing
+ *           information about which forms should be stored or %NULL
+ *           to indicate that all forms should be stored.
  * @n_targets: number of elements in @targets
  *
  * Hints that the clipboard data should be stored somewhere when the