2005-06-10 Matthias Clasen <mclasen@redhat.com>

	* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_set_expand):
	* gtk/gtktoolbar.c (gtk_toolbar_get_show_arrow):
	* gtk/gtktextview.c (gtk_text_view_get_iter_at_position):
	* gtk/gtkstock.c (gtk_stock_set_translate_func):
	* gtk/gtkspinbutton.c (gtk_spin_button_get_adjustment):
	* gtk/gtkscrolledwindow.h:
	* gtk/gtkmenushell.c (gtk_menu_shell_get_take_focus):

7 files changed, 15 insertions, 9 deletions

diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index 158a15a81b..1febb46530 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -1469,7 +1469,9 @@ _gtk_menu_shell_remove_mnemonic (GtkMenuShell *menu_shell,
  * gtk_menu_shell_get_take_focus:
  * @menu_shell: a #GtkMenuShell
  *
- * @returns: %TRUE if the menu shell will take the keyboard focus on popup.
+ * Returns %TRUE if the menu shell will take the keyboard focus on popup.
+ *
+ * Returns: %TRUE if the menu shell will take the keyboard focus on popup.
  *
  * Since: 2.8
  **/
diff --git a/gtk/gtkscrolledwindow.h b/gtk/gtkscrolledwindow.h
index 729de2759e..4d40013163 100644
--- a/gtk/gtkscrolledwindow.h
+++ b/gtk/gtkscrolledwindow.h
@@ -104,7 +104,7 @@ GtkWidget*     gtk_scrolled_window_new               (GtkAdjustment     *hadjust
 void           gtk_scrolled_window_set_hadjustment   (GtkScrolledWindow *scrolled_window,
 						      GtkAdjustment     *hadjustment);
 void           gtk_scrolled_window_set_vadjustment   (GtkScrolledWindow *scrolled_window,
-						      GtkAdjustment     *hadjustment);
+						      GtkAdjustment     *vadjustment);
 GtkAdjustment* gtk_scrolled_window_get_hadjustment   (GtkScrolledWindow *scrolled_window);
 GtkAdjustment* gtk_scrolled_window_get_vadjustment   (GtkScrolledWindow *scrolled_window);
 GtkWidget*     gtk_scrolled_window_get_hscrollbar    (GtkScrolledWindow *scrolled_window);
diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c
index ddffe6049a..fe7ec9c4cb 100644
--- a/gtk/gtkspinbutton.c
+++ b/gtk/gtkspinbutton.c
@@ -1693,7 +1693,7 @@ gtk_spin_button_set_adjustment (GtkSpinButton *spin_button,
 
 /**
  * gtk_spin_button_get_adjustment:
- * @spin_button: 
+ * @spin_button: a #GtkSpinButton
  * 
  * Get the adjustment associated with a #GtkSpinButton
  * 
diff --git a/gtk/gtkstock.c b/gtk/gtkstock.c
index 5a4482ea61..15dce0cf6b 100644
--- a/gtk/gtkstock.c
+++ b/gtk/gtkstock.c
@@ -415,6 +415,7 @@ static const GtkStockItem builtin_items [] =
 
 /**
  * gtk_stock_set_translate_func: 
+ * @domain: the translation domain for which @func shall be used
  * @func: a #GtkTranslateFunc 
  * @data: data to pass to @func
  * @notify: a #GtkDestroyNotify that is called when @data is 
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index 91f1d4fac1..3ea6f1ebe2 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -1305,7 +1305,10 @@ gtk_text_view_get_iter_at_location (GtkTextView *text_view,
  * gtk_text_view_get_iter_at_position:
  * @text_view: a #GtkTextView
  * @iter: a #GtkTextIter
- * @trailing: 
+ * @trailing: location to store an integer indicating where
+ *    in the grapheme the user clicked. It will either be
+ *    zero, or the number of characters in the grapheme. 
+ *    0 represents the trailing edge of the grapheme.
  * @x: x position, in buffer coordinates
  * @y: y position, in buffer coordinates
  *
@@ -1316,7 +1319,7 @@ gtk_text_view_get_iter_at_location (GtkTextView *text_view,
  * those to buffer coordinates with 
  * gtk_text_view_window_to_buffer_coords().
  *
- * Note that this is diffferent from gtk_text_view_get_iter_at_location(),
+ * Note that this is different from gtk_text_view_get_iter_at_location(),
  * which returns cursor locations, i.e. positions <emphasis>between</emphasis>
  * characters.
  *
diff --git a/gtk/gtktoolbar.c b/gtk/gtktoolbar.c
index 1d38158ae7..a567357d64 100644
--- a/gtk/gtktoolbar.c
+++ b/gtk/gtktoolbar.c
@@ -3009,9 +3009,9 @@ gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
  * @toolbar: a #GtkToolbar
  * 
  * Returns whether the toolbar has an overflow menu.
- * See gtk_toolbar_set_show_arrow()
+ * See gtk_toolbar_set_show_arrow().
  * 
- * Return value: 
+ * Return value: %TRUE if the toolbar has an overflow menu.
  * 
  * Since: 2.4
  **/
diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c
index cfa94d131a..d7ccf5f67a 100644
--- a/gtk/gtktreeviewcolumn.c
+++ b/gtk/gtktreeviewcolumn.c
@@ -2119,7 +2119,7 @@ gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column)
 /**
  * gtk_tree_view_column_set_expand:
  * @tree_column: A #GtkTreeViewColumn
- * @expand: 
+ * @expand: %TRUE if the column should take available extra space, %FALSE if not
  * 
  * Sets the column to take available extra space.  This space is shared equally
  * amongst all columns that have the expand set to %TRUE.  If no column has this
@@ -2151,7 +2151,7 @@ gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column,
 
 /**
  * gtk_tree_view_column_get_expand:
- * @tree_column: 
+ * @tree_column: a #GtkTreeViewColumn
  * 
  * Return %TRUE if the column expands to take any available space.
  *