[gtk+/gi-annotations: 14/30] Update GI annotations in 'Numeric/Text Data Entry'

[Pavel Holejsovsky <pholejs src gnome org>]

commit 869f791a0a3d8ed9f0fce64c073733f7dd865efb
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Sat Jan 8 19:17:37 2011 +0100

    Update GI annotations in 'Numeric/Text Data Entry'
    
    'Numeric/Text Data Entry' group from GTK+ manual are: GtkEntry,
    GtkEntryBuffer, GtkEntryCompletion, GtkScale, GtkHScale, GtkVScale,
    GtkSpinButton, GtkEditable.

 gtk/gtkeditable.c   |    8 ++++----
 gtk/gtkeditable.h   |    8 ++++----
 gtk/gtkentry.c      |    8 ++++----
 gtk/gtkscale.c      |    8 ++++----
 gtk/gtkspinbutton.c |   10 +++++-----
 gtk/gtktextbuffer.h |   16 ++++++++--------
 6 files changed, 29 insertions(+), 29 deletions(-)
---
diff --git a/gtk/gtkeditable.c b/gtk/gtkeditable.c
index e85b1f1..f9be37e 100644
--- a/gtk/gtkeditable.c
+++ b/gtk/gtkeditable.c
@@ -113,10 +113,10 @@ gtk_editable_base_init (gpointer g_class)
        * @new_text: the new text to insert
        * @new_text_length: the length of the new text, in bytes,
        *     or -1 if new_text is nul-terminated
-       * @position: the position, in characters, at which to insert
-       *     the new text. this is an in-out parameter.
-       *     After the signal emission is finished, it should
-       *     point after the newly inserted text.
+       * @position: (inout) (type int): the position, in characters,
+       *     at which to insert the new text. this is an in-out
+       *     parameter.  After the signal emission is finished, it
+       *     should point after the newly inserted text.
        *
        * This signal is emitted when text is inserted into
        * the widget by the user. The default handler for
diff --git a/gtk/gtkeditable.h b/gtk/gtkeditable.h
index 5ccebce..90849ff 100644
--- a/gtk/gtkeditable.h
+++ b/gtk/gtkeditable.h
@@ -51,8 +51,8 @@ struct _GtkEditableInterface
 
   /* signals */
   void (* insert_text)              (GtkEditable    *editable,
-				     const gchar    *text,
-				     gint            length,
+				     const gchar    *new_text,
+				     gint            new_text_length,
 				     gint           *position);
   void (* delete_text)              (GtkEditable    *editable,
 				     gint            start_pos,
@@ -61,8 +61,8 @@ struct _GtkEditableInterface
 
   /* vtable */
   void (* do_insert_text)           (GtkEditable    *editable,
-				     const gchar    *text,
-				     gint            length,
+				     const gchar    *new_text,
+				     gint            new_text_length,
 				     gint           *position);
   void (* do_delete_text)           (GtkEditable    *editable,
 				     gint            start_pos,
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index bb20731..2a5b68d 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -6809,7 +6809,7 @@ gtk_entry_set_buffer (GtkEntry       *entry,
 /**
  * gtk_entry_get_text_area:
  * @entry: a #GtkEntry
- * @text_area: Return location for the text area.
+ * @text_area: (out): Return location for the text area.
  *
  * Gets the area where the entry's text is drawn. This function is
  * useful when drawing something to the entry in a draw callback.
@@ -7480,8 +7480,8 @@ gtk_entry_text_index_to_layout_index (GtkEntry *entry,
 /**
  * gtk_entry_get_layout_offsets:
  * @entry: a #GtkEntry
- * @x: (allow-none): location to store X offset of layout, or %NULL
- * @y: (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (allow-none): location to store X offset of layout, or %NULL
+ * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
  *
  *
  * Obtains the position of the #PangoLayout used to render text
@@ -8288,7 +8288,7 @@ gtk_entry_get_current_icon_drag_source (GtkEntry *entry)
  * gtk_entry_get_icon_area:
  * @entry: A #GtkEntry
  * @icon_pos: Icon position
- * @icon_area: Return location for the icon's area
+ * @icon_area: (out): Return location for the icon's area
  *
  * Gets the area where entry's icon at @icon_pos is drawn.
  * This function is useful when drawing something to the
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 486e647..a69ae84 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -510,8 +510,8 @@ gtk_scale_get_property (GObject      *object,
 /**
  * gtk_scale_new:
  * @orientation: the scale's orientation.
- * @adjustment: the #GtkAdjustment which sets the range of the scale, or
- *              %NULL to create a new adjustment.
+ * @adjustment: (allow-none): the #GtkAdjustment which sets the range
+ *              of the scale, or %NULL to create a new adjustment.
  *
  * Creates a new #GtkScale.
  *
@@ -1400,8 +1400,8 @@ gtk_scale_get_layout (GtkScale *scale)
 /**
  * gtk_scale_get_layout_offsets:
  * @scale: a #GtkScale
- * @x: (allow-none): location to store X offset of layout, or %NULL
- * @y: (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (allow-none): location to store X offset of layout, or %NULL
+ * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
  *
  * Obtains the coordinates where the scale will draw the 
  * #PangoLayout representing the text in the scale. Remember
diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c
index 65b4e2e..236d1d5 100644
--- a/gtk/gtkspinbutton.c
+++ b/gtk/gtkspinbutton.c
@@ -397,7 +397,7 @@ gtk_spin_button_class_init (GtkSpinButtonClass *class)
   /**
    * GtkSpinButton::input:
    * @spin_button: the object on which the signal was emitted
-   * @new_value: return location for the new value
+   * @new_value: (out) (type double): return location for the new value
    *
    * The ::input signal can be used to influence the conversion of
    * the users input into a double value. The signal handler is
@@ -2138,8 +2138,8 @@ gtk_spin_button_set_increments (GtkSpinButton *spin_button,
 /**
  * gtk_spin_button_get_increments:
  * @spin_button: a #GtkSpinButton
- * @step: (allow-none): location to store step increment, or %NULL
- * @page: (allow-none): location to store page increment, or %NULL
+ * @step: (out) (allow-none): location to store step increment, or %NULL
+ * @page: (out) (allow-none): location to store page increment, or %NULL
  *
  * Gets the current step and page the increments used by @spin_button. See
  * gtk_spin_button_set_increments().
@@ -2192,8 +2192,8 @@ gtk_spin_button_set_range (GtkSpinButton *spin_button,
 /**
  * gtk_spin_button_get_range:
  * @spin_button: a #GtkSpinButton
- * @min: (allow-none): location to store minimum allowed value, or %NULL
- * @max: (allow-none): location to store maximum allowed value, or %NULL
+ * @min: (out) (allow-none): location to store minimum allowed value, or %NULL
+ * @max: (out) (allow-none): location to store maximum allowed value, or %NULL
  *
  * Gets the range allowed for @spin_button.
  * See gtk_spin_button_set_range().
diff --git a/gtk/gtktextbuffer.h b/gtk/gtktextbuffer.h
index 5e7d944..565d597 100644
--- a/gtk/gtktextbuffer.h
+++ b/gtk/gtktextbuffer.h
@@ -83,15 +83,15 @@ struct _GtkTextBufferClass
 
   void (* insert_text)     (GtkTextBuffer *buffer,
                             GtkTextIter *pos,
-                            const gchar *text,
-                            gint length);
+                            const gchar *new_text,
+                            gint new_text_length);
 
   void (* insert_pixbuf)   (GtkTextBuffer *buffer,
-                            GtkTextIter   *pos,
+                            GtkTextIter   *iter,
                             GdkPixbuf     *pixbuf);
 
   void (* insert_child_anchor)   (GtkTextBuffer      *buffer,
-                                  GtkTextIter        *pos,
+                                  GtkTextIter        *iter,
                                   GtkTextChildAnchor *anchor);
 
   void (* delete_range)     (GtkTextBuffer *buffer,
@@ -117,13 +117,13 @@ struct _GtkTextBufferClass
 
   void (* apply_tag)          (GtkTextBuffer *buffer,
                                GtkTextTag *tag,
-                               const GtkTextIter *start_char,
-                               const GtkTextIter *end_char);
+                               const GtkTextIter *start,
+                               const GtkTextIter *end);
 
   void (* remove_tag)         (GtkTextBuffer *buffer,
                                GtkTextTag *tag,
-                               const GtkTextIter *start_char,
-                               const GtkTextIter *end_char);
+                               const GtkTextIter *start,
+                               const GtkTextIter *end);
 
   /* Called at the start and end of an atomic user action */
   void (* begin_user_action)  (GtkTextBuffer *buffer);