Cleaning up the documentation.

diff --git a/ChangeLog.2 b/ChangeLog.2
index 456fa6f..8962bc9 100644 (file)
--- a/ChangeLog.2
+++ b/ChangeLog.2
@@ -1,5 +1,13 @@
 2007-01-24  Michael Dominic Kostrzewa  <michael.kostrzewa@nokia.com> 
 
+       * src/hildon-program.c:
+       * src/hildon-program.h:
+       * src/hildon-range-editor.c:
+       * src/hildon-seekbar.c:
+       * src/hildon-set-password-dialog.c: Cleaing up the documentation.
+
+2007-01-24  Michael Dominic Kostrzewa  <michael.kostrzewa@nokia.com> 
+
        * src/hildon-get-password-dialog.c:
        * src/hildon-helper.c:
        * src/hildon-hvolumebar.c:

diff --git a/src/hildon-program.c b/src/hildon-program.c
index b204166..66eb8ce 100644 (file)
--- a/src/hildon-program.c
+++ b/src/hildon-program.c
@@ -22,11 +22,12 @@
  *
  */
 
-/*
- * @file hildon-program.c
- *
- * This file implements the HildonProgram object
+/**
+ * SECTION:hildon-program
+ * @short_description: An object used to control a hildon program.
  *
+ * HildonProgram is not a widget itself nor a container. HildonProgram can 
+ * contain one or more @HildonWindow. 
  */
 
 #ifdef                                          HAVE_CONFIG_H
@@ -65,7 +66,7 @@ enum
     PROP_KILLABLE
 };
 
-GType
+GType G_GNUC_CONST
 hildon_program_get_type                         (void)
 {
     static GType program_type = 0;
@@ -138,6 +139,13 @@ hildon_program_class_init                       (HildonProgramClass *self)
     object_class->get_property  = hildon_program_get_property;
 
     /* Install properties */
+
+    /**
+     * HildonProgram:is-topmost:
+     *
+     * Whether one of the program's window or dialog currently
+     * is activated by window manager. 
+     */
     g_object_class_install_property (object_class, PROP_IS_TOPMOST,
                 g_param_spec_boolean ("is-topmost",
                 "Is top-most",
@@ -145,7 +153,13 @@ hildon_program_class_init                       (HildonProgramClass *self)
                 "is activated by window manager",
                 FALSE,
                 G_PARAM_READABLE)); 
-    
+
+    /**
+     * HildonProgram:can-hibernate:
+     *
+     * Whether the program should be set to hibernate by the Task
+     * Navigator in low memory situation.
+     */
     g_object_class_install_property (object_class, PROP_KILLABLE,
                 g_param_spec_boolean ("can-hibernate",
                 "Can hibernate",

diff --git a/src/hildon-program.h b/src/hildon-program.h
index d341f0e..907bc90 100644 (file)
--- a/src/hildon-program.h
+++ b/src/hildon-program.h
@@ -70,7 +70,7 @@ struct                                          _HildonProgramClass
     void (*_hildon_reserved4)(void);
 };
 
-GType
+GType G_GNUC_CONST
 hildon_program_get_type                         (void);
 
 HildonProgram*

diff --git a/src/hildon-range-editor.c b/src/hildon-range-editor.c
index f47ba97..a9e66be 100644 (file)
--- a/src/hildon-range-editor.c
+++ b/src/hildon-range-editor.c
@@ -789,8 +789,6 @@ hildon_range_editor_refresh_widths              (HildonRangeEditorPrivate *priv)
     gtk_entry_set_max_length (GTK_ENTRY (priv->end_entry), length);
 }
 
-/* Public functions */
-
 /**
  * hildon_range_editor_get_type:
  * 
@@ -799,7 +797,7 @@ hildon_range_editor_refresh_widths              (HildonRangeEditorPrivate *priv)
  * @Returns : GType of #HildonRangeEditor
  * 
  */
-GType
+GType G_GNUC_CONST
 hildon_range_editor_get_type                    (void)
 {
     static GType editor_type = 0;

diff --git a/src/hildon-seekbar.c b/src/hildon-seekbar.c
index 07ea306..9182a49 100644 (file)
--- a/src/hildon-seekbar.c
+++ b/src/hildon-seekbar.c
@@ -131,7 +131,12 @@ enum
 };
 
 /**
- * Initialises, and returns the type of a hildon seekbar.
+ * hildon_seekbar_get_type:
+ * 
+ * Initializes, and returns the type of a hildon seekbar.
+ * 
+ * @Returns : GType of #HildonSeekbar
+ * 
  */
 GType G_GNUC_CONST 
 hildon_seekbar_get_type                         (void)
@@ -181,8 +186,13 @@ hildon_seekbar_class_init                       (HildonSeekbarClass *seekbar_cla
     object_class->set_property          = hildon_seekbar_set_property;
     object_class->get_property          = hildon_seekbar_get_property;
 
+    /**
+     * HildonSeekbar:total-time:
+     *
+     * Total playing time of this media file.
+     */
     g_object_class_install_property (object_class, PROP_TOTAL_TIME,
-            g_param_spec_double ("total_time",
+            g_param_spec_double ("total-time",
                 "total time",
                 "Total playing time of this media file",
                 0,           /* min value */
@@ -190,6 +200,11 @@ hildon_seekbar_class_init                       (HildonSeekbarClass *seekbar_cla
                 0,           /* default */
                 G_PARAM_READWRITE));
 
+    /**
+     * HildonSeekbar:position:
+     *
+     * Current position in this media file.
+     */
     g_object_class_install_property (object_class, PROP_POSITION,
             g_param_spec_double ("position",
                 "position",
@@ -199,6 +214,11 @@ hildon_seekbar_class_init                       (HildonSeekbarClass *seekbar_cla
                 0,           /* default */
                 G_PARAM_READWRITE));
 
+    /**
+     * HildonSeekbar:fraction:
+     *
+     * Current fraction related to the progress indicator.
+     */
     g_object_class_install_property (object_class, PROP_FRACTION,
             g_param_spec_double ("fraction",
                 "Fraction",

diff --git a/src/hildon-set-password-dialog.c b/src/hildon-set-password-dialog.c
index 29e74c5..5a4ec4c 100644 (file)
--- a/src/hildon-set-password-dialog.c
+++ b/src/hildon-set-password-dialog.c
@@ -345,15 +345,25 @@ hildon_set_password_dialog_class_init           (HildonSetPasswordDialogClass *c
                 NULL,
                 G_PARAM_READWRITE));
 
+    /**
+     * HildonSetPasswordDialog:modify-protection:
+     *
+     * Password type.
+     */
     g_object_class_install_property (object_class, 
             PROP_HILDON_PASSWORD_DIALOG, 
-            g_param_spec_boolean ("modify_protection",
+            g_param_spec_boolean ("modify-protection",
                 "Password type",
                 "Set type to dialog",
                 TRUE, 
                 G_PARAM_CONSTRUCT_ONLY |
                 G_PARAM_READWRITE));
 
+    /**
+     * HildonSetPasswordDialog:password:
+     *
+     * Content of the password field.
+     */
     g_object_class_install_property (object_class, 
             PROP_PASSWORD, 
             g_param_spec_string ("password",