[gtk+/gi-annotations: 20/30] Update GI annotations in 'Layout Containers'

[Pavel Holejsovsky <pholejs src gnome org>]

commit d1b894940aeaafaa4b5972e1a7d88d8e44a769d3
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Fri Jan 7 21:34:52 2011 +0100

    Update GI annotations in 'Layout Containers'
    
    'Layout Containers' group from GTK+ manual are: GtkGrid, GtkAlignment,
    GtkAspectFrame, GtkBox, GtkHBox, GtkVBox, GtkBUttonBox, GtkHButtonBox,
    GtkVButtonBox, GtkFixed, GtkPaned, GtkHPaned, GtkVPaned, GtkLayout,
    GtkNotebook, GtkTable, GtkExpander, GtkOrientable.

 gtk/gtkalignment.c |   12 ++++++++----
 gtk/gtkbox.c       |   12 ++++++++----
 gtk/gtklayout.c    |    6 ++++--
 gtk/gtknotebook.c  |    3 ++-
 4 files changed, 22 insertions(+), 11 deletions(-)
---
diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c
index 78f21aa..281fa9c 100644
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -753,10 +753,14 @@ gtk_alignment_set_padding (GtkAlignment    *alignment,
 /**
  * gtk_alignment_get_padding:
  * @alignment: a #GtkAlignment
- * @padding_top: (allow-none): location to store the padding for the top of the widget, or %NULL
- * @padding_bottom: (allow-none): location to store the padding for the bottom of the widget, or %NULL
- * @padding_left: (allow-none): location to store the padding for the left of the widget, or %NULL
- * @padding_right: (allow-none): location to store the padding for the right of the widget, or %NULL
+ * @padding_top: (out) (allow-none): location to store the padding for
+ *     the top of the widget, or %NULL
+ * @padding_bottom: (out) (allow-none): location to store the padding
+ *     for the bottom of the widget, or %NULL
+ * @padding_left: (out) (allow-none): location to store the padding
+ *     for the left of the widget, or %NULL
+ * @padding_right: (out) (allow-none): location to store the padding
+ *     for the right of the widget, or %NULL
  *
  * Gets the padding on the different sides of the widget.
  * See gtk_alignment_set_padding ().
diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 8c7f867..6292ca8 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -1505,10 +1505,14 @@ gtk_box_reorder_child (GtkBox    *box,
  * gtk_box_query_child_packing:
  * @box: a #GtkBox
  * @child: the #GtkWidget of the child to query
- * @expand: pointer to return location for #GtkBox:expand child property
- * @fill: pointer to return location for #GtkBox:fill child property
- * @padding: pointer to return location for #GtkBox:padding child property
- * @pack_type: pointer to return location for #GtkBox:pack-type child property
+ * @expand: (out): pointer to return location for #GtkBox:expand child
+ *     property
+ * @fill: (out): pointer to return location for #GtkBox:fill child
+ *     property
+ * @padding: (out): pointer to return location for #GtkBox:padding
+ *     child property
+ * @pack_type: (out): pointer to return location for #GtkBox:pack-type
+ *     child property
  *
  * Obtains information about how @child is packed into @box.
  */
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index 3cb0a82..f9ac989 100644
--- a/gtk/gtklayout.c
+++ b/gtk/gtklayout.c
@@ -582,8 +582,10 @@ gtk_layout_set_size (GtkLayout     *layout,
 /**
  * gtk_layout_get_size:
  * @layout: a #GtkLayout
- * @width: (allow-none): location to store the width set on @layout, or %NULL
- * @height: (allow-none): location to store the height set on @layout, or %NULL
+ * @width: (out) (allow-none): location to store the width set on
+ *     @layout, or %NULL
+ * @height: (out) (allow-none): location to store the height set on
+ *     @layout, or %NULL
  *
  * Gets the size that has been set on the layout, and that determines
  * the total extents of the layout's scrollbar area. See
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index e94518d..a237602 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -1047,7 +1047,8 @@ gtk_notebook_class_init (GtkNotebookClass *class)
    * necessary properties to the notebook (e.g. the
    * #GtkNotebook:group ).
    *
-   * Returns: a #GtkNotebook that @page should be added to, or %NULL.
+   * Returns: (transfer none): a #GtkNotebook that @page should be
+   *     added to, or %NULL.
    *
    * Since: 2.12
    */