X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=devel%2Fschemata;h=6677a1c9a38705c728ca62d682539c6bf8225bdb;hp=728a46f214ac5a1597c48a62f6d00efbd41ffcd6;hb=e7f5302114da0b86c6682cc676607c0d64c55e5e;hpb=5abc9c1097a54e0e8b62e468d51728edb26b9101

diff --git a/devel/schemata b/devel/schemata
index 728a46f2..6677a1c9 100644
--- a/devel/schemata
+++ b/devel/schemata
@@ -32,11 +32,11 @@ thread = [thread_node*]
 
 # A message and its replies (show_messages)
 thread_node = [
-    message?,                 # present if --entire-thread or matched
+    message|null,             # null if not matched and not --entire-thread
     [thread_node*]            # children of message
 ]
 
-# A message (show_message)
+# A message (format_part_json)
 message = {
     # (format_message_json)
     id:             messageid,
@@ -50,18 +50,13 @@ message = {
     body:           [part]
 }
 
-# A MIME part (show_message_body)
+# A MIME part (format_part_json)
 part = {
-    # format_part_start_json
     id:             int|string, # part id (currently DFS part number)
 
-    # format_part_encstatus_json
     encstatus?:     encstatus,
-
-    # format_part_sigstatus_json
     sigstatus?:     sigstatus,
 
-    # format_part_content_json
     content-type:   string,
     content-id?:    string,
     # if content-type starts with "multipart/":
@@ -77,9 +72,7 @@ part = {
     content?:       string
 }
 
-# The headers of a message (format_headers_json with raw headers
-# and reply = FALSE) or a part (format_headers_message_part_json
-# with pretty-printed headers)
+# The headers of a message or part (format_headers_json with reply = FALSE)
 headers = {
     Subject:        string,
     From:           string,
@@ -89,14 +82,14 @@ headers = {
     Date:           string
 }
 
-# Encryption status (format_part_encstatus_json)
+# Encryption status (format_part_json)
 encstatus = [{status: "good"|"bad"}]
 
 # Signature status (format_part_sigstatus_json)
 sigstatus = [signature*]
 
 signature = {
-    # signature_status_to_string
+    # (signature_status_to_string)
     status:         "none"|"good"|"bad"|"error"|"unknown",
     # if status is "good":
     fingerprint?:   string,
@@ -135,21 +128,22 @@ thread = {
     total:          int,      # total messages in thread
     authors:        string,   # comma-separated names with | between
                               # matched and unmatched
-    subject:        string
+    subject:        string,
+    tags:           [string*]
 }
 
 notmuch reply schema
 --------------------
 
 reply = {
-    # The headers of the constructed reply (format_headers_json with
-    # raw headers and reply = TRUE)
+    # The headers of the constructed reply
     reply-headers: reply_headers,
 
     # As in the show format (format_part_json)
     original: message
 }
 
+# Reply headers (format_headers_json with reply = TRUE)
 reply_headers = {
     Subject:        string,
     From:           string,