From: Austin Clements <amdragon@MIT.EDU>
Date: Wed, 7 Nov 2012 15:27:01 +0000 (-0500)
Subject: show: More aggressively document the presence of devel/schemata
X-Git-Tag: 0.15_rc1~184
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=a437031a3c03fa96d05618807e33bb7b8dbf3386;p=notmuch.git

show: More aggressively document the presence of devel/schemata

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

diff --git a/notmuch-show.c b/notmuch-show.c
index f758f56b..2fa22925 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);