70/eec171b4c00c8fd001ffdfd1214d9f4b3fb617

   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 036A6431FD4\r
   6         for <notmuch@notmuchmail.org>; Mon,  7 Oct 2013 15:34:08 -0700 (PDT)\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 oOcPyqvf1YcN for <notmuch@notmuchmail.org>;\r
  16         Mon,  7 Oct 2013 15:34:03 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu\r
  18         [18.7.68.35])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 2BB71431FD5\r
  20         for <notmuch@notmuchmail.org>; Mon,  7 Oct 2013 15:33:37 -0700 (PDT)\r
  21 X-AuditID: 12074423-b7fc98e0000009a2-0d-525336c05c6c\r
  22 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43])\r
  23         by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id A5.7B.02466.0C633525; Mon,  7 Oct 2013 18:33:36 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11])\r
  26         by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r97MXPJm024576; \r
  27         Mon, 7 Oct 2013 18:33:26 -0400\r
  28 Received: from drake.dyndns.org (26-4-172.dynamic.csail.mit.edu [18.26.4.172])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r97MXNRq028499\r
  32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  33         Mon, 7 Oct 2013 18:33:25 -0400\r
  34 Received: from amthrax by drake.dyndns.org with local (Exim 4.77)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1VTJMh-0006bj-Jf; Mon, 07 Oct 2013 18:33:23 -0400\r
  37 From: Austin Clements <amdragon@MIT.EDU>\r
  38 To: notmuch@notmuchmail.org\r
  39 Subject: [PATCH 02/11] cli: Separate current and deprecated format version\r
  40 Date: Mon,  7 Oct 2013 18:33:12 -0400\r
  41 Message-Id: <1381185201-25197-3-git-send-email-amdragon@mit.edu>\r
  42 X-Mailer: git-send-email 1.8.4.rc3\r
  43 In-Reply-To: <1381185201-25197-1-git-send-email-amdragon@mit.edu>\r
  44 References: <1381185201-25197-1-git-send-email-amdragon@mit.edu>\r
  45 X-Brightmail-Tracker:\r
  46  H4sIAAAAAAAAA+NgFtrMIsWRmVeSWpSXmKPExsUixCmqrXvALDjI4O8Wa4vrN2cyOzB6PFt1\r
  47         izmAMYrLJiU1J7MstUjfLoErY9aza+wFD/gqFlxpZm5g/MXdxcjJISFgIvFr4Xk2CFtM4sK9\r
  48         9UA2F4eQwD5GiR/TG5khnA2MEg+eHIRyDjNJXFuwAsqZyyixufcRC0g/m4CGxLb9yxlBbBEB\r
  49         aYmdd2ezdjFycDALqEn86VIBCQsLeEk8/jwfrJxFQFWiu68bbDWvgIPEpX3rWCDOUJJYeGob\r
  50         K4jNKeAosWTjRbAaIaCaufsXsU5g5F/AyLCKUTYlt0o3NzEzpzg1Wbc4OTEvL7VI10wvN7NE\r
  51         LzWldBMjKGzYXZR3MP45qHSIUYCDUYmHN+NoUJAQa2JZcWXuIUZJDiYlUd4HxsFBQnxJ+SmV\r
  52         GYnFGfFFpTmpxYcYJTiYlUR4BYyAcrwpiZVVqUX5MClpDhYlcd5bHPZBQgLpiSWp2ampBalF\r
  53         MFkZDg4lCd4wU6BGwaLU9NSKtMycEoQ0EwcnyHAeoOHJIDW8xQWJucWZ6RD5U4yKUuK8s0ES\r
  54         AiCJjNI8uF5YXL9iFAd6RZh3K0gVDzAlwHW/AhrMBDRYlz0QZHBJIkJKqoFRN2Lr1KmMX3av\r
  55         mmq3TfThsscSwChcJx4ftHCO/OLNqRw3lf/OT1FYMK1olsy5s4eEzLd6TfMtbbyWVHWZbc4m\r
  56         85LaVqbVsfHhiVkPfI9/bNWYUmtuOy/004P7cXNEuzhKT5xdsvytV8jSfK3QigOxszTnNC99\r
  57         Uit/Oba43EDt9bspKReDyg8rsRRnJBpqMRcVJwIAEmJTBcYCAAA=\r
  58 X-BeenThere: notmuch@notmuchmail.org\r
  59 X-Mailman-Version: 2.1.13\r
  60 Precedence: list\r
  61 List-Id: "Use and development of the notmuch mail system."\r
  62         <notmuch.notmuchmail.org>\r
  63 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  64         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  65 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  66 List-Post: <mailto:notmuch@notmuchmail.org>\r
  67 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  68 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  69         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  70 X-List-Received-Date: Mon, 07 Oct 2013 22:34:08 -0000\r
  71 \r
  72 Previously, the CLI would print a deprecation warning if a client\r
  73 requested any format version other than the current one.  However, if\r
  74 we add fields that are backwards-compatible, but want clients to be\r
  75 able to depend on, we need to bump the version, but that doesn't make\r
  76 the older version deprecated.\r
  77 \r
  78 Hence, separate out the "minimum active" version and only print a\r
  79 warning for requests below this version number.\r
  80 ---\r
  81  notmuch-client.h | 5 +++++\r
  82  notmuch.c        | 2 +-\r
  83  2 files changed, 6 insertions(+), 1 deletion(-)\r
  84 \r
  85 diff --git a/notmuch-client.h b/notmuch-client.h\r
  86 index afb0ddf..8d986f4 100644\r
  87 --- a/notmuch-client.h\r
  88 +++ b/notmuch-client.h\r
  89 @@ -142,6 +142,11 @@ chomp_newline (char *str)\r
  90  /* The minimum supported structured output format version.  Requests\r
  91   * for format versions below this will return an error. */\r
  92  #define NOTMUCH_FORMAT_MIN 1\r
  93 +/* The minimum non-deprecated structured output format version.\r
  94 + * Requests for format versions below this will print a stern warning.\r
  95 + * Must be >= NOTMUCH_FORMAT_MIN and < NOTMUCH_FORMAT_CUR.\r
  96 + */\r
  97 +#define NOTMUCH_FORMAT_MIN_ACTIVE 1\r
  98  \r
  99  /* The output format version requested by the caller on the command\r
 100   * line.  If no format version is requested, this will be set to\r
 101 diff --git a/notmuch.c b/notmuch.c\r
 102 index 7300c21..6588003 100644\r
 103 --- a/notmuch.c\r
 104 +++ b/notmuch.c\r
 105 @@ -125,7 +125,7 @@ by the notmuch CLI (it requires at least version %d).  You may need to\n\\r
 106  upgrade your notmuch front-end.\n",\r
 107                  notmuch_format_version, NOTMUCH_FORMAT_MIN);\r
 108         exit (NOTMUCH_EXIT_FORMAT_TOO_OLD);\r
 109 -    } else if (notmuch_format_version != NOTMUCH_FORMAT_CUR) {\r
 110 +    } else if (notmuch_format_version < NOTMUCH_FORMAT_MIN_ACTIVE) {\r
 111         /* Warn about old version requests so compatibility issues are\r
 112          * less likely when we drop support for a deprecated format\r
 113          * versions. */\r
 114 -- \r
 115 1.8.4.rc3\r
 116 \r