From 0ff177c1d8ba611b5b8f3bad41c21272425ca9cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erick=20P=C3=A9rez=20Castellanos?= <erick.red@gmail.com>
Date: Mon, 22 Dec 2014 21:55:55 -0500
Subject: [PATCH] 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(+)

diff --git a/src/gcal-event-widget.c b/src/gcal-event-widget.c
index 93970a2d..4c3daf2c 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 b8abcbdd..ebc82254 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 b741fbee..17aef991 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)