diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 43c596e87c..65a1e4d1ac 100644
--- 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
index 368c79140c..0000000000
--- a/docs/reference/gtk/tmpl/gtkcolorsel.sgml
+++ /dev/null
@@ -1,237 +0,0 @@
-
-GtkColorSelection
-
-
-A widget used to select a color
-
-
-
-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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-The #GtkColorSelection-struct struct contains private data only,
-and should be accessed using the functions below.
-
-
-
-
-
-This signal is emitted when the color changes in the #GtkColorSelection
-according to its update policy.
-
-
-@colorselection: the object which received the signal.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@void:
-@Returns:
-
-
-
-
-
-
-
-@colorsel:
-@has_opacity:
-
-
-
-
-
-
-
-@colorsel:
-@Returns:
-
-
-
-
-
-
-
-@colorsel:
-@has_palette:
-
-
-
-
-
-
-
-@colorsel:
-@Returns:
-
-
-
-
-
-
-
-@colorsel:
-@Returns:
-
-
-
-
-
-
-
-@colorsel:
-@alpha:
-
-
-
-
-
-
-
-@colorsel:
-@color:
-
-
-
-
-
-
-
-@colorsel:
-@color:
-
-
-
-
-
-
-
-@colorsel:
-@Returns:
-
-
-
-
-
-
-
-@colorsel:
-@alpha:
-
-
-
-
-
-
-
-@colorsel:
-@color:
-
-
-
-
-
-
-
-@colorsel:
-@color:
-
-
-
-
-
-
-
-@colorsel:
-@Returns:
-
-
-
-
-
-
-
-@str:
-@colors:
-@n_colors:
-@Returns:
-
-
-
-
-
-
-
-@colors:
-@n_colors:
-@Returns:
-
-
-
-
-
-
-
-@colors:
-@n_colors:
-
-
-
-
-
-
-
-@func:
-@Returns:
-
-
-
-
-
-
-
-@screen:
-@colors:
-@n_colors:
-@Since: 2.2
-
-
diff --git a/gtk/gtkcolorsel.c b/gtk/gtkcolorsel.c
index 230cd2b416..c294266d32 100644
--- 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 43e5fd6276..7d5d85f8d0 100644
--- 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);