* mu-msg-iter: add mu_msg_iter_get_maildir

src/mu-msg-iter.h

@@ -84,7 +84,7 @@ unsigned int     mu_msg_iter_get_docid         (MuMsgIter *iter);
 
 
 /**
- * get the directory path of the message
+ * get the full path of the message file
  * 
  * @param iter a valid MuMsgIter iterator
  * 
@@ -93,6 +93,18 @@ unsigned int     mu_msg_iter_get_docid         (MuMsgIter *iter);
 const char*      mu_msg_iter_get_path          (MuMsgIter *iter);
 
 
+/**
+ * get the maildir of the message - e.g., a message file 
+ * /home/user/Maildir/foo/bar/cur/abc123 would have maildir
+ *   "/foo/bar"
+ * 
+ * @param iter a valid MuMsgIter iterator
+ * 
+ * @return the path, or NULL in case of error
+ */
+const char*      mu_msg_iter_get_maildir (MuMsgIter *iter);
+
+
 /**
  * get the size of the message
  *