[gnome-calendar] comments: document utils functions, add FIXME

[Erick Pérez Castellanos <erickpc src gnome org>]

commit 0ff177c1d8ba611b5b8f3bad41c21272425ca9cb
Author: Erick Pérez Castellanos <erick red gmail com>
Date:   Mon Dec 22 21:55:55 2014 -0500

    comments: document utils functions, add FIXME

 src/gcal-event-widget.c |    1 +
 src/gcal-month-view.c   |    1 +
 src/gcal-utils.c        |    9 +++++++++
 3 files changed, 11 insertions(+), 0 deletions(-)
---
diff --git a/src/gcal-event-widget.c b/src/gcal-event-widget.c
index 93970a2..4c3daf2 100644
--- a/src/gcal-event-widget.c
+++ b/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);
diff --git a/src/gcal-month-view.c b/src/gcal-month-view.c
index b8abcbd..ebc8225 100644
--- a/src/gcal-month-view.c
+++ b/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));
diff --git a/src/gcal-utils.c b/src/gcal-utils.c
index b741fbe..17aef99 100644
--- a/src/gcal-utils.c
+++ b/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)