87/a21230adef35816fd36f2ca381c7334a1f2c69

   1 Return-Path: <amdragon@mit.edu>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id B05EF431FBC\r
   6         for <notmuch@notmuchmail.org>; Wed, 12 Dec 2012 17:46:20 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id jyNdEfAh-VDj for <notmuch@notmuchmail.org>;\r
  16         Wed, 12 Dec 2012 17:46:20 -0800 (PST)\r
  17 Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU\r
  18         [18.9.25.12])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 1BFE5431FB6\r
  20         for <notmuch@notmuchmail.org>; Wed, 12 Dec 2012 17:46:20 -0800 (PST)\r
  21 X-AuditID: 1209190c-b7f886d000000936-fa-50c9336b7d6a\r
  22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
  23         by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 45.33.02358.B6339C05; Wed, 12 Dec 2012 20:46:19 -0500 (EST)\r
  25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
  26         by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id qBD1kIjF023868; \r
  27         Wed, 12 Dec 2012 20:46:19 -0500\r
  28 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id qBD1kHxo023174\r
  32         (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT);\r
  33         Wed, 12 Dec 2012 20:46:18 -0500 (EST)\r
  34 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.80)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1TixsP-0000JG-55; Wed, 12 Dec 2012 20:46:17 -0500\r
  37 Date: Wed, 12 Dec 2012 20:46:17 -0500\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: Mark Walters <markwalters1009@gmail.com>\r
  40 Subject: Re: [PATCH 00/10] CLI output versioning\r
  41 Message-ID: <20121213014617.GD6187@mit.edu>\r
  42 References: <1354416002-3557-1-git-send-email-amdragon@mit.edu>\r
  43         <87pq2sx86o.fsf@awakening.csail.mit.edu>\r
  44         <878v98hoyp.fsf@qmul.ac.uk>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: text/plain; charset=us-ascii\r
  47 Content-Disposition: inline\r
  48 In-Reply-To: <878v98hoyp.fsf@qmul.ac.uk>\r
  49 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  50 X-Brightmail-Tracker:\r
  51  H4sIAAAAAAAAA+NgFmpkleLIzCtJLcpLzFFi42IR4hRV1s02PhlgMPWkpsXquTwW12/OZHZg\r
  52         8tg56y67x7NVt5gDmKK4bFJSczLLUov07RK4Mo4f+MJc8F+sYvrfmgbG54JdjJwcEgImEpuf\r
  53         NTND2GISF+6tZ+ti5OIQEtjHKLHh10lWCGcDo8SFG/uZIZyLTBLrO8+yg7QICSxhlJjTBTSK\r
  54         g4NFQFXiWIcGSJhNQENi2/7ljCC2iICOxO1DC8DKmQWkJb79bmYCsYUFDCQW/lgGVsMroC1x\r
  55         /NEHqM0djBIfLy9lhkgISpyc+YQFollL4sa/l0wgu0AGLf/HARLmBNp1te8L2HxRARWJKSe3\r
  56         sU1gFJqFpHsWku5ZCN0LGJlXMcqm5Fbp5iZm5hSnJusWJyfm5aUW6Rrq5WaW6KWmlG5iBIe0\r
  57         JM8OxjcHlQ4xCnAwKvHwXnh5PECINbGsuDL3EKMkB5OSKK+q0ckAIb6k/JTKjMTijPii0pzU\r
  58         4kOMEhzMSiK8ZbpAOd6UxMqq1KJ8mJQ0B4uSOO/llJv+QgLpiSWp2ampBalFMFkZDg4lCd7b\r
  59         hkCNgkWp6akVaZk5JQhpJg5OkOE8QMNfgtTwFhck5hZnpkPkTzEqSonz7gdJCIAkMkrz4Hph\r
  60         KecVozjQK8K8T0CqeIDpCq77FdBgJqDBcZeOgwwuSURISTUwTg6L+e3H8efg/fBCkYiMQmNO\r
  61         je6T3JPmhXwqXx+o+yBt8mI55ceO5nwSeRqP9ETXTLi5IPzT3rxrB29NnhYT8HZP3J7In5tc\r
  62         YlxuhmwQlsrcxRo1MWhp5m3Zr4mRFp1/LPcFG2106HadsSXFjfHk5mnb7199UfDI5vg/4xL+\r
  63         k+WLmL2VvTJKlViKMxINtZiLihMBzK1wsxQDAAA=\r
  64 Cc: notmuch@notmuchmail.org\r
  65 X-BeenThere: notmuch@notmuchmail.org\r
  66 X-Mailman-Version: 2.1.13\r
  67 Precedence: list\r
  68 List-Id: "Use and development of the notmuch mail system."\r
  69         <notmuch.notmuchmail.org>\r
  70 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  72 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  73 List-Post: <mailto:notmuch@notmuchmail.org>\r
  74 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  75 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  77 X-List-Received-Date: Thu, 13 Dec 2012 01:46:20 -0000\r
  78 \r
  79 Quoth Mark Walters on Dec 08 at  9:29 am:\r
  80 > \r
  81 > Hi\r
  82 > \r
  83 > Overall this series looks good. As we discussed on irc I think i would\r
  84 > prefer global NOTMUCH_SCHEMA_MIN as I am a little worried about these\r
  85 > proliferating (eg if someone decides text output also needs versioning\r
  86 > etc) In addition, if we do find the distinction useful it would be easy\r
  87 > to add at a later date.\r
  88 \r
  89 Will do.\r
  90 \r
  91 > One tiny comment on the manpage updates: now that you mention two return\r
  92 > values explicitly should the other possibilities be mentioned too or are\r
  93 > they so obvious it is not needed?\r
  94 \r
  95 I thought about this, but couldn't figure out what to say for exit\r
  96 status 1 other than "Unspecified error".  Hence I carefully worded the\r
  97 man page to say *special* exit status codes.\r
  98 \r
  99 > Would it be worth having some emacs test for the error handling? (eg set\r
 100 > notmuch-command to something giving some stderr and an error) Inherently\r
 101 > these code paths won't be tested much so I think tests could be\r
 102 > particularly useful.\r
 103 \r
 104 Good idea.\r
 105 \r
 106 > Best wishes\r
 107 > \r
 108 > Mark\r
 109 > \r
 110 > \r
 111 > \r
 112 > \r
 113 > \r
 114 > \r
 115 > On Mon, 03 Dec 2012, Austin Clements <amdragon@MIT.EDU> wrote:\r
 116 > > (Sorry; I forgot to include a cover letter.)\r
 117 > >\r
 118 > > This series is intended to help with our long-standing output format\r
 119 > > versioning issue.  While the JSON format is amenable to extension,\r
 120 > > there's still a high barrier to extensions because of the need to\r
 121 > > support them going forward, and an even higher barrier to modifications\r
 122 > > that break backwards compatibility.  Versioning will make the format\r
 123 > > more dynamic, enabling us to easily improve and iterate on it.  It will\r
 124 > > also address the slew of confusing bugs that people encounter when they\r
 125 > > use a mismatched CLI and front-end.\r
 126 > >\r
 127 > > On IRC we've talking about adding version information to the output\r
 128 > > format itself.  This series takes a different and, I think, better\r
 129 > > approach: callers request a specific output format version on the\r
 130 > > command line.  This allows notmuch to remain backwards compatible with\r
 131 > > older format versions when it's easy or necessary.  This also doesn't\r
 132 > > require shoehorning a version number into the output, which would be\r
 133 > > awkward for both the CLI and the consumer.\r
 134 > >\r
 135 > > I called the argument --use-schema, but I'm open to other suggestions.\r
 136 > > --use-schema is technically accurate, but perhaps not as self-describing\r
 137 > > as something like --schema-version or --format-version (to parallel\r
 138 > > --format).\r
 139 > > _______________________________________________\r
 140 > > notmuch mailing list\r
 141 > > notmuch@notmuchmail.org\r
 142 > > http://notmuchmail.org/mailman/listinfo/notmuch\r
 143 \r
 144 -- \r
 145 Austin Clements                                      MIT/'06/PhD/CSAIL\r
 146 amdragon@mit.edu                           http://web.mit.edu/amdragon\r
 147        Somewhere in the dream we call reality you will find me,\r
 148               searching for the reality we call dreams.\r