X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=lib%2Fdatabase.cc;h=c76029067f4c28b32933e26e432713f39becd4b0;hp=45c42607802d79db683f7cb77683d68aaa831a4a;hb=1d652c87193b34fe1057d7b02db0a4aad95b0fad;hpb=30de720ba09fdf67fbe45642da67b62dcc6ecdf7

diff --git a/lib/database.cc b/lib/database.cc
index 45c42607..c7602906 100644
--- a/lib/database.cc
+++ b/lib/database.cc
@@ -54,9 +54,12 @@ typedef struct {
  *
  * Mail document
  * -------------
- * A mail document is associated with a particular email message file
- * on disk. It is indexed with the following prefixed terms which the
- * database uses to construct threads, etc.:
+ * A mail document is associated with a particular email message. It
+ * is stored in one or more files on disk (though only one has its
+ * content indexed) and is uniquely identified  by its "id" field
+ * (which is generally the message ID). It is indexed with the
+ * following prefixed terms which the database uses to construct
+ * threads, etc.:
  *
  *    Single terms of given prefix:
  *