diff --git a/src/gcal-month-view.c b/src/gcal-month-view.c
index f1099a2e..949d5a03 100644
--- a/src/gcal-month-view.c
+++ b/src/gcal-month-view.c
@@ -39,11 +39,13 @@ typedef struct
 
   GdkWindow      *event_window;
 
-  /* the day of week for first day of the month,
+  /**
+   * the day of week for first day of the month,
    * sun: 0, mon: 1, ... sat = 6 */
   gint            days_delay;
 
-  /* first day of the week according to user locale, being
+  /**
+   * first day of the week according to user locale, being
    * 0 for Sunday, 1 for Monday and so on */
   gint            first_weekday;
 
diff --git a/src/gcal-week-view.c b/src/gcal-week-view.c
index cb7f37a6..30e13110 100644
--- a/src/gcal-week-view.c
+++ b/src/gcal-week-view.c
@@ -69,7 +69,8 @@ typedef struct
 
   GtkWidget      *vscrollbar;
 
-  /* first day of the week according to user locale, being
+  /**
+   * first day of the week according to user locale, being
    * 0 for Sunday, 1 for Monday and so on */
   gint            first_weekday;