[dovecot-cvs] dovecot/src/lib-imap imap-match.h,1.7,1.8

[tss at dovecot.org]

Update of /var/lib/cvs/dovecot/src/lib-imap
In directory talvi:/tmp/cvs-serv16460

Modified Files:
	imap-match.h 
Log Message:
comment updates



Index: imap-match.h
===================================================================
RCS file: /var/lib/cvs/dovecot/src/lib-imap/imap-match.h,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- imap-match.h	14 Jan 2006 18:47:34 -0000	1.7
+++ imap-match.h	17 Apr 2007 09:43:14 -0000	1.8
@@ -5,8 +5,13 @@
 	IMAP_MATCH_YES = 1, /* match */
 	IMAP_MATCH_NO = -1, /* definite non-match */
 
-	IMAP_MATCH_CHILDREN = 0, /* it's children might match */
-	IMAP_MATCH_PARENT = -2 /* one of it's parents would match */
+	/* non-match, but its children could match (eg. "box" vs "box/%") */
+	IMAP_MATCH_CHILDREN = 0,
+	/* non-match, but one of its parents does match. This should often be
+	   handled with YES matches, because when listing for "%" and "box/foo"
+	   exists but "box" doesn't, you should still list "box" as
+	   (Nonexistent Children) mailbox. */
+	IMAP_MATCH_PARENT = -2
 };
 
 struct imap_match_glob;