changeset 22795:105a2e1fd770

lib-index: Update comments for mail_cache_decision_*()
author Timo Sirainen <timo.sirainen@dovecot.fi>
date Thu, 25 Jan 2018 12:35:35 +0200
parents 7d03ba768919
children 32db0c418fd2
files src/lib-index/mail-cache-private.h
diffstat 1 files changed, 6 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/src/lib-index/mail-cache-private.h	Sun Feb 04 13:40:12 2018 +0200
+++ b/src/lib-index/mail-cache-private.h	Thu Jan 25 12:35:35 2018 +0200
@@ -250,9 +250,14 @@
 int mail_cache_reopen(struct mail_cache *cache);
 
 /* Notify the decision handling code that field was looked up for seq.
-   This should be called even for fields that aren't currently in cache file */
+   This should be called even for fields that aren't currently in cache file.
+   This is used to update caching decisions for fields that already exist
+   in the cache file. */
 void mail_cache_decision_state_update(struct mail_cache_view *view,
 				      uint32_t seq, unsigned int field);
+/* Notify the decision handling code when field is committed to cache.
+   If this is the first time the field is added to cache, its caching decision
+   is updated to TEMP. */
 void mail_cache_decision_add(struct mail_cache_view *view, uint32_t seq,
 			     unsigned int field);