2008-09-30 Alejandro Pinheiro <apinheiro@igalia.com>
authorAlejandro Piñeiro <apinheiro@igalia.com>
Tue, 30 Sep 2008 17:48:31 +0000 (17:48 +0000)
committerAlejandro Piñeiro <apinheiro@igalia.com>
Tue, 30 Sep 2008 17:48:31 +0000 (17:48 +0000)
* src/hildon-time-selector.c
  (hildon_time_selector_get_time)
  (hildon_time_selector_set_time)
  Added documentation of these public methods

* src/hildon-date-button.h
* src/hildon-touch-selector-column.h
* src/hildon-time-button.h
* src/hildon-picker-dialog.h
* src/hildon-time-selector.h
* src/hildon-picker-button.h
* src/hildon-touch-selector.h
* src/hildon-time-picker.h
* src/hildon-date-selector.h
* src/hildon-touch-selector-entry.h
Modified in order to use hildon-widgets code style

12 files changed:
ChangeLog
src/hildon-date-button.h
src/hildon-date-selector.h
src/hildon-picker-button.h
src/hildon-picker-dialog.h
src/hildon-time-button.h
src/hildon-time-picker.h
src/hildon-time-selector.c
src/hildon-time-selector.h
src/hildon-touch-selector-column.h
src/hildon-touch-selector-entry.h
src/hildon-touch-selector.h

index 3768caf..df6a8b1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2008-09-30  Alejandro Pinheiro <apinheiro@igalia.com>
+
+       * src/hildon-time-selector.c
+       (hildon_time_selector_get_time)
+       (hildon_time_selector_set_time)
+       Added documentation of these public methods
+
+       * src/hildon-date-button.h
+       * src/hildon-touch-selector-column.h
+       * src/hildon-time-button.h
+       * src/hildon-picker-dialog.h
+       * src/hildon-time-selector.h
+       * src/hildon-picker-button.h
+       * src/hildon-touch-selector.h
+       * src/hildon-time-picker.h
+       * src/hildon-date-selector.h
+       * src/hildon-touch-selector-entry.h
+       Modified in order to use hildon-widgets code style
+
 2008-09-30  Alejandro G. Castro         <alex@igalia.com>
 
        Added deprecated support to the compilation process using
index 39fdda5..c409f49 100644 (file)
  *
  */
 
-#ifndef _HILDON_DATE_BUTTON
-#define _HILDON_DATE_BUTTON
+#ifndef                                         __HILDON_DATE_BUTTON__
+#define                                         __HILDON_DATE_BUTTON__
 
-#include <gtk/gtk.h>
+#include                                        <gtk/gtk.h>
 
-#include "hildon-picker-button.h"
+#include                                        "hildon-picker-button.h"
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_DATE_BUTTON            hildon_date_button_get_type()
-#define HILDON_DATE_BUTTON(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_DATE_BUTTON, HildonDateButton))
-#define HILDON_DATE_BUTTON_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), HILDON_TYPE_DATE_BUTTON, HildonDateButtonClass))
-#define HILDON_IS_DATE_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_DATE_BUTTON))
-#define HILDON_IS_DATE_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_DATE_BUTTON))
-#define HILDON_DATE_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), HILDON_TYPE_DATE_BUTTON, HildonDateButtonClass))
+#define                                         HILDON_TYPE_DATE_BUTTON \
+                                                hildon_date_button_get_type()
 
-typedef struct _HildonDateButton      HildonDateButton;
-typedef struct _HildonDateButtonClass HildonDateButtonClass;
+#define                                         HILDON_DATE_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj),\
+                                                 HILDON_TYPE_DATE_BUTTON, HildonDateButton))
 
-struct _HildonDateButton
+#define                                         HILDON_DATE_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((klass), \
+                                                HILDON_TYPE_DATE_BUTTON, HildonDateButtonClass))
+
+#define                                         HILDON_IS_DATE_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_DATE_BUTTON))
+
+#define                                         HILDON_IS_DATE_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_DATE_BUTTON))
+
+#define                                         HILDON_DATE_BUTTON_GET_CLASS(obj) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+                                                HILDON_TYPE_DATE_BUTTON, HildonDateButtonClass))
+
+
+typedef struct                                  _HildonDateButton HildonDateButton;
+typedef struct                                  _HildonDateButtonClass HildonDateButtonClass;
+
+struct                                          _HildonDateButton
 {
   HildonPickerButton parent;
 };
 
-struct _HildonDateButtonClass
+struct                                          _HildonDateButtonClass
 {
   HildonPickerButtonClass parent_class;
 };
 
-GType      hildon_date_button_get_type (void);
-GtkWidget *hildon_date_button_new      (HildonSizeType          size,
-                                        HildonButtonArrangement arrangement);
+GType
+hildon_date_button_get_type                     (void);
+
+GtkWidget*
+hildon_date_button_new                          (HildonSizeType          size,
+                                                 HildonButtonArrangement arrangement);
 
-void hildon_date_button_get_date       (HildonDateButton * button,
-                                        guint * year, guint * month, guint * day);
-void hildon_date_button_set_date       (HildonDateButton * button,
-                                        guint year, guint month, guint day);
+void
+hildon_date_button_get_date                     (HildonDateButton *button,
+                                                 guint *year,
+                                                 guint *month,
+                                                 guint *day);
+void
+hildon_date_button_set_date                     (HildonDateButton * button,
+                                                 guint year,
+                                                 guint month,
+                                                 guint day);
 
 G_END_DECLS
 
-#endif /* _HILDON_DATE_BUTTON */
+#endif /* __HILDON_DATE_BUTTON__ */
index 8812a95..192d21c 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef __HILDON_DATE_SELECTOR_H__
-#define __HILDON_DATE_SELECTOR_H__
+#ifndef                                         __HILDON_DATE_SELECTOR_H__
+#define                                         __HILDON_DATE_SELECTOR_H__
 
-#include "hildon-touch-selector.h"
+#include                                        "hildon-touch-selector.h"
 
 G_BEGIN_DECLS
-#define HILDON_TYPE_DATE_SELECTOR             (hildon_date_selector_get_type ())
-#define HILDON_DATE_SELECTOR(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_DATE_SELECTOR, HildonDateSelector))
-#define HILDON_DATE_SELECTOR_CLASS(vtable)    (G_TYPE_CHECK_CLASS_CAST ((vtable), HILDON_TYPE_DATE_SELECTOR, HildonDateSelectorClass))
-#define HILDON_IS_DATE_SELECTOR(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_DATE_SELECTOR))
-#define HILDON_IS_DATE_SELECTOR_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_DATE_SELECTOR))
-#define HILDON_DATE_SELECTOR_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), HILDON_TYPE_DATE_SELECTOR, HildonDateSelectorClass))
-
-typedef struct _HildonDateSelector HildonDateSelector;
-typedef struct _HildonDateSelectorClass HildonDateSelectorClass;
-typedef struct _HildonDateSelectorPrivate HildonDateSelectorPrivate;
-
-struct _HildonDateSelector
+#define                                         HILDON_TYPE_DATE_SELECTOR \
+                                                (hildon_date_selector_get_type ())
+
+#define                                         HILDON_DATE_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_DATE_SELECTOR, HildonDateSelector))
+
+#define                                         HILDON_DATE_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((vtable), \
+                                                HILDON_TYPE_DATE_SELECTOR, HildonDateSelectorClass))
+
+#define                                         HILDON_IS_DATE_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_DATE_SELECTOR))
+
+#define                                         HILDON_IS_DATE_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_DATE_SELECTOR))
+
+#define                                         HILDON_DATE_SELECTOR_GET_CLASS(inst) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((inst), \
+                                                HILDON_TYPE_DATE_SELECTOR, HildonDateSelectorClass))
+
+typedef struct                                  _HildonDateSelector HildonDateSelector;
+typedef struct                                  _HildonDateSelectorClass HildonDateSelectorClass;
+typedef struct                                  _HildonDateSelectorPrivate HildonDateSelectorPrivate;
+
+struct                                          _HildonDateSelector
 {
   HildonTouchSelector parent_instance;
 
@@ -43,7 +57,7 @@ struct _HildonDateSelector
   HildonDateSelectorPrivate *priv;
 };
 
-struct _HildonDateSelectorClass
+struct                                          _HildonDateSelectorClass
 {
   HildonTouchSelectorClass parent_class;
 
@@ -52,18 +66,33 @@ struct _HildonDateSelectorClass
 
 
 /* construction */
-GType       hildon_date_selector_get_type         (void) G_GNUC_CONST;
-GtkWidget * hildon_date_selector_new              (void);
+GType G_GNUC_CONST
+hildon_date_selector_get_type                   (void);
+
+GtkWidget*
+hildon_date_selector_new                        (void);
 
 /* date management */
-gboolean hildon_date_selector_select_month        (HildonDateSelector * selector,
-                                                   guint month, guint year);
-void     hildon_date_selector_select_day          (HildonDateSelector * selector, guint day);
-
-gboolean hildon_date_selector_select_current_date (HildonDateSelector * selector,
-                                                   guint year, guint month, guint day);
-void     hildon_date_selector_get_date            (HildonDateSelector * selector,
-                                                   guint * year, guint * month, guint * day);
+gboolean
+hildon_date_selector_select_month               (HildonDateSelector *selector,
+                                                 guint               month,
+                                                 guint               year);
+
+void
+hildon_date_selector_select_day                 (HildonDateSelector *selector,
+                                                 guint               day);
+
+gboolean
+hildon_date_selector_select_current_date        (HildonDateSelector *selector,
+                                                 guint               year,
+                                                 guint               month,
+                                                 guint               day);
+
+void
+hildon_date_selector_get_date                   (HildonDateSelector *selector,
+                                                 guint              *year,
+                                                 guint              *month,
+                                                 guint              *day);
 
 G_END_DECLS
 
index 9da7a3c..0f48b09 100644 (file)
  *
  */
 
-#ifndef _HILDON_PICKER_BUTTON
-#define _HILDON_PICKER_BUTTON
+#ifndef                                         __HILDON_PICKER_BUTTON__
+#define                                         __HILDON_PICKER_BUTTON__
 
-#include <glib-object.h>
+#include                                        <glib-object.h>
 
-#include "hildon-button.h"
-#include "hildon-touch-selector.h"
+#include                                        "hildon-button.h"
+#include                                        "hildon-touch-selector.h"
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_PICKER_BUTTON            hildon_picker_button_get_type()
-#define HILDON_PICKER_BUTTON(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_PICKER_BUTTON, HildonPickerButton))
-#define HILDON_PICKER_BUTTON_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), HILDON_TYPE_PICKER_BUTTON, HildonPickerButtonClass))
-#define HILDON_IS_PICKER_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_PICKER_BUTTON))
-#define HILDON_IS_PICKER_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_PICKER_BUTTON))
-#define HILDON_PICKER_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), HILDON_TYPE_PICKER_BUTTON, HildonPickerButtonClass))
+#define                                         HILDON_TYPE_PICKER_BUTTON \
+                                                hildon_picker_button_get_type()
 
-typedef struct _HildonPickerButton HildonPickerButton;
-typedef struct _HildonPickerButtonClass HildonPickerButtonClass;
+#define                                         HILDON_PICKER_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_PICKER_BUTTON, HildonPickerButton))
 
-struct _HildonPickerButton
+#define                                         HILDON_PICKER_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((klass), \
+                                                HILDON_TYPE_PICKER_BUTTON, HildonPickerButtonClass))
+
+#define                                         HILDON_IS_PICKER_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_PICKER_BUTTON))
+
+#define                                         HILDON_IS_PICKER_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_PICKER_BUTTON))
+
+#define                                         HILDON_PICKER_BUTTON_GET_CLASS(obj) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+                                                HILDON_TYPE_PICKER_BUTTON, HildonPickerButtonClass))
+
+typedef struct                                  _HildonPickerButton HildonPickerButton;
+typedef struct                                  _HildonPickerButtonClass HildonPickerButtonClass;
+
+struct                                          _HildonPickerButton
 {
   HildonButton parent;
 };
 
-struct _HildonPickerButtonClass
+struct                                          _HildonPickerButtonClass
 {
   HildonButtonClass parent_class;
 };
 
-GType      hildon_picker_button_get_type (void);
-GtkWidget *hildon_picker_button_new      (HildonSizeType          size,
-                                          HildonButtonArrangement arrangement);
+GType
+hildon_picker_button_get_type                   (void);
+
+GtkWidget*
+hildon_picker_button_new                        (HildonSizeType          size,
+                                                 HildonButtonArrangement arrangement);
+
+void
+hildon_picker_button_set_selector               (HildonPickerButton * button,
+                                                 HildonTouchSelector *selector);
+
+HildonTouchSelector*
+hildon_picker_button_get_selector               (HildonPickerButton *button);
+
+void
+hildon_picker_button_set_active                 (HildonPickerButton * button,
+                                                 gint index);
 
-void hildon_picker_button_set_selector     (HildonPickerButton * button,
-                                            HildonTouchSelector * selector);
-HildonTouchSelector *hildon_picker_button_get_selector (HildonPickerButton * button);
-void hildon_picker_button_set_active       (HildonPickerButton * button,
-                                            gint index);
-gint hildon_picker_button_get_active       (HildonPickerButton * button);
+gint
+hildon_picker_button_get_active                 (HildonPickerButton * button);
 
 G_END_DECLS
 
-#endif /* _HILDON_PICKER_BUTTON */
+#endif /* __HILDON_PICKER_BUTTON__ */
index e108f7d..e0db446 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef __HILDON_PICKER_DIALOG_H__
-#define __HILDON_PICKER_DIALOG_H__
+#ifndef                                         __HILDON_PICKER_DIALOG_H__
+#define                                         __HILDON_PICKER_DIALOG_H__
 
-#include <gtk/gtk.h>
+#include                                        <gtk/gtk.h>
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_PICKER_DIALOG             (hildon_picker_dialog_get_type ())
-#define HILDON_PICKER_DIALOG(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_PICKER_DIALOG, HildonPickerDialog))
-#define HILDON_PICKER_DIALOG_CLASS(vtable)    (G_TYPE_CHECK_CLASS_CAST ((vtable), HILDON_TYPE_PICKER_DIALOG, HildonPickerDialogClass))
-#define HILDON_IS_PICKER_DIALOG(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_PICKER_DIALOG))
-#define HILDON_IS_PICKER_DIALOG_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_PICKER_DIALOG))
-#define HILDON_PICKER_DIALOG_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), HILDON_TYPE_PICKER_DIALOG, HildonPickerDialogClass))
+#define                                         HILDON_TYPE_PICKER_DIALOG \
+                                                (hildon_picker_dialog_get_type ())
 
-typedef struct _HildonPickerDialog HildonPickerDialog;
-typedef struct _HildonPickerDialogClass HildonPickerDialogClass;
-typedef struct _HildonPickerDialogPrivate HildonPickerDialogPrivate;
+#define                                         HILDON_PICKER_DIALOG(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_PICKER_DIALOG, HildonPickerDialog))
 
-struct _HildonPickerDialog
+#define                                         HILDON_PICKER_DIALOG_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((vtable), \
+                                                HILDON_TYPE_PICKER_DIALOG, HildonPickerDialogClass))
+
+#define                                         HILDON_IS_PICKER_DIALOG(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_PICKER_DIALOG))
+
+#define                                         HILDON_IS_PICKER_DIALOG_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_PICKER_DIALOG))
+
+#define                                         HILDON_PICKER_DIALOG_GET_CLASS(inst) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((inst), \
+                                                HILDON_TYPE_PICKER_DIALOG, HildonPickerDialogClass))
+
+typedef struct                                  _HildonPickerDialog HildonPickerDialog;
+typedef struct                                  _HildonPickerDialogClass HildonPickerDialogClass;
+typedef struct                                  _HildonPickerDialogPrivate HildonPickerDialogPrivate;
+
+struct                                          _HildonPickerDialog
 {
   GtkDialog parent_instance;
 
@@ -44,25 +58,35 @@ struct _HildonPickerDialog
   HildonPickerDialogPrivate *priv;
 };
 
-struct _HildonPickerDialogClass
+struct                                          _HildonPickerDialogClass
 {
   GtkDialogClass parent_class;
 
-  gboolean (* set_selector) (HildonPickerDialog * dialog,
-                             HildonTouchSelector * selector);
+  gboolean (* set_selector)                     (HildonPickerDialog  *dialog,
+                                                 HildonTouchSelector *selector);
 };
 
 /* construction */
-GType                hildon_picker_dialog_get_type         (void) G_GNUC_CONST;
-GtkWidget           *hildon_picker_dialog_new              (GtkWindow * parent);
+GType G_GNUC_CONST
+hildon_picker_dialog_get_type                   (void);
+
+GtkWidget*
+hildon_picker_dialog_new                        (GtkWindow * parent);
+
+gboolean
+hildon_picker_dialog_set_selector               (HildonPickerDialog  *dialog,
+                                                 HildonTouchSelector *selector);
+
+void
+hildon_picker_dialog_set_done_label             (HildonPickerDialog *dialog,
+                                                 const gchar        *label);
+
+const gchar*
+hildon_picker_dialog_get_done_label             (HildonPickerDialog *dialog);
 
-gboolean             hildon_picker_dialog_set_selector     (HildonPickerDialog * dialog,
-                                                            HildonTouchSelector * selector);
-void                 hildon_picker_dialog_set_done_label   (HildonPickerDialog * dialog,
-                                                            const gchar * label);
-const gchar         *hildon_picker_dialog_get_done_label   (HildonPickerDialog * dialog);
-HildonTouchSelector *hildon_picker_dialog_get_selector     (HildonPickerDialog * dialog);
+HildonTouchSelector*
+hildon_picker_dialog_get_selector               (HildonPickerDialog *dialog);
 
 G_END_DECLS
 
-#endif /* __HILDON_SELECTOR_H__ */
+#endif /* __HILDON_PICKER_SELECTOR_H__ */
index dbe5a8d..c0ee193 100644 (file)
  *
  */
 
-#ifndef _HILDON_TIME_BUTTON
-#define _HILDON_TIME_BUTTON
+#ifndef                                         __HILDON_TIME_BUTTON__
+#define                                         __HILDON_TIME_BUTTON__
 
-#include <glib-object.h>
+#include                                        <glib-object.h>
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_TIME_BUTTON            hildon_time_button_get_type()
-#define HILDON_TIME_BUTTON(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_TIME_BUTTON, HildonTimeButton))
-#define HILDON_TIME_BUTTON_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), HILDON_TYPE_TIME_BUTTON, HildonTimeButtonClass))
-#define HILDON_IS_TIME_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TIME_BUTTON))
-#define HILDON_IS_TIME_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_TIME_BUTTON))
-#define HILDON_TIME_BUTTON_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), HILDON_TYPE_TIME_BUTTON, HildonTimeButtonClass))
+#define                                         HILDON_TYPE_TIME_BUTTON \
+                                                hildon_time_button_get_type()
 
-typedef struct _HildonTimeButton      HildonTimeButton;
-typedef struct _HildonTimeButtonClass HildonTimeButtonClass;
+#define                                         HILDON_TIME_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj),\
+                                                HILDON_TYPE_TIME_BUTTON, HildonTimeButton))
 
-struct _HildonTimeButton
+#define                                         HILDON_TIME_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((klass), \
+                                                HILDON_TYPE_TIME_BUTTON, HildonTimeButtonClass))
+
+#define                                         HILDON_IS_TIME_BUTTON(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TIME_BUTTON))
+
+#define                                         HILDON_IS_TIME_BUTTON_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_TIME_BUTTON))
+
+#define                                         HILDON_TIME_BUTTON_GET_CLASS(obj) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+                                                HILDON_TYPE_TIME_BUTTON, HildonTimeButtonClass))
+
+typedef struct                                  _HildonTimeButton HildonTimeButton;
+typedef struct                                  _HildonTimeButtonClass HildonTimeButtonClass;
+
+struct                                          _HildonTimeButton
 {
   HildonPickerButton parent;
 };
 
-struct _HildonTimeButtonClass
+struct                                          _HildonTimeButtonClass
 {
   HildonPickerButtonClass parent_class;
 };
 
-GType      hildon_time_button_get_type (void);
-GtkWidget *hildon_time_button_new      (HildonSizeType          size,
-                                        HildonButtonArrangement arrangement);
+GType
+hildon_time_button_get_type                     (void);
+
+GtkWidget*
+hildon_time_button_new                          (HildonSizeType         size,
+                                                HildonButtonArrangement arrangement);
+
+void
+hildon_time_button_get_time                     (HildonTimeButton *button,
+                                                 guint            *hours,
+                                                 guint            *minutes);
 
-void hildon_time_button_get_time       (HildonTimeButton * button,
-                                        guint * hours, guint * minutes);
-void hildon_time_button_set_time       (HildonTimeButton * button,
-                                        guint hours, guint minutes);
+void
+hildon_time_button_set_time                     (HildonTimeButton *button,
+                                                 guint             hours,
+                                                 guint             minutes);
 
 G_END_DECLS
 
index 9add00b..db34764 100644 (file)
@@ -73,14 +73,14 @@ hildon_time_picker_get_type                     (void);
 GtkWidget*
 hildon_time_picker_new                          (GtkWindow *parent);
 
-void 
+void
 hildon_time_picker_set_time                     (HildonTimePicker *picker,
-                                                 guint hours, 
+                                                 guint hours,
                                                  guint minutes);
 
-void 
+void
 hildon_time_picker_get_time                     (HildonTimePicker *picker,
-                                                 guint *hours, 
+                                                 guint *hours,
                                                  guint *minutes);
 
 G_END_DECLS
index bc5a485..78c9c4b 100644 (file)
@@ -389,10 +389,18 @@ hildon_time_selector_new ()
   return g_object_new (HILDON_TYPE_TIME_SELECTOR, NULL);
 }
 
-/*
- * hours (0-23)
- * minutes (0-59)
- */
+/**
+ * hildon_time_selector_set_time
+ * @selector: the #HildonTimeSelector
+ * @year:  the current hour (0-23)
+ * @minutes: the current minute (0-59)
+ *
+ * Sets the current active hour on the #HildonTimeSelector widget
+ *
+ * The format of the hours acceptes is always 24h format, with a range
+ * (0-23):(0-59).
+ *
+ **/
 gboolean
 hildon_time_selector_set_time (HildonTimeSelector * selector,
                                guint hours, guint minutes)
@@ -424,6 +432,18 @@ hildon_time_selector_set_time (HildonTimeSelector * selector,
   return TRUE;
 }
 
+/**
+ * hildon_time_selector_get_time
+ * @selector: the #HildonTimeSelector
+ * @year:  to set the current hour (0-23)
+ * @minutes: to set the current minute (0-59)
+ *
+ * Gets the current active hour on the #HildonTimeSelector widget. Both @year
+ * and @minutes can be NULL.
+ *
+ * This method returns the date always in 24h format, with a range (0-23):(0-59)
+ *
+ **/
 void
 hildon_time_selector_get_time (HildonTimeSelector * selector,
                                guint * hours, guint * minutes)
index 9e37e0c..57ddfa0 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef __HILDON_TIME_SELECTOR_H__
-#define __HILDON_TIME_SELECTOR_H__
+#ifndef                                         __HILDON_TIME_SELECTOR_H__
+#define                                         __HILDON_TIME_SELECTOR_H__
 
-#include "hildon-touch-selector.h"
+#include                                        "hildon-touch-selector.h"
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_TIME_SELECTOR             (hildon_time_selector_get_type ())
-#define HILDON_TIME_SELECTOR(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_TIME_SELECTOR, HildonTimeSelector))
-#define HILDON_TIME_SELECTOR_CLASS(vtable)    (G_TYPE_CHECK_CLASS_CAST ((vtable), HILDON_TYPE_TIME_SELECTOR, HildonTimeSelectorClass))
-#define HILDON_IS_TIME_SELECTOR(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TIME_SELECTOR))
-#define HILDON_IS_TIME_SELECTOR_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_TIME_SELECTOR))
-#define HILDON_TIME_SELECTOR_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), HILDON_TYPE_TIME_SELECTOR, HildonTimeSelectorClass))
+#define                                         HILDON_TYPE_TIME_SELECTOR \
+                                                (hildon_time_selector_get_type ())
 
-typedef struct _HildonTimeSelector HildonTimeSelector;
-typedef struct _HildonTimeSelectorClass HildonTimeSelectorClass;
-typedef struct _HildonTimeSelectorPrivate HildonTimeSelectorPrivate;
+#define                                         HILDON_TIME_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_TIME_SELECTOR, HildonTimeSelector))
 
-struct _HildonTimeSelector
+#define                                         HILDON_TIME_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((vtable), \
+                                                HILDON_TYPE_TIME_SELECTOR, HildonTimeSelectorClass))
+
+#define                                         HILDON_IS_TIME_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TIME_SELECTOR))
+
+#define                                         HILDON_IS_TIME_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_TIME_SELECTOR))
+
+#define                                         HILDON_TIME_SELECTOR_GET_CLASS(inst) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((inst), \
+                                                HILDON_TYPE_TIME_SELECTOR, HildonTimeSelectorClass))
+
+typedef struct                                  _HildonTimeSelector HildonTimeSelector;
+typedef struct                                  _HildonTimeSelectorClass HildonTimeSelectorClass;
+typedef struct                                  _HildonTimeSelectorPrivate HildonTimeSelectorPrivate;
+
+struct                                          _HildonTimeSelector
 {
   HildonTouchSelector parent_instance;
 
@@ -44,7 +58,7 @@ struct _HildonTimeSelector
   HildonTimeSelectorPrivate *priv;
 };
 
-struct _HildonTimeSelectorClass
+struct                                          _HildonTimeSelectorClass
 {
   HildonTouchSelectorClass parent_class;
 
@@ -53,14 +67,22 @@ struct _HildonTimeSelectorClass
 
 
 /* construction */
-GType       hildon_time_selector_get_type (void) G_GNUC_CONST;
-GtkWidget * hildon_time_selector_new (void);
+GType G_GNUC_CONST
+hildon_time_selector_get_type                   (void) ;
+
+GtkWidget*
+hildon_time_selector_new                        (void);
 
 /* time management */
-gboolean hildon_time_selector_set_time (HildonTimeSelector * selector,
-                                        guint hours, guint minutes);
-void     hildon_time_selector_get_time (HildonTimeSelector * selector,
-                                        guint * hours, guint * minutes);
+gboolean
+hildon_time_selector_set_time                   (HildonTimeSelector *selector,
+                                                 guint               hours,
+                                                 guint               minutes);
+
+void
+hildon_time_selector_get_time                   (HildonTimeSelector *selector,
+                                                 guint              *hours,
+                                                 guint              *minutes);
 
 G_END_DECLS
 
index 05c3d35..4686ac1 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef __HILDON_TOUCH_SELECTOR_COLUMN_H__
-#define __HILDON_TOUCH_SELECTOR_COLUMN_H__
+#ifndef                                         __HILDON_TOUCH_SELECTOR_COLUMN_H__
+#define                                         __HILDON_TOUCH_SELECTOR_COLUMN_H__
 
-#include <gtk/gtk.h>
+#include                                        <gtk/gtk.h>
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_TOUCH_SELECTOR_COLUMN          (hildon_touch_selector_column_get_type ())
-#define HILDON_TOUCH_SELECTOR_COLUMN(obj)          (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumn))
-#define HILDON_TOUCH_SELECTOR_COLUMN_CLASS(klass)   (G_TYPE_CHECK_CLASS_CAST ((klass), HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumnClass))
-#define HILDON_IS_TOUCH_SELECTOR_COLUMN(obj)       (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TOUCH_SELECTOR_COLUMN))
-#define HILDON_IS_TOUCH_SELECTOR_COLUMN_CLASS(klass)(G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_TOUCH_SELECTOR_COLUMN))
-#define HILDON_TOUCH_SELECTOR_COLUMN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumnClass))
+#define                                         HILDON_TYPE_TOUCH_SELECTOR_COLUMN \
+                                                (hildon_touch_selector_column_get_type ())
 
-typedef struct _HildonTouchSelectorColumn        HildonTouchSelectorColumn;
-typedef struct _HildonTouchSelectorColumnClass   HildonTouchSelectorColumnClass;
-typedef struct _HildonTouchSelectorColumnPrivate HildonTouchSelectorColumnPrivate;
+#define                                         HILDON_TOUCH_SELECTOR_COLUMN(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumn))
 
-struct _HildonTouchSelectorColumn
+#define                                         HILDON_TOUCH_SELECTOR_COLUMN_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((klass), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumnClass))
+
+#define                                         HILDON_IS_TOUCH_SELECTOR_COLUMN(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_COLUMN))
+
+#define                                         HILDON_IS_TOUCH_SELECTOR_COLUMN_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((klass), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_COLUMN))
+
+#define                                         HILDON_TOUCH_SELECTOR_COLUMN_GET_CLASS(obj) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_COLUMN, HildonTouchSelectorColumnClass))
+
+typedef struct                                  _HildonTouchSelectorColumn HildonTouchSelectorColumn;
+typedef struct                                  _HildonTouchSelectorColumnClass HildonTouchSelectorColumnClass;
+typedef struct                                  _HildonTouchSelectorColumnPrivate HildonTouchSelectorColumnPrivate;
+
+struct                                         _HildonTouchSelectorColumn
 {
   GObject parent;
 
@@ -44,12 +60,13 @@ struct _HildonTouchSelectorColumn
   HildonTouchSelectorColumnPrivate *priv;
 };
 
-struct _HildonTouchSelectorColumnClass
+struct                                          _HildonTouchSelectorColumnClass
 {
   GObjectClass parent_class;
 };
 
-GType                   hildon_touch_selector_column_get_type            (void) G_GNUC_CONST;
+GType G_GNUC_CONST
+hildon_touch_selector_column_get_type           (void);
 
 G_END_DECLS
 
index b7d3a67..0a1a17c 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef _HILDON_TOUCH_SELECTOR_ENTRY
-#define _HILDON_TOUCH_SELECTOR_ENTRY
+#ifndef                                         __HILDON_TOUCH_SELECTOR_ENTRY__
+#define                                         __HILDON_TOUCH_SELECTOR_ENTRY__
 
-#include "hildon-touch-selector.h"
+#include                                        "hildon-touch-selector.h"
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_TOUCH_SELECTOR_ENTRY            (hildon_touch_selector_entry_get_type())
-#define HILDON_TOUCH_SELECTOR_ENTRY(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntry))
-#define HILDON_TOUCH_SELECTOR_ENTRY_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntryClass))
-#define HILDON_IS_TOUCH_SELECTOR_ENTRY(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TOUCH_SELECTOR_ENTRY))
-#define HILDON_IS_TOUCH_SELECTOR_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), HILDON_TYPE_TOUCH_SELECTOR_ENTRY))
-#define HILDON_TOUCH_SELECTOR_ENTRY_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntryClass))
+#define                                         HILDON_TYPE_TOUCH_SELECTOR_ENTRY \
+                                                (hildon_touch_selector_entry_get_type())
 
-typedef struct {
+#define                                         HILDON_TOUCH_SELECTOR_ENTRY(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntry))
+
+#define                                         HILDON_TOUCH_SELECTOR_ENTRY_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((klass), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntryClass))
+
+#define                                         HILDON_IS_TOUCH_SELECTOR_ENTRY(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_ENTRY))
+
+#define                                         HILDON_IS_TOUCH_SELECTOR_ENTRY_CLASS(klass) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((klass), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_ENTRY))
+
+#define                                         HILDON_TOUCH_SELECTOR_ENTRY_GET_CLASS(obj) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR_ENTRY, HildonTouchSelectorEntryClass))
+
+typedef struct                                  _HildonTouchSelectorEntry HildonTouchSelectorEntry;
+typedef struct                                  _HildonTouchSelectorEntryClass HildonTouchSelectorEntryClass;
+
+struct                                          _HildonTouchSelectorEntry
+{
   HildonTouchSelector parent;
-} HildonTouchSelectorEntry;
 
-typedef struct {
+  /*< private > */
+};
+
+struct                                          _HildonTouchSelectorEntryClass
+{
   HildonTouchSelectorClass parent_class;
-} HildonTouchSelectorEntryClass;
+};
+
+GType
+hildon_touch_selector_entry_get_type            (void);
+
+GtkWidget*
+hildon_touch_selector_entry_new                 (void);
 
-GType       hildon_touch_selector_entry_get_type (void);
-GtkWidget * hildon_touch_selector_entry_new      (void);
-GtkWidget * hildon_touch_selector_entry_new_text (void);
+GtkWidget*
+hildon_touch_selector_entry_new_text            (void);
 
-void        hildon_touch_selector_entry_set_text_column (HildonTouchSelectorEntry *selector, gint text_column);
-gint        hildon_touch_selector_entry_get_text_column (HildonTouchSelectorEntry *selector);
+void
+hildon_touch_selector_entry_set_text_column     (HildonTouchSelectorEntry *selector,
+                                                 gint                      text_column);
+gint
+hildon_touch_selector_entry_get_text_column     (HildonTouchSelectorEntry *selector);
 
 G_END_DECLS
 
-#endif /* _HILDON_TOUCH_SELECTOR_ENTRY */
+#endif /* __HILDON_TOUCH_SELECTOR_ENTRY__ */
 
index afcbfa7..aeefa1a 100644 (file)
  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  */
 
-#ifndef __HILDON_TOUCH_SELECTOR_H__
-#define __HILDON_TOUCH_SELECTOR_H__
+#ifndef                                         __HILDON_TOUCH_SELECTOR_H__
+#define                                         __HILDON_TOUCH_SELECTOR_H__
 
-#include <gtk/gtk.h>
-#include "hildon-touch-selector-column.h"
+#include                                        <gtk/gtk.h>
+#include                                        "hildon-touch-selector-column.h"
 
 G_BEGIN_DECLS
 
-#define HILDON_TYPE_TOUCH_SELECTOR             (hildon_touch_selector_get_type ())
-#define HILDON_TOUCH_SELECTOR(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelector))
-#define HILDON_TOUCH_SELECTOR_CLASS(vtable)    (G_TYPE_CHECK_CLASS_CAST ((vtable), HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelectorClass))
-#define HILDON_IS_TOUCH_SELECTOR(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), HILDON_TYPE_TOUCH_SELECTOR))
-#define HILDON_IS_TOUCH_SELECTOR_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_TOUCH_SELECTOR))
-#define HILDON_TOUCH_SELECTOR_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelectorClass))
+#define                                         HILDON_TYPE_TOUCH_SELECTOR \
+                                                (hildon_touch_selector_get_type ())
 
-typedef struct _HildonTouchSelector HildonTouchSelector;
-typedef struct _HildonTouchSelectorClass HildonTouchSelectorClass;
-typedef struct _HildonTouchSelectorPrivate HildonTouchSelectorPrivate;
+#define                                         HILDON_TOUCH_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelector))
 
-typedef gchar *(*HildonTouchSelectorPrintFunc) (HildonTouchSelector * selector);
+#define                                         HILDON_TOUCH_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_CAST ((vtable), \
+                                                HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelectorClass))
 
-struct _HildonTouchSelector
+#define                                         HILDON_IS_TOUCH_SELECTOR(obj) \
+                                                (G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
+                                                HILDON_TYPE_TOUCH_SELECTOR))
+
+#define                                         HILDON_IS_TOUCH_SELECTOR_CLASS(vtable) \
+                                                (G_TYPE_CHECK_CLASS_TYPE ((vtable), HILDON_TYPE_TOUCH_SELECTOR))
+
+#define                                         HILDON_TOUCH_SELECTOR_GET_CLASS(inst) \
+                                                (G_TYPE_INSTANCE_GET_CLASS ((inst), \
+                                                HILDON_TYPE_TOUCH_SELECTOR, HildonTouchSelectorClass))
+
+typedef struct                                  _HildonTouchSelector HildonTouchSelector;
+typedef struct                                  _HildonTouchSelectorClass HildonTouchSelectorClass;
+typedef struct                                  _HildonTouchSelectorPrivate HildonTouchSelectorPrivate;
+
+typedef gchar *(*HildonTouchSelectorPrintFunc)  (HildonTouchSelector * selector);
+
+struct                                          _HildonTouchSelector
 {
   GtkHBox parent_instance;
 
@@ -47,17 +62,20 @@ struct _HildonTouchSelector
   HildonTouchSelectorPrivate *priv;
 };
 
-struct _HildonTouchSelectorClass
+struct                                          _HildonTouchSelectorClass
 {
   GtkHBoxClass parent_class;
 
   /* signals */
-  void (*changed) (HildonTouchSelector * selector, gint column);
+  void (*changed)                               (HildonTouchSelector *selector,
+                                                 gint column);
 
   /* virtual methods */
-  void (*set_model) (HildonTouchSelector *selector, gint column, GtkTreeModel *model);
+  void (*set_model)                             (HildonTouchSelector *selector,
+                                                 gint column,
+                                                 GtkTreeModel *model);
 
-  gboolean (*has_multiple_selection) (HildonTouchSelector *selector);
+  gboolean (*has_multiple_selection)            (HildonTouchSelector *selector);
 };
 
 typedef enum
@@ -67,85 +85,113 @@ typedef enum
 } HildonTouchSelectorSelectionMode;
 
 /* construction */
-GType      hildon_touch_selector_get_type (void) G_GNUC_CONST;
-GtkWidget *hildon_touch_selector_new      (void);
+GType G_GNUC_CONST
+hildon_touch_selector_get_type                  (void);
 
-/* Simple (and recommended) API for one-text-column selectors. */
-GtkWidget *hildon_touch_selector_new_text (void);
+GtkWidget *
+hildon_touch_selector_new                       (void);
 
-void hildon_touch_selector_append_text    (HildonTouchSelector * selector,
-                                          const gchar * text);
-void hildon_touch_selector_prepend_text   (HildonTouchSelector * selector,
-                                          const gchar * text);
-void hildon_touch_selector_insert_text    (HildonTouchSelector * selector,
-                                          gint position, const gchar * text);
+/* Simple (and recommended) API for one-text-column selectors. */
+GtkWidget *
+hildon_touch_selector_new_text                  (void);
+
+void
+hildon_touch_selector_append_text               (HildonTouchSelector *selector,
+                                                 const gchar         *text);
+void
+hildon_touch_selector_prepend_text              (HildonTouchSelector *selector,
+                                                 const gchar         *text);
+void
+hildon_touch_selector_insert_text               (HildonTouchSelector *selector,
+                                                 gint                 position,
+                                                 const gchar         *text);
 
 /* column related  */
 HildonTouchSelectorColumn*
-hildon_touch_selector_append_text_column              (HildonTouchSelector * selector,
-                                                       GtkTreeModel * model, gboolean center);
+hildon_touch_selector_append_text_column        (HildonTouchSelector *selector,
+                                                 GtkTreeModel *       model,
+                                                 gboolean             center);
 
 HildonTouchSelectorColumn*
-hildon_touch_selector_append_column                   (HildonTouchSelector * selector,
-                                                       GtkTreeModel * model,
-                                                       GtkCellRenderer * cell_renderer,
-                                                       ...);
+hildon_touch_selector_append_column             (HildonTouchSelector *selector,
+                                                 GtkTreeModel        *model,
+                                                 GtkCellRenderer     *cell_renderer,
+                                                 ...);
 
-void hildon_touch_selector_set_column_attributes      (HildonTouchSelector * selector,
-                                                       gint num_column,
-                                                       GtkCellRenderer * cell_renderer,
-                                                       ...);
+void
+hildon_touch_selector_set_column_attributes     (HildonTouchSelector *selector,
+                                                 gint                 num_column,
+                                                 GtkCellRenderer     *cell_renderer,
+                                                 ...);
 
-gboolean hildon_touch_selector_remove_column          (HildonTouchSelector * selector,
-                                                       gint column);
+gboolean
+hildon_touch_selector_remove_column             (HildonTouchSelector *selector,
+                                                 gint                 column);
 
-gint hildon_touch_selector_get_num_columns            (HildonTouchSelector * selector);
+gint
+hildon_touch_selector_get_num_columns           (HildonTouchSelector *selector);
 
-void hildon_touch_selector_set_column_selection_mode  (HildonTouchSelector * selector,
-                                                       HildonTouchSelectorSelectionMode mode);
+void
+hildon_touch_selector_set_column_selection_mode (HildonTouchSelector              *selector,
+                                                 HildonTouchSelectorSelectionMode  mode);
 
 HildonTouchSelectorSelectionMode
-hildon_touch_selector_get_column_selection_mode       (HildonTouchSelector * selector);
+hildon_touch_selector_get_column_selection_mode (HildonTouchSelector *selector);
 
 HildonTouchSelectorColumn *
-hildon_touch_selector_get_column                      (HildonTouchSelector * selector,
-                                                       gint column);
+hildon_touch_selector_get_column                (HildonTouchSelector *selector,
+                                                 gint                 column);
 
 /* get/set active item */
-void hildon_touch_selector_set_active           (HildonTouchSelector *selector,
-                                                 gint column,
-                                                 gint index);
-gint hildon_touch_selector_get_active           (HildonTouchSelector * selector,
-                                                 gint column);
-gboolean hildon_touch_selector_get_selected     (HildonTouchSelector * selector,
-                                                 gint column,
-                                                 GtkTreeIter * iter);
-void hildon_touch_selector_select_iter          (HildonTouchSelector * selector,
-                                                 gint column,
-                                                 GtkTreeIter * iter,
-                                                 gboolean scroll_to);
-void hildon_touch_selector_unselect_iter        (HildonTouchSelector * selector,
-                                                 gint column,
-                                                 GtkTreeIter * iter);
-GList *hildon_touch_selector_get_selected_rows  (HildonTouchSelector * selector,
-                                                 gint column);
+void
+hildon_touch_selector_set_active                (HildonTouchSelector *selector,
+                                                 gint                 column,
+                                                 gint                 index);
+gint
+hildon_touch_selector_get_active                (HildonTouchSelector *selector,
+                                                 gint                 column);
+
+gboolean
+hildon_touch_selector_get_selected              (HildonTouchSelector *selector,
+                                                 gint                 column,
+                                                 GtkTreeIter         *iter);
+
+void
+hildon_touch_selector_select_iter               (HildonTouchSelector *selector,
+                                                 gint                 column,
+                                                 GtkTreeIter         *iter,
+                                                 gboolean             scroll_to);
+
+void
+hildon_touch_selector_unselect_iter             (HildonTouchSelector *selector,
+                                                 gint                 column,
+                                                 GtkTreeIter         *iter);
+
+GList *
+hildon_touch_selector_get_selected_rows         (HildonTouchSelector *selector,
+                                                 gint                 column);
 /* model  */
-void hildon_touch_selector_set_model            (HildonTouchSelector * selector,
-                                                 gint column, GtkTreeModel * model);
-GtkTreeModel *hildon_touch_selector_get_model   (HildonTouchSelector * selector,
-                                                 gint column);
+void
+hildon_touch_selector_set_model                 (HildonTouchSelector *selector,
+                                                 gint                 column,
+                                                 GtkTreeModel        *model);
+GtkTreeModel *
+hildon_touch_selector_get_model                 (HildonTouchSelector *selector,
+                                                 gint                 column);
 
 /* show the current element selected */
-gchar *hildon_touch_selector_get_current_text (HildonTouchSelector * selector);
+gchar *
+hildon_touch_selector_get_current_text          (HildonTouchSelector *selector);
 
-void hildon_touch_selector_set_print_func     (HildonTouchSelector * selector,
-                                               HildonTouchSelectorPrintFunc func);
+void
+hildon_touch_selector_set_print_func            (HildonTouchSelector          *selector,
+                                                 HildonTouchSelectorPrintFunc  func);
 
 HildonTouchSelectorPrintFunc
-hildon_touch_selector_get_print_func          (HildonTouchSelector * selector);
+hildon_touch_selector_get_print_func            (HildonTouchSelector *selector);
 
 gboolean
-hildon_touch_selector_has_multiple_selection (HildonTouchSelector * selector);
+hildon_touch_selector_has_multiple_selection    (HildonTouchSelector *selector);
 
 G_END_DECLS