docs: Move documentation to inline comments: GtkColorSelection

Signed-off-by: Javier Jardón <jjardon@gnome.org>

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 43c596e87c0139c9d4b0226a7761eb99bbd0fb9a..65a1e4d1ac8aec6f72fdae599a8c3d8f8dda83aa 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -9,6 +9,7 @@ gtkbutton.sgml
 gtkcalendar.sgml
 gtkcelleditable.sgml
 gtkcolorbutton.sgml
+gtkcolorsel.sgml
 gtkcombobox.sgml
 gtkcomboboxentry.sgml
 gtkcontainer.sgml

diff --git a/docs/reference/gtk/tmpl/gtkcolorsel.sgml b/docs/reference/gtk/tmpl/gtkcolorsel.sgml
deleted file mode 100644 (file)
index 368c791..0000000
--- a/docs/reference/gtk/tmpl/gtkcolorsel.sgml
+++ /dev/null
@@ -1,237 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkColorSelection
-
-<!-- ##### SECTION Short_Description ##### -->
-A widget used to select a color
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkColorSelection is a widget that is used to select 
-a color.  It consists of a color wheel and number of sliders
-and entry boxes for color parameters such as hue, saturation,
-value, red, green, blue, and opacity.  It is found on the standard 
-color selection dialog box #GtkColorSelectionDialog.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkColorSelection ##### -->
-<para>
-The #GtkColorSelection-struct struct contains private data only, 
-and should be accessed using the functions below.
-</para>
-
-
-<!-- ##### SIGNAL GtkColorSelection::color-changed ##### -->
-<para>
-This signal is emitted when the color changes in the #GtkColorSelection
-according to its update policy.
-</para>
-
-@colorselection: the object which received the signal.
-
-<!-- ##### ARG GtkColorSelection:current-alpha ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:current-color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:has-opacity-control ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:has-palette ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_color_selection_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_has_opacity_control ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@has_opacity: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_has_opacity_control ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_has_palette ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@has_palette: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_has_palette ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_current_alpha ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_current_alpha ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@alpha: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_current_color ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_current_color ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_previous_alpha ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_previous_alpha ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@alpha: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_get_previous_color ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_previous_color ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@color: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_is_adjusting ##### -->
-<para>
-
-</para>
-
-@colorsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_palette_from_string ##### -->
-<para>
-
-</para>
-
-@str: 
-@colors: 
-@n_colors: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_palette_to_string ##### -->
-<para>
-
-</para>
-
-@colors: 
-@n_colors: 
-@Returns: 
-
-
-<!-- ##### USER_FUNCTION GtkColorSelectionChangePaletteFunc ##### -->
-<para>
-
-</para>
-
-@colors: 
-@n_colors: 
-
-
-<!-- ##### FUNCTION gtk_color_selection_set_change_palette_with_screen_hook ##### -->
-<para>
-
-</para>
-
-@func: 
-@Returns: 
-
-
-<!-- ##### USER_FUNCTION GtkColorSelectionChangePaletteWithScreenFunc ##### -->
-<para>
-
-</para>
-
-@screen: 
-@colors: 
-@n_colors: 
-@Since: 2.2
-
-

diff --git a/gtk/gtkcolorsel.c b/gtk/gtkcolorsel.c
index 230cd2b41630cfed44287b60a2946906633c654e..c294266d329d90f18308e3a970fb87d0f9fe860a 100644 (file)
--- a/gtk/gtkcolorsel.c
+++ b/gtk/gtkcolorsel.c
@@ -63,6 +63,20 @@
 #include "gtkprivate.h"
 #include "gtkintl.h"
 
+
+/**
+ * SECTION:gtkcolorsel
+ * @Short_description: A widget used to select a color
+ * @Title: GtkColorSelection
+ *
+ * The #GtkColorSelection is a widget that is used to select
+ * a color.  It consists of a color wheel and number of sliders
+ * and entry boxes for color parameters such as hue, saturation,
+ * value, red, green, blue, and opacity.  It is found on the standard
+ * color selection dialog box #GtkColorSelectionDialog.
+ */
+
+
 /* Keep it in sync with gtksettings.c:default_color_palette */
 #define DEFAULT_COLOR_PALETTE   "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"
 
@@ -349,6 +363,13 @@ gtk_color_selection_class_init (GtkColorSelectionClass *klass)
                                                        GDK_TYPE_RGBA,
                                                        GTK_PARAM_READWRITE));
 
+  /**
+   * GtkColorSelection::color-changed:
+   * @colorselection: the object which received the signal.
+   *
+   * This signal is emitted when the color changes in the #GtkColorSelection
+   * according to its update policy.
+   */
   color_selection_signals[COLOR_CHANGED] =
     g_signal_new (I_("color-changed"),
                  G_OBJECT_CLASS_TYPE (gobject_class),

diff --git a/gtk/gtkcolorsel.h b/gtk/gtkcolorsel.h
index 43e5fd6276d4c6e47a2f5cbc75967a0d6e404eb4..7d5d85f8d0fcade1c5ddcbbc5ea52a20d5696ba7 100644 (file)
--- a/gtk/gtkcolorsel.h
+++ b/gtk/gtkcolorsel.h
@@ -51,6 +51,15 @@ typedef struct _GtkColorSelectionClass  GtkColorSelectionClass;
 
 typedef void (* GtkColorSelectionChangePaletteFunc) (const GdkColor    *colors,
                                                      gint               n_colors);
+
+/**
+ * GtkColorSelectionChangePaletteWithScreenFunc:
+ * @screen:
+ * @colors:
+ * @n_colors:
+ *
+ * Since: 2.2
+ */
 typedef void (* GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen         *screen,
                                                               const GdkColor    *colors,
                                                               gint               n_colors);