# HG changeset patch
# User Timo Sirainen <timo.sirainen@dovecot.fi>
# Date 1487340879 -7200
# Node ID d99ff372361f10b2e0230de1cd3a00c07d74df3f
# Parent  b6b3381b96601ba01e3a2ad371593554b19069b1
lib-storage: Clarify what MAIL_LOOKUP_ABORT_READ_MAIL means.

It should maybe even be renamed to something clearer.

diff -r b6b3381b9660 -r d99ff372361f src/lib-storage/mail-storage.h
--- a/src/lib-storage/mail-storage.h	Sun Feb 19 01:44:21 2017 +0200
+++ b/src/lib-storage/mail-storage.h	Fri Feb 17 16:14:39 2017 +0200
@@ -364,7 +364,10 @@
 enum mail_lookup_abort {
 	/* Perform everything no matter what it takes */
 	MAIL_LOOKUP_ABORT_NEVER = 0,
-	/* Abort if the operation would require reading message header/body */
+	/* Abort if the operation would require reading message header/body or
+	   otherwise opening the mail file (e.g. with dbox metadata is read by
+	   opening and reading the file). This still allows somewhat fast
+	   operations to be performed, such as stat()ing a file. */
 	MAIL_LOOKUP_ABORT_READ_MAIL,
 	/* Abort if the operation can't be done fully using cache file */
 	MAIL_LOOKUP_ABORT_NOT_IN_CACHE