changeset 12220:d48456c46a49

mail-storage.h comments updated.
author Timo Sirainen <tss@iki.fi>
date Fri, 01 Oct 2010 16:19:10 +0100
parents 0da6f86c0ef5
children c172f2a384f5
files src/lib-storage/mail-storage.h
diffstat 1 files changed, 3 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/src/lib-storage/mail-storage.h	Fri Oct 01 16:14:08 2010 +0100
+++ b/src/lib-storage/mail-storage.h	Fri Oct 01 16:19:10 2010 +0100
@@ -254,6 +254,7 @@
 	unsigned int has_nuls:1; /* message data is known to contain NULs */
 	unsigned int has_no_nuls:1; /* -''- known to not contain NULs */
 
+	/* If the lookup is aborted, error is set to MAIL_ERROR_NOTPOSSIBLE */
 	enum mail_lookup_abort lookup_abort;
 };
 
@@ -641,7 +642,8 @@
    Also multiline headers are returned unfolded. */
 int mail_get_first_header_utf8(struct mail *mail, const char *field,
 			       const char **value_r);
-/* Return a NULL-terminated list of values for each found field. */
+/* Return a NULL-terminated list of values for each found field.
+   Returns -1 if error, 0 otherwise (with or without headers found). */
 int mail_get_headers(struct mail *mail, const char *field,
 		     const char *const **value_r);
 /* Like mail_get_headers(), but decode MIME encoded words to UTF-8.