about summary refs log tree commit homepage
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2020-09-02 11:04:20 +0000
committerEric Wong <e@80x24.org>2020-09-03 20:11:03 +0000
commit12d219222ac5bc09cf364f15834c1e5cc5659e8f (patch)
treee9badfdc45e333b559c93536c6053183b73220bf
parent7f8e6ba85dd5e41efdfb518e3b86bceda3ee027e (diff)
downloadpublic-inbox-12d219222ac5bc09cf364f15834c1e5cc5659e8f.tar.gz
This may be useful for keeping our heads on straight dealing
with IMAP, NNTP, JMAP, etc.
-rw-r--r--lib/PublicInbox/OverIdx.pm18
1 files changed, 9 insertions, 9 deletions
diff --git a/lib/PublicInbox/OverIdx.pm b/lib/PublicInbox/OverIdx.pm
index 6f0477f0..db4b7738 100644
--- a/lib/PublicInbox/OverIdx.pm
+++ b/lib/PublicInbox/OverIdx.pm
@@ -379,12 +379,12 @@ sub create_tables {
 
         $dbh->do(<<'');
 CREATE TABLE IF NOT EXISTS over (
-        num INTEGER NOT NULL,
-        tid INTEGER NOT NULL,
-        sid INTEGER,
-        ts INTEGER,
-        ds INTEGER,
-        ddd VARBINARY, /* doc-data-deflated */
+        num INTEGER NOT NULL, /* NNTP article number == IMAP UID */
+        tid INTEGER NOT NULL, /* THREADID (IMAP REFERENCES threading, JMAP) */
+        sid INTEGER, /* Subject ID (IMAP ORDEREDSUBJECT "threading") */
+        ts INTEGER, /* IMAP INTERNALDATE (Received: header, git commit time) */
+        ds INTEGER, /* RFC-2822 sent Date: header, git author time */
+        ddd VARBINARY, /* doc-data-deflated (->to_doc_data, ->load_from_data) */
         UNIQUE (num)
 )
 
@@ -406,13 +406,13 @@ CREATE TABLE IF NOT EXISTS counter (
         $dbh->do(<<'');
 CREATE TABLE IF NOT EXISTS subject (
         sid INTEGER PRIMARY KEY AUTOINCREMENT,
-        path VARCHAR(40) NOT NULL,
+        path VARCHAR(40) NOT NULL, /* SHA-1 of normalized subject */
         UNIQUE (path)
 )
 
         $dbh->do(<<'');
 CREATE TABLE IF NOT EXISTS id2num (
-        id INTEGER NOT NULL,
+        id INTEGER NOT NULL, /* <=> msgid.id */
         num INTEGER NOT NULL,
         UNIQUE (id, num)
 )
@@ -423,7 +423,7 @@ CREATE TABLE IF NOT EXISTS id2num (
 
         $dbh->do(<<'');
 CREATE TABLE IF NOT EXISTS msgid (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        id INTEGER PRIMARY KEY AUTOINCREMENT, /* <=> id2num.id */
         mid VARCHAR(244) NOT NULL,
         UNIQUE (mid)
 )