f8/84049f28ce0070be7a192f40015453bfb3b0d0

   1 Return-Path: <eg@gaute.vetsj.com>\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 609806DE0A94\r
   6  for <notmuch@notmuchmail.org>; Sun,  7 Feb 2016 02:14:15 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at cworth.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.29\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.29 tagged_above=-999 required=5 tests=[AWL=0.411, \r
  12  DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_LOW=-0.7,\r
  13  RCVD_IN_MSPIKE_H2=-0.001] autolearn=disabled\r
  14 Received: from arlo.cworth.org ([127.0.0.1])\r
  15  by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16  with ESMTP id nGB4_PZqv8DL for <notmuch@notmuchmail.org>;\r
  17  Sun,  7 Feb 2016 02:14:13 -0800 (PST)\r
  18 Received: from mail-lb0-f176.google.com (mail-lb0-f176.google.com\r
  19  [209.85.217.176])\r
  20  by arlo.cworth.org (Postfix) with ESMTPS id E36CC6DE0A7F\r
  21  for <notmuch@notmuchmail.org>; Sun,  7 Feb 2016 02:14:12 -0800 (PST)\r
  22 Received: by mail-lb0-f176.google.com with SMTP id x4so70878959lbm.0\r
  23  for <notmuch@notmuchmail.org>; Sun, 07 Feb 2016 02:14:12 -0800 (PST)\r
  24 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25  d=gaute-vetsj-com.20150623.gappssmtp.com; s=20150623;\r
  26  h=date:from:subject:to:references:in-reply-to:user-agent:message-id\r
  27  :mime-version:content-type:content-transfer-encoding;\r
  28  bh=iNvc3N3dRxG0otTg9KxrxGHz8AyQ1izys++x1tSgm3s=;\r
  29  b=P4BmMxuFUHnEcgum40eiSidvG/Qm4mr/HCwqGpBS2ZtxheL3qfGy5YOA3F38LJcJbX\r
  30  zNIEtE13aGILh/V53gHmlhyH6QP88mMxl5o1gHwsXU+1aMJPKz8Qm4PKKncUOdk405mF\r
  31  uNvcYv42B1sVz8YpCKpjg0GK9OuRQJd7VK1l2LOYbAaCBwZl09bB33GJg4ynaUXKt1xE\r
  32  E4go1/29n31BKl5U1e7jAzv1VLS2Cf5LuPxBC5Zs0PH6WkJYI5zh6aK1B9eelwhco6st\r
  33  UEMOowgDGj5kxKZj/eFMTRtgaPa8nBn5wMGzmrjIJj/7kD340HhUBU3n1o14HlL1MP0+\r
  34  vxdQ==\r
  35 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  36  d=1e100.net; s=20130820;\r
  37  h=x-gm-message-state:date:from:subject:to:references:in-reply-to\r
  38  :user-agent:message-id:mime-version:content-type\r
  39  :content-transfer-encoding;\r
  40  bh=iNvc3N3dRxG0otTg9KxrxGHz8AyQ1izys++x1tSgm3s=;\r
  41  b=SzC0kUEjmGedtxWb4kcVFlc6kDhcNwUZkbDGkfPkyjZ9FxnSXu3TCH1hoTn7Jgwhnz\r
  42  7QIXMhjj1S+VPOaSbrguEsSts9Gpvb6Q0qvGPwCDzm6lqqjcKSit5tbfguldC7kDF9pl\r
  43  kg9u+y8c7Vbg/jmHnehbV4M4m5hxcFo7BaU2wrutW8OHELt6zmUp3M287zslpB1NOWKg\r
  44  wbbWqtH0V7epSCl8z0tlPAScpIgAsizk3gZE8s/eTbmvuYGRJazJq8LKUz0P/CSXdMoe\r
  45  zSPCEQNwWtIfuPHzspKfMesieR8RQEaC1FurrGJPeMVtScoYbfE1b720zsBWz70EtRLJ\r
  46  4meg==\r
  47 X-Gm-Message-State:\r
  48  AG10YORzwnpH2Bxmtc/g2dq60q1Zvu1QDehlpJl/aVcp8uRgvV7fByd+NyqqNKAHp91KiA==\r
  49 X-Received: by 10.112.161.131 with SMTP id xs3mr9205195lbb.65.1454840051295;\r
  50  Sun, 07 Feb 2016 02:14:11 -0800 (PST)\r
  51 Received: from localhost (c6878BF51.dhcp.as2116.net. [81.191.120.104])\r
  52  by smtp.gmail.com with ESMTPSA id a67sm3318677lfe.6.2016.02.07.02.14.10\r
  53  for <notmuch@notmuchmail.org>\r
  54  (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);\r
  55  Sun, 07 Feb 2016 02:14:10 -0800 (PST)\r
  56 Date: Sun, 07 Feb 2016 10:14:09 +0000\r
  57 From: Gaute Hope <eg@gaute.vetsj.com>\r
  58 Subject: Re: api-doc: return status for notmuch_query_search_threads_st ...\r
  59 To: notmuch@notmuchmail.org\r
  60 References: <1454839405-astroid-0-pyvwjk7jt8-6563@strange>\r
  61 In-Reply-To: <1454839405-astroid-0-pyvwjk7jt8-6563@strange>\r
  62 User-Agent: astroid/v0.5 (https://github.com/gauteh/astroid)\r
  63 Message-Id: <1454839957-astroid-3-etu8luubzc-6563@strange>\r
  64 MIME-Version: 1.0\r
  65 Content-Type: text/plain; charset=utf-8; format=flowed\r
  66 Content-Transfer-Encoding: quoted-printable\r
  67 X-BeenThere: notmuch@notmuchmail.org\r
  68 X-Mailman-Version: 2.1.20\r
  69 Precedence: list\r
  70 List-Id: "Use and development of the notmuch mail system."\r
  71  <notmuch.notmuchmail.org>\r
  72 List-Unsubscribe: <https://notmuchmail.org/mailman/options/notmuch>,\r
  73  <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  74 List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
  75 List-Post: <mailto:notmuch@notmuchmail.org>\r
  76 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  77 List-Subscribe: <https://notmuchmail.org/mailman/listinfo/notmuch>,\r
  78  <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  79 X-List-Received-Date: Sun, 07 Feb 2016 10:14:15 -0000\r
  80 \r
  81 Gaute Hope writes on February 7, 2016 11:06:\r
  82 > Hi,\r
  83 >=20\r
  84 > I am switching from the deprecated notmuch_query_search_threads to\r
  85 > notmuch_query_search_threads_st, but the api-documentation does not\r
  86 > specify what status values are returned and what they mean.\r
  87 >=20\r
  88 > The same goes for notmuch_query_search_messages_st (...).\r
  89 \r
  90 Indeed the typical usage section is also outdated (for both):\r
  91 \r
  92 ```\r
  93 notmuch_query_t *query;\r
  94 notmuch_messages_t *messages;\r
  95 notmuch_message_t *message;\r
  96 \r
  97 query =3D notmuch_query_create (database, query_string);\r
  98 \r
  99 for (messages =3D notmuch_query_search_messages (query);\r
 100      notmuch_messages_valid (messages);\r
 101      notmuch_messages_move_to_next (messages))\r
 102 {\r
 103     message =3D notmuch_messages_get (messages);\r
 104     ....\r
 105     notmuch_message_destroy (message);\r
 106 }\r
 107 \r
 108 notmuch_query_destroy (query);\r
 109 ```\r
 110 \r
 111 -gaute\r
 112 =\r