Document some initial values

svn path=/trunk/; revision=19281

diff --git a/ChangeLog b/ChangeLog
index fad32b17afaa7ddb1956983d6fbf2eba4116e569..f85f980d1e5f561d7e236fbd0df144a53dd932a7 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-12-28  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkcalendar.c: Document the initial values of year/month/day
+       properties.
+
 2007-12-28  Christian Persch  <chpe@gnome.org>
 
        * gtk/gtkfontsel.c: (gtk_font_selection_get_property): Plug

diff --git a/gtk/gtkcalendar.c b/gtk/gtkcalendar.c
index 45cc8808809dd031855e89322802a8038aaf8ab6..8735bd757566ce0eca632630df14abe059846aec 100644 (file)
--- a/gtk/gtkcalendar.c
+++ b/gtk/gtkcalendar.c
@@ -432,6 +432,12 @@ gtk_calendar_class_init (GtkCalendarClass *class)
   widget_class->drag_drop = gtk_calendar_drag_drop;
   widget_class->drag_data_received = gtk_calendar_drag_data_received;
   
+  /**
+   * GtkCalendar:year:
+   *
+   * The selected year. 
+   * This property gets initially set to the current year.
+   */  
   g_object_class_install_property (gobject_class,
                                    PROP_YEAR,
                                    g_param_spec_int ("year",
@@ -439,6 +445,13 @@ gtk_calendar_class_init (GtkCalendarClass *class)
                                                     P_("The selected year"),
                                                     0, G_MAXINT, 0,
                                                     GTK_PARAM_READWRITE));
+
+  /**
+   * GtkCalendar:month:
+   *
+   * The selected month (as a number between 0 and 11). 
+   * This property gets initially set to the current month.
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_MONTH,
                                    g_param_spec_int ("month",
@@ -446,6 +459,14 @@ gtk_calendar_class_init (GtkCalendarClass *class)
                                                     P_("The selected month (as a number between 0 and 11)"),
                                                     0, 11, 0,
                                                     GTK_PARAM_READWRITE));
+
+  /**
+   * GtkCalendar:day:
+   *
+   * The selected day (as a number between 1 and 31, or 0 
+   * to unselect the currently selected day).
+   * This property gets initially set to the current day.
+   */
   g_object_class_install_property (gobject_class,
                                    PROP_DAY,
                                    g_param_spec_int ("day",