unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
* [PATCH] lib: Fix slight misinformation in the database schema doc
@ 2014-08-01  2:59 Austin Clements
  2014-08-04 22:04 ` David Bremner
  0 siblings, 1 reply; 2+ messages in thread
From: Austin Clements @ 2014-08-01  2:59 UTC (permalink / raw)
  To: notmuch

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 d90a924..c70ce63 100644
--- a/lib/database.cc
+++ b/lib/database.cc
@@ -55,9 +55,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:
  *
-- 
2.0.0

^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] lib: Fix slight misinformation in the database schema doc
  2014-08-01  2:59 [PATCH] lib: Fix slight misinformation in the database schema doc Austin Clements
@ 2014-08-04 22:04 ` David Bremner
  0 siblings, 0 replies; 2+ messages in thread
From: David Bremner @ 2014-08-04 22:04 UTC (permalink / raw)
  To: Austin Clements, notmuch

Austin Clements <amdragon@MIT.EDU> writes:

> 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.

pushed,

d

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2014-08-04 22:04 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-08-01  2:59 [PATCH] lib: Fix slight misinformation in the database schema doc Austin Clements
2014-08-04 22:04 ` David Bremner

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).