From 298f806d01fa49d6b62fd3de591a2cb33f7d725b Mon Sep 17 00:00:00 2001
From: Steve Holme <steve_holme@hotmail.com>
Date: Sun, 3 Mar 2013 16:44:53 +0000
Subject: [PATCH] imap: Added comments to imap_append()

---
 lib/imap.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/imap.c b/lib/imap.c
index cf27d6084..503ed6d46 100644
--- a/lib/imap.c
+++ b/lib/imap.c
@@ -730,16 +730,18 @@ static CURLcode imap_append(struct connectdata *conn)
   struct IMAP *imap = conn->data->state.proto.imap;
   char *mailbox;
 
+  /* Check we know the size of the upload */
   if(conn->data->set.infilesize < 0) {
     failf(conn->data, "Cannot APPEND with unknown input file size\n");
     return CURLE_UPLOAD_FAILED;
   }
 
+  /* Make sure the mailbox is in the correct atom format */
   mailbox = imap_atom(imap->mailbox);
-
   if(!mailbox)
     return CURLE_OUT_OF_MEMORY;
 
+  /* Send the APPEND command */
   result = imap_sendf(conn, "APPEND %s (\\Seen) {%" FORMAT_OFF_T "}",
                       mailbox, conn->data->set.infilesize);