From 91fdf1783b61d315a882525c749e822ef48c5ddb Mon Sep 17 00:00:00 2001
From: Georges Basile Stavracas Neto <georges.stavracas@gmail.com>
Date: Mon, 30 Apr 2018 20:45:01 -0300
Subject: [PATCH] event: improve documentation for gcal_event_is_multiday

Add some examples, so I can remember them in a few days from
now.
---
 src/gcal-event.c | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/gcal-event.c b/src/gcal-event.c
index 738bca7f..5f64e6f9 100644
--- a/src/gcal-event.c
+++ b/src/gcal-event.c
@@ -1492,7 +1492,19 @@ gcal_event_get_uid (GcalEvent *self)
  * gcal_event_is_multiday:
  * @self: a #GcalEvent
  *
- * Whether the event spans more than 1 day.
+ * Whether the event visibly spans more than one day in the
+ * calendar.
+ *
+ * This function can return different values for the same event
+ * depending on your timezone. For example, an event that spans
+ * [ 02:00, 22:00 ) +0000 would assume the following values:
+ *
+ * |[
+ *             D-1            D            D+1
+ * -0600 [         ---][-------     ][            ] (multiday)
+ * +0000 [            ][ ---------- ][            ] (single day)
+ * +0800 [            ][     -------][---         ] (multiday)
+ * ]|
  *
  * Returns: %TRUE if @self spans more than 1 day, %FALSE otherwise.
  */