GtkWidget::draw() - Document how to get the dirty region

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

diff --git a/gtk/gtkcolorchooser.c b/gtk/gtkcolorchooser.c
index 532fcd36185214fc432d90757bc05490840564a5..cbefdd3b4a855fa008357ea2921c18c8b9995dc6 100644 (file)
--- a/gtk/gtkcolorchooser.c
+++ b/gtk/gtkcolorchooser.c
@@ -122,7 +122,7 @@ _gtk_color_chooser_color_activated (GtkColorChooser *chooser,
 /**
  * gtk_color_chooser_get_rgba:
  * @chooser: a #GtkColorChooser
- * @color: return location for the color
+ * @color: (out): a #GdkRGBA to fill in with the current color
  *
  * Gets the currently-selected color.
  *
@@ -207,7 +207,7 @@ gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,
  * @n_colors: the total number of elements in @colors
  * @colors: (allow-none) (array length=n_colors): the colors of the palette, or %NULL
  *
- * Adds a palette to the color chooser. If @horizontal is %TRUE,
+ * Adds a palette to the color chooser. If @orientation is horizontal,
  * the colors are grouped in rows, with @colors_per_line colors
  * in each row. If @horizontal is %FALSE, the colors are grouped
  * in columns instead.
@@ -219,7 +219,7 @@ gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,
  * The layout of the color chooser widget works best when the
  * palettes have 9-10 columns.
  *
- * Calling this function is called for the first time has the
+ * Calling this function for the first time has the
  * side effect of removing the default color and gray palettes
  * from the color chooser.
  *