2009-02-27 Alberto Garcia <agarcia@igalia.com>

[hildon] / src / hildon-volumebar-range.c

diff --git a/src/hildon-volumebar-range.c b/src/hildon-volumebar-range.c
index 6590f6e..0999e73 100644 (file)
--- a/src/hildon-volumebar-range.c
+++ b/src/hildon-volumebar-range.c
@@ -1,14 +1,14 @@
 /*
- * This file is part of hildon-libs
+ * This file is a part of hildon
  *
  * Copyright (C) 2005, 2006 Nokia Corporation, all rights reserved.
  *
- * Contact: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
+ * Contact: Rodrigo Novo <rodrigo.novo@nokia.com>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public License
  * as published by the Free Software Foundation; version 2.1 of
- * the License.
+ * the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -22,12 +22,10 @@
  *
  */
 
-/* 
- * @file hildon-volumebar-range.c
- *
- * This file contains the implementation of the HildonVolumebarRange.
- * This widget is an "workhorse" for #HildonVolumebar widget. 
- * It is not designed to be used as a standalone widget.
+/**
+ * SECTION:hildon-volumebar-range
+ * @short_description: This widget is an "workhorse" for #HildonVolumebar
+ * widget. It is not designed to be used as a standalone widget.
  *
  * Purpose of this widget is to act as an "container" for GtkScale
  * widget. #HildonVolumebarRange changes some event parameters so
@@ -37,10 +35,10 @@
  * 
  */
 
-#include                                        "hildon-volumebar-range.h"
-#include                                        <gtk/gtkrange.h>
 #include                                        <gdk/gdkkeysyms.h>
 
+#include                                        "hildon-volumebar-range.h"
+
 #define                                         VOLUMEBAR_RANGE_INITIAL_VALUE 50.0
 
 #define                                         VOLUMEBAR_RANGE_MINIMUM_VALUE 0.0
@@ -95,6 +93,13 @@ enum
   PROP_LEVEL
 };
 
+/**
+ * hildon_volumebar_range_get_type:
+ *
+ * Initializes and returns the type of a hildon volumebar range.
+ *
+ * Returns: GType of #HildonVolumebarRange
+ */
 GType G_GNUC_CONST
 hildon_volumebar_range_get_type                 (void)
 {
@@ -137,6 +142,11 @@ hildon_volumebar_range_class_init               (HildonVolumebarRangeClass *volu
     object_class->set_property = hildon_volumebar_range_set_property;
     object_class->get_property = hildon_volumebar_range_get_property; 
 
+    /**
+     * HildonVolumebarRange:level:
+     *
+     * Current volume level. 
+     */
     g_object_class_install_property (object_class,
             PROP_LEVEL,
             g_param_spec_double ("level",
@@ -152,9 +162,7 @@ hildon_volumebar_range_class_init               (HildonVolumebarRangeClass *volu
 static void 
 hildon_volumebar_range_init                     (HildonVolumebarRange *volumerange)
 {
-    /* stepper_a = "less", stepper_d = "more" */
-    GTK_RANGE (volumerange)->has_stepper_a = TRUE;
-    GTK_RANGE (volumerange)->has_stepper_d = TRUE;
+  /* do nothing. */
 }
 
 static void