From: Timo Sirainen Date: Fri, 27 Apr 2018 10:52:28 +0000 (+0300) Subject: lib-storage: Update mail_add_temp_wanted_fields() comment X-Git-Tag: 2.3.9~497 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bafa82f1e16e301c1a8efe45cbb645e72ab3e11c;p=thirdparty%2Fdovecot%2Fcore.git lib-storage: Update mail_add_temp_wanted_fields() comment --- diff --git a/src/lib-storage/mail-storage.h b/src/lib-storage/mail-storage.h index 157eba9348..43aea8d4dd 100644 --- a/src/lib-storage/mail-storage.h +++ b/src/lib-storage/mail-storage.h @@ -854,7 +854,10 @@ void mail_set_seq(struct mail *mail, uint32_t seq); bool mail_set_uid(struct mail *mail, uint32_t uid); /* Add wanted fields/headers on top of existing ones. These will be forgotten - after the next mail_set_seq/uid(). */ + after the next mail_set_seq/uid() that closes the existing mail. Note that + it's valid to call this function while there is no mail assigned + (mail->seq==0), i.e. this is called before any mail_set_seq/uid() or after + mail.close(). */ void mail_add_temp_wanted_fields(struct mail *mail, enum mail_fetch_field fields, struct mailbox_header_lookup_ctx *headers)