Minor documentation improvements

[~andy/gtk] / gtk / gtkmenu.c

diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c
index d363009ac472b893bb2800f639e913a4341d8d6c..94ba3cd1080866ac861a5bd9e3942ff933699fc4 100644 (file)
--- a/gtk/gtkmenu.c
+++ b/gtk/gtkmenu.c
@@ -1987,12 +1987,12 @@ gtk_menu_set_accel_group (GtkMenu       *menu,
 
 /**
  * gtk_menu_get_accel_group:
- * @menu a #GtkMenu
+ * @menu: a #GtkMenu
  *
  * Gets the #GtkAccelGroup which holds global accelerators for the
- * menu.  See gtk_menu_set_accel_group().
+ * menu. See gtk_menu_set_accel_group().
  *
- * Returns: (transfer none): the #GtkAccelGroup associated with the menu.
+ * Returns: (transfer none): the #GtkAccelGroup associated with the menu
  */
 GtkAccelGroup*
 gtk_menu_get_accel_group (GtkMenu *menu)
@@ -2418,8 +2418,11 @@ gtk_menu_get_title (GtkMenu *menu)
  * gtk_menu_reorder_child:
  * @menu: a #GtkMenu
  * @child: the #GtkMenuItem to move
- * @position: the new position to place @child.  Positions are
- *            numbered from 0 to n-1.
+ * @position: the new position to place @child.
+ *     Positions are numbered from 0 to n - 1
+ *
+ * Moves @child to a new @position in the list of @menu
+ * children.
  */
 void
 gtk_menu_reorder_child (GtkMenu   *menu,
@@ -5124,7 +5127,7 @@ compute_child_offset (GtkMenu   *menu,
   if (!priv->heights || priv->heights_length < gtk_menu_get_n_rows (menu))
     return FALSE;
 
-  /* when we have a row with only invisible children, it's height will
+  /* when we have a row with only invisible children, its height will
    * be zero, so there's no need to check WIDGET_VISIBLE here
    */
   for (i = 0; i < item_top_attach; i++)