comments: document utils functions, add FIXME

src/gcal-event-widget.c

@@ -555,6 +555,7 @@ gcal_event_widget_draw (GtkWidget *widget,
   gtk_render_background (context, cr, x, y, width, height);
   gtk_render_frame (context, cr, x, y, width, height);
 
+  /* FIXME for RTL alignment and icons positions */
   gtk_style_context_get (context, state, "font", &font_desc, NULL);
   layout = pango_cairo_create_layout (cr);
   pango_layout_set_font_description (layout, font_desc);

src/gcal-month-view.c

@@ -431,6 +431,7 @@ rebuild_popover_for_day (GcalMonthView *view,
   for (; l != NULL; l = g_list_next (l))
     {
       /* FIXME: This may be replaced by setup_child */
+      /* FIXME: mark the widgets properly with CSS tags */
       child_widget = gcal_event_widget_clone (GCAL_EVENT_WIDGET (l->data));
       gtk_container_add (GTK_CONTAINER (priv->events_list_box), child_widget);
       g_signal_connect (child_widget, "activate", G_CALLBACK (event_opened), GTK_WIDGET (view));

src/gcal-utils.c

@@ -237,6 +237,15 @@ gcal_get_month_name (gint i)
   return nl_langinfo (month_item[i]);
 }
 
+/**
+ * gcal_get_pixbuf_from_color:
+ * @color:
+ * @size:
+ *
+ * Create a pixbuf of a simple {@link GdkRGBA} color.
+ *
+ * Returns: (Transfer full): An instance of {@link GdkPixbuf} to be freed with g_object_unref()
+ **/
 GdkPixbuf*
 gcal_get_pixbuf_from_color (GdkRGBA  *color,
                             gint      size)