From 1c71fd351ab039a18c4eb5eea54dc4769f1445a9 Mon Sep 17 00:00:00 2001
From: Sebastian Rasmussen <sebrn@axis.com>
Date: Wed, 24 Oct 2012 11:34:32 +0200
Subject: [PATCH] curlsmtpsink: add comment describing function

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=686774
---
 ext/curl/gstcurlsmtpsink.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ext/curl/gstcurlsmtpsink.c b/ext/curl/gstcurlsmtpsink.c
index b58e65c0e6..6575bcdcfb 100644
--- a/ext/curl/gstcurlsmtpsink.c
+++ b/ext/curl/gstcurlsmtpsink.c
@@ -580,6 +580,12 @@ generate_encoded_word (gchar * str)
   return encoded_word;
 }
 
+/* Setup header fields (From:/To:/Date: etc) and message body for the e-mail.
+ * This data is supposed to be sent to libcurl just before any media data.
+ * This function is called once for each e-mail:
+ * 1. we are about the send the first attachment
+ * 2. we have sent all the attachments and continue sending new ones within
+ *    a new e-mail (transfer options have been reset). */
 static gboolean
 gst_curl_smtp_sink_set_transfer_options_unlocked (GstCurlBaseSink * bcsink)
 {