From: Austin Clements <amdragon@MIT.EDU>
To: notmuch@notmuchmail.org
Subject: [PATCH v2 0/8] Rewrite JSON show format
Date: Sun, 19 Feb 2012 19:26:22 -0500
Message-Id: <1329697590-7404-1-git-send-email-amdragon@mit.edu>
In-Reply-To: <1329240823-7856-1-git-send-email-amdragon@mit.edu>
References: <1329240823-7856-1-git-send-email-amdragon@mit.edu>
Cc: tomi.ollila@iki.fi
Precedence: list

v2 fixes some trivial whitespace issues in devel/schemata [1] and
beefs up one of the explanations in devel/schemata.  None of the other
patches have changed, so I'm marking this ready.

As a teaser, I've got mbox and raw converted to the new style, too, so
as soon as this goes in I'll send those patches (they aren't actually
dependent, but do share some diff context with this one).

diff from v1 to v2:

diff --git a/devel/schemata b/devel/schemata
index d90d4c6..24ad775 100644
--- a/devel/schemata
+++ b/devel/schemata
@@ -71,7 +71,10 @@ part = {
     # otherwise (leaf parts):
     filename?:      string,
     content-charset?: string,
-    content?:       string    # pre-fetched body content
+    # A leaf part's body content is optional, but may be included if
+    # it can be correctly encoded as a string.  Consumers should use
+    # this in preference to fetching the part content separately.
+    content?:       string
 }
 
 # The headers of a message (format_headers_json with raw headers) or
@@ -101,7 +104,7 @@ signature = {
     userid?:        string
     # if status is not "good":
     keyid?:         string
-    # if the signature has errors:    
+    # if the signature has errors:
     errors?:        int
 }
 
@@ -129,7 +132,7 @@ thread = {
     date_relative:  string,   # user-friendly timestamp
     matched:        int,      # number of matched messages
     total:          int,      # total messages in thread
-    authors:        string,   # comma-separated names with | between 
+    authors:        string,   # comma-separated names with | between
                               # matched and unmatched
     subject:        string
 }