Fixing documentation in HildonColorChooser and HildonColorChooserDialog.

diff --git a/ChangeLog.2 b/ChangeLog.2
index e8937b9..9b80805 100644 (file)
--- a/ChangeLog.2
+++ b/ChangeLog.2
@@ -1,5 +1,10 @@
 2007-01-31  Michael Dominic Kostrzewa  <michael.kostrzewa@nokia.com> 
 
+       * src/hildon-color-chooser-dialog.c:
+       * src/hildon-color-chooser.c: Adding some documentation.
+
+2007-01-31  Michael Dominic Kostrzewa  <michael.kostrzewa@nokia.com> 
+
        * configure.ac:
        * pkgconfig/hildon.pc.in:
        * src/hildon-seekbar.c: Xan's fixes for new gtk compilation.

diff --git a/src/hildon-color-chooser-dialog.c b/src/hildon-color-chooser-dialog.c
index c34b913..bd3589c 100644 (file)
--- a/src/hildon-color-chooser-dialog.c
+++ b/src/hildon-color-chooser-dialog.c
@@ -23,6 +23,22 @@
  *
  */
 
+/**
+ * SECTION:hildon-color-chooser-dialog
+ * @short_description: A dialog used to select a color from HSV colorspace
+ * @see_also: #HildonColorButton
+ *
+ * HildonColorChooserDialog enables the user to 
+ * select an arbitrary color from a HSV colorspace.
+ * The color is stored in one of the predefined color 
+ * slots and can be reselected later on. 
+ *
+ * Additionally the user can choose one of the standard "factory"
+ * colors.
+ *
+ */
+
+
 #ifdef                                          HAVE_CONFIG_H
 #include                                        <config.h>
 #endif

diff --git a/src/hildon-color-chooser.c b/src/hildon-color-chooser.c
index 2e66cb8..436cd6b 100644 (file)
--- a/src/hildon-color-chooser.c
+++ b/src/hildon-color-chooser.c
@@ -23,6 +23,20 @@
  *
  */
 
+/**
+ * SECTION:hildon-color-chooser
+ * @short_description: A widget used to select a color from an HSV colorspace
+ * @see_also: #HildonColorChooserDialog
+ *
+ * HildonColorChooser is a widget that displays an HSV colorspace. 
+ * The user can manipulate the colorspace and easily select and shade of any color
+ * he wants. 
+ *
+ * Normally you should not need to use this widget directly. Using #HildonColorButton or
+ * #HildonColorChooserDialog is much more handy. 
+ * 
+ */
+
 #include                                        <gtk/gtk.h>
 #include                                        "hildon-color-chooser.h"
 #include                                        "hildon-color-chooser-private.h"