From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 23 Dec 2019 18:36:32 +0000 (-0500)
Subject: colorchooser: Document actions
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~20^2~517
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=519ff576cd79fadcf33bcd53ee9e251bc9e8bb23;p=gtk4.git

colorchooser: Document actions

This is mainly a trial balloon for gtk-doc
support for this syntax.

See https://gitlab.gnome.org/GNOME/gtk-doc/merge_requests/30
---

diff --git a/gtk/gtkcolorchooserwidget.c b/gtk/gtkcolorchooserwidget.c
index 17131ef199..526726fce7 100644
--- a/gtk/gtkcolorchooserwidget.c
+++ b/gtk/gtkcolorchooserwidget.c
@@ -708,8 +708,28 @@ gtk_color_chooser_widget_class_init (GtkColorChooserWidgetClass *class)
   gtk_widget_class_set_css_name (widget_class, I_("colorchooser"));
   gtk_widget_class_set_layout_manager_type (widget_class, GTK_TYPE_BOX_LAYOUT);
 
+  /**
+   * GtkColorChooserWidget|color.select:
+   * @red: the red value, between 0 and 1
+   * @green: the green value, between 0 and 1
+   * @blue: the blue value, between 0 and 1
+   * @alpha: the alpha value, between 0 and 1
+   *
+   * Emits the #GtkColorChooser::color-activated signal for
+   * the given color.
+   */
   gtk_widget_class_install_action (widget_class, "color.select", "(dddd)",
                                    gtk_color_chooser_widget_activate_color_select);
+
+  /**
+   * GtkColorChooserWidget|color.customize:
+   * @red: the red value, between 0 and 1
+   * @green: the green value, between 0 and 1
+   * @blue: the blue value, between 0 and 1
+   * @alpha: the alpha value, between 0 and 1
+   *
+   * Activates the color editor for the given color.
+   */
   gtk_widget_class_install_action (widget_class, "color.customize", "(dddd)",
                                    gtk_color_chooser_widget_activate_color_customize);
 }