Make parameter naming consistent.

2007-07-11  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtktreeview.c:
        * gtk/gtktoolitem.[hc]: Make parameter naming consistent.



svn path=/trunk/; revision=18452

1 files changed, 28 insertions, 25 deletions

diff --git a/gtk/gtktoolitem.c b/gtk/gtktoolitem.c
index 2ae4406fb7..1916af938c 100644
--- a/gtk/gtktoolitem.c
+++ b/gtk/gtktoolitem.c
@@ -148,13 +148,13 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
 
 /**
  * GtkToolItem::create-menu-proxy:
- * @toolitem: the object the signal was emitted on
+ * @tool_item: the object the signal was emitted on
  *
  * This signal is emitted when the toolbar needs information from @tool_item
  * about whether the item should appear in the toolbar overflow menu. In
  * response the tool item should either
  * <itemizedlist>
- * <listitem> call gtk_tool_item_set_proxy_menu_item() with a %NULL
+ * <listitem>call gtk_tool_item_set_proxy_menu_item() with a %NULL
  * pointer and return %TRUE to indicate that the item should not appear
  * in the overflow menu
  * </listitem>
@@ -186,7 +186,7 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
 
 /**
  * GtkToolItem::toolbar-reconfigured:
- * @toolitem: the object the signal was emitted on
+ * @tool_item: the object the signal was emitted on
  *
  * This signal is emitted when some property of the toolbar that the
  * item is a child of changes. For custom subclasses of #GtkToolItem,
@@ -210,7 +210,7 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
 		  G_TYPE_NONE, 0);
 /**
  * GtkToolItem::set-tooltip:
- * @toolitem: the object the signal was emitted on
+ * @tool_item: the object the signal was emitted on
  * @tooltips: the #GtkTooltips
  * @tip_text: the tooltip text
  * @tip_private: the tooltip private text
@@ -220,6 +220,9 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
  * set the item's tooltip.
  *
  * Return value: %TRUE if the signal was handled, %FALSE if not
+ *
+ * Deprecated: 2.12: With the new tooltip API, there is no
+ *   need to use this signal anymore.
  **/
   toolitem_signals[SET_TOOLTIP] =
     g_signal_new (I_("set_tooltip"),
@@ -857,13 +860,13 @@ gtk_tool_item_set_tooltip_markup (GtkToolItem *tool_item,
 
 /**
  * gtk_tool_item_set_use_drag_window:
- * @toolitem: a #GtkToolItem 
- * @use_drag_window: Whether @toolitem has a drag window.
+ * @tool_item: a #GtkToolItem 
+ * @use_drag_window: Whether @tool_item has a drag window.
  * 
- * Sets whether @toolitem has a drag window. When %TRUE the
+ * Sets whether @tool_item has a drag window. When %TRUE the
  * toolitem can be used as a drag source through gtk_drag_source_set().
- * When @toolitem has a drag window it will intercept all events,
- * even those that would otherwise be sent to a child of @toolitem.
+ * When @tool_item has a drag window it will intercept all events,
+ * even those that would otherwise be sent to a child of @tool_item.
  * 
  * Since: 2.4
  **/
@@ -897,12 +900,12 @@ gtk_tool_item_set_use_drag_window (GtkToolItem *toolitem,
 
 /**
  * gtk_tool_item_get_use_drag_window:
- * @toolitem: a #GtkToolItem 
+ * @tool_item: a #GtkToolItem 
  * 
- * Returns whether @toolitem has a drag window. See
+ * Returns whether @tool_item has a drag window. See
  * gtk_tool_item_set_use_drag_window().
  * 
- * Return value: %TRUE if @toolitem uses a drag window.
+ * Return value: %TRUE if @tool_item uses a drag window.
  * 
  * Since: 2.4
  **/
@@ -916,10 +919,10 @@ gtk_tool_item_get_use_drag_window (GtkToolItem *toolitem)
 
 /**
  * gtk_tool_item_set_visible_horizontal:
- * @toolitem: a #GtkToolItem
- * @visible_horizontal: Whether @toolitem is visible when in horizontal mode
+ * @tool_item: a #GtkToolItem
+ * @visible_horizontal: Whether @tool_item is visible when in horizontal mode
  * 
- * Sets whether @toolitem is visible when the toolbar is docked horizontally.
+ * Sets whether @tool_item is visible when the toolbar is docked horizontally.
  * 
  * Since: 2.4
  **/
@@ -943,12 +946,12 @@ gtk_tool_item_set_visible_horizontal (GtkToolItem *toolitem,
 
 /**
  * gtk_tool_item_get_visible_horizontal:
- * @toolitem: a #GtkToolItem 
+ * @tool_item: a #GtkToolItem 
  * 
- * Returns whether the @toolitem is visible on toolbars that are
+ * Returns whether the @tool_item is visible on toolbars that are
  * docked horizontally.
  * 
- * Return value: %TRUE if @toolitem is visible on toolbars that are
+ * Return value: %TRUE if @tool_item is visible on toolbars that are
  * docked horizontally.
  * 
  * Since: 2.4
@@ -963,14 +966,14 @@ gtk_tool_item_get_visible_horizontal (GtkToolItem *toolitem)
 
 /**
  * gtk_tool_item_set_visible_vertical:
- * @toolitem: a #GtkToolItem 
- * @visible_vertical: whether @toolitem is visible when the toolbar
+ * @tool_item: a #GtkToolItem 
+ * @visible_vertical: whether @tool_item is visible when the toolbar
  * is in vertical mode
  *
- * Sets whether @toolitem is visible when the toolbar is docked
+ * Sets whether @tool_item is visible when the toolbar is docked
  * vertically. Some tool items, such as text entries, are too wide to be
  * useful on a vertically docked toolbar. If @visible_vertical is %FALSE
- * @toolitem will not appear on toolbars that are docked vertically.
+ * @tool_item will not appear on toolbars that are docked vertically.
  * 
  * Since: 2.4
  **/
@@ -994,12 +997,12 @@ gtk_tool_item_set_visible_vertical (GtkToolItem *toolitem,
 
 /**
  * gtk_tool_item_get_visible_vertical:
- * @toolitem: a #GtkToolItem 
+ * @tool_item: a #GtkToolItem 
  * 
- * Returns whether @toolitem is visible when the toolbar is docked vertically.
+ * Returns whether @tool_item is visible when the toolbar is docked vertically.
  * See gtk_tool_item_set_visible_vertical().
  * 
- * Return value: Whether @toolitem is visible when the toolbar is docked vertically
+ * Return value: Whether @tool_item is visible when the toolbar is docked vertically
  * 
  * Since: 2.4
  **/