[PATCH 2/3] show: More aggressively document the presence of devel/schemata

Subject: [PATCH 2/3] show: More aggressively document the presence of devel/schemata

Date: Wed, 7 Nov 2012 10:27:01 -0500

To: notmuch@notmuchmail.org

Cc:

From: Austin Clements

Previously, the only mention of devel/schemata was a comment at the
top of format_part_json, but the JSON output code is spread across
several functions that are distributed across notmuch-show.c.  Add
references from the other three key JSON output functions.
---
 notmuch-show.c |    9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/notmuch-show.c b/notmuch-show.c
index f758f56..2fa2292 100644
--- a/notmuch-show.c
+++ b/notmuch-show.c
@@ -110,6 +110,9 @@ _get_one_line_summary (const void *ctx, notmuch_message_t *message)
 static void
 format_message_json (sprinter_t *sp, notmuch_message_t *message)
 {
+    /* Any changes to the JSON format should be reflected in the file
+     * devel/schemata. */
+
     void *local = talloc_new (NULL);
     notmuch_tags_t *tags;
     time_t date;
@@ -208,6 +211,9 @@ void
 format_headers_json (sprinter_t *sp, GMimeMessage *message,
 		     notmuch_bool_t reply)
 {
+    /* Any changes to the JSON format should be reflected in the file
+     * devel/schemata. */
+
     InternetAddressList *recipients;
     const char *recipients_string;
     const char *reply_to_string;
@@ -359,6 +365,9 @@ signer_status_to_string (GMimeSignerStatus x)
 static void
 format_part_sigstatus_json (sprinter_t *sp, mime_node_t *node)
 {
+    /* Any changes to the JSON format should be reflected in the file
+     * devel/schemata. */
+
     GMimeSignatureList *siglist = node->sig_list;
 
     sp->begin_list (sp);
-- 
1.7.10

Thread: