From 1d652c87193b34fe1057d7b02db0a4aad95b0fad Mon Sep 17 00:00:00 2001 From: Austin Clements Date: Thu, 31 Jul 2014 22:59:13 -0400 Subject: [PATCH] lib: Fix slight misinformation in the database schema doc The database schema documentation made it sound like each mail document had exactly one on-disk message file, which hasn't been true for a long time. --- lib/database.cc | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) 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: *