Updating documentation of the HildonColorButton and correcting some formatting glitch...

diff --git a/ChangeLog.2 b/ChangeLog.2
index 1cfe558..022666c 100644 (file)
--- a/ChangeLog.2
+++ b/ChangeLog.2
@@ -1,3 +1,10 @@
+2007-02-06  Michael Dominic Kostrzewa  <michael.kostrzewa@nokia.com> 
+
+       * src/hildon-color-button.c:
+       * src/hildon-color-button.h: Updating documentation.
+
+       * src/hildon-helper.c: Correcting some formatting glitches.
+
 2007-02-06 Xan Lopez <xan.lopez@nokia.com> 
 
        * src/hildon-helper.c:

diff --git a/src/hildon-color-button.c b/src/hildon-color-button.c
index be90824..a45c678 100644 (file)
--- a/src/hildon-color-button.c
+++ b/src/hildon-color-button.c
@@ -143,6 +143,13 @@ draw_grid                                       (GdkDrawable *drawable,
 
 static gpointer                                 parent_class = NULL;
 
+/**
+ * hildon_color_button_get_type:
+ *
+ * Initializes and returns the type of a hildon color button.
+ *
+ * @Returns: GType of #HildonColorButton.
+ */
 GType G_GNUC_CONST
 hildon_color_button_get_type                    (void)
 {

diff --git a/src/hildon-color-button.h b/src/hildon-color-button.h
index 5cada9f..6895f5e 100644 (file)
--- a/src/hildon-color-button.h
+++ b/src/hildon-color-button.h
@@ -75,7 +75,8 @@ GtkWidget*
 hildon_color_button_new_with_color              (const GdkColor *color);
 
 void
-hildon_color_button_get_color                   (HildonColorButton *button, GdkColor *color);
+hildon_color_button_get_color                   (HildonColorButton *button, 
+                                                 GdkColor *color);
 
 void
 hildon_color_button_set_color                   (HildonColorButton *button,         

diff --git a/src/hildon-helper.c b/src/hildon-helper.c
index 2b5d2c5..25a7852 100644 (file)
--- a/src/hildon-helper.c
+++ b/src/hildon-helper.c
@@ -235,29 +235,29 @@ hildon_helper_set_logical_font                  (GtkWidget *widget,
 }
 
 static GQuark
-hildon_helper_insensitive_message_quark (void)
+hildon_helper_insensitive_message_quark         (void)
 {
-  static GQuark quark = 0;
+    static GQuark quark = 0;
 
-  if (G_UNLIKELY (quark == 0))
-    quark = g_quark_from_static_string ("hildon-insensitive-message");
+    if (G_UNLIKELY (quark == 0))
+        quark = g_quark_from_static_string ("hildon-insensitive-message");
 
-  return quark;
+    return quark;
 }
 
-
 static void
-show_insensitive_message (GtkWidget *widget, gpointer user_data)
+show_insensitive_message                        (GtkWidget *widget, 
+                                                 gpointer user_data)
 {
-  gchar *message = NULL;
+    gchar *message = NULL;
 
-  g_assert (GTK_IS_WIDGET (widget));
+    g_assert (GTK_IS_WIDGET (widget));
 
-  message = (gchar*) g_object_get_qdata (G_OBJECT (widget),
-                                        hildon_helper_insensitive_message_quark ());
+    message = (gchar*) g_object_get_qdata (G_OBJECT (widget),
+            hildon_helper_insensitive_message_quark ());
 
-  if (message)
-    hildon_banner_show_information (widget, NULL, message);
+    if (message)
+        hildon_banner_show_information (widget, NULL, message);
 }
 
 
@@ -313,22 +313,22 @@ hildon_helper_set_insensitive_message           (GtkWidget *widget,
  **/
 
 void
-hildon_helper_set_insensitive_messagef        (GtkWidget *widget,
-                                              const gchar *format,
-                                              ...)
+hildon_helper_set_insensitive_messagef          (GtkWidget *widget,
+                                                 const gchar *format,
+                                                 ...)
 {
-  g_return_if_fail (GTK_IS_WIDGET (widget));
+    g_return_if_fail (GTK_IS_WIDGET (widget));
 
-  gchar *message;
-  va_list args;
+    gchar *message;
+    va_list args;
 
-  va_start (args, format);
-  message = g_strdup_vprintf (format, args);
-  va_end (args);
+    va_start (args, format);
+    message = g_strdup_vprintf (format, args);
+    va_end (args);
 
-  hildon_helper_set_insensitive_message (widget, message);
+    hildon_helper_set_insensitive_message (widget, message);
 
-  g_free (message);
+    g_free (message);
 }
 
 /**