26/be56001df960300fbecefd0822cf94faef0879

   1 Return-Path: <bremner@tesseract.cs.unb.ca>\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 arlo.cworth.org (Postfix) with ESMTP id 82A6B6DE1557\r
   6  for <notmuch@notmuchmail.org>; Sun,  7 Jun 2015 08:04:11 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at cworth.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 0.225\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0.225 tagged_above=-999 required=5 tests=[AWL=0.215, \r
  12  T_HEADER_FROM_DIFFERENT_DOMAINS=0.01] autolearn=disabled\r
  13 Received: from arlo.cworth.org ([127.0.0.1])\r
  14  by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15  with ESMTP id cz30srmcgHGM for <notmuch@notmuchmail.org>;\r
  16  Sun,  7 Jun 2015 08:04:10 -0700 (PDT)\r
  17 Received: from mx.xen14.node3324.gplhost.com (gitolite.debian.net\r
  18  [87.98.215.224])\r
  19  by arlo.cworth.org (Postfix) with ESMTPS id D695F6DE15C9\r
  20  for <notmuch@notmuchmail.org>; Sun,  7 Jun 2015 08:04:09 -0700 (PDT)\r
  21 Received: from remotemail by mx.xen14.node3324.gplhost.com with local (Exim\r
  22  4.80) (envelope-from <bremner@tesseract.cs.unb.ca>)\r
  23  id 1Z1c6f-0004ok-16; Sun, 07 Jun 2015 15:03:25 +0000\r
  24 Received: (nullmailer pid 7852 invoked by uid 1000); Sun, 07 Jun 2015\r
  25  15:02:11 -0000\r
  26 From: David Bremner <david@tethera.net>\r
  27 To: notmuch@notmuchmail.org\r
  28 Subject: [PATCH 02/10] lib: deprecate notmuch_query_search_{threads, messages}\r
  29 Date: Sun,  7 Jun 2015 17:01:55 +0200\r
  30 Message-Id: <1433689323-7520-3-git-send-email-david@tethera.net>\r
  31 X-Mailer: git-send-email 2.1.4\r
  32 In-Reply-To: <1433689323-7520-1-git-send-email-david@tethera.net>\r
  33 References: <1433689323-7520-1-git-send-email-david@tethera.net>\r
  34 X-BeenThere: notmuch@notmuchmail.org\r
  35 X-Mailman-Version: 2.1.18\r
  36 Precedence: list\r
  37 List-Id: "Use and development of the notmuch mail system."\r
  38  <notmuch.notmuchmail.org>\r
  39 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  40  <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  41 List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
  42 List-Post: <mailto:notmuch@notmuchmail.org>\r
  43 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  44 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  45  <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  46 X-List-Received-Date: Sun, 07 Jun 2015 15:04:11 -0000\r
  47 \r
  48 The CLI (and bindings) code should really be updated to use the new\r
  49 status-code-returning versions. Here are some warnings to prod us (and\r
  50 other clients) to do so.\r
  51 ---\r
  52  lib/notmuch.h | 41 ++++++++++++++++++++++++++---------------\r
  53  1 file changed, 26 insertions(+), 15 deletions(-)\r
  54 \r
  55 diff --git a/lib/notmuch.h b/lib/notmuch.h\r
  56 index 6a69f31..c2ada4b 100644\r
  57 --- a/lib/notmuch.h\r
  58 +++ b/lib/notmuch.h\r
  59 @@ -809,20 +809,25 @@ notmuch_query_add_tag_exclude (notmuch_query_t *query, const char *tag);\r
  60   * notmuch_threads_destroy function, but there's no good reason\r
  61   * to call it if the query is about to be destroyed).\r
  62   *\r
  63 - * If a Xapian exception occurs this function will return NULL.\r
  64 - * For better error reporting, use the _st variant.\r
  65 - */\r
  66 -notmuch_threads_t *\r
  67 -notmuch_query_search_threads (notmuch_query_t *query);\r
  68 -\r
  69 -/**\r
  70 - * Like notmuch_query_search_threads, but with a status return.\r
  71   */\r
  72  notmuch_status_t\r
  73  notmuch_query_search_threads_st (notmuch_query_t *query,\r
  74                                  notmuch_threads_t **out);\r
  75  \r
  76  /**\r
  77 + * Like notmuch_query_search_threads_st, but without a status return.\r
  78 + *\r
  79 + * If a Xapian exception occurs this function will return NULL.\r
  80 + *\r
  81 + * @deprecated Deprecated as of libnotmuch 4.3 (notmuch 0.21). Please\r
  82 + * use notmuch_query_search_threads_st instead.\r
  83 + *\r
  84 + */\r
  85 +NOTMUCH_DEPRECATED(4,3)\r
  86 +notmuch_threads_t *\r
  87 +notmuch_query_search_threads (notmuch_query_t *query);\r
  88 +\r
  89 +/**\r
  90   * Execute a query for messages, returning a notmuch_messages_t object\r
  91   * which can be used to iterate over the results. The returned\r
  92   * messages object is owned by the query and as such, will only be\r
  93 @@ -860,17 +865,23 @@ notmuch_query_search_threads_st (notmuch_query_t *query,\r
  94   * reason to call it if the query is about to be destroyed).\r
  95   *\r
  96   * If a Xapian exception occurs this function will return NULL.\r
  97 - * For better error reporting, use the _st variant.\r
  98 - */\r
  99 -notmuch_messages_t *\r
 100 -notmuch_query_search_messages (notmuch_query_t *query);\r
 101 -\r
 102 -/**\r
 103 - * Like notmuch_query_search_messages, but with a status return.\r
 104 + *\r
 105   */\r
 106  notmuch_status_t\r
 107  notmuch_query_search_messages_st (notmuch_query_t *query,\r
 108                                   notmuch_messages_t **out);\r
 109 +/**\r
 110 + * Like notmuch_query_search_messages, but without a status return.\r
 111 + *\r
 112 + * If a Xapian exception occurs this function will return NULL.\r
 113 + *\r
 114 + * @deprecated Deprecated as of libnotmuch 4.3 (notmuch 0.21). Please use\r
 115 + * notmuch_query_search_messages_st instead.\r
 116 + *\r
 117 + */\r
 118 +NOTMUCH_DEPRECATED(4,3)\r
 119 +notmuch_messages_t *\r
 120 +notmuch_query_search_messages (notmuch_query_t *query);\r
 121  \r
 122  /**\r
 123   * Destroy a notmuch_query_t along with any associated resources.\r
 124 -- \r
 125 2.1.4\r
 126 \r