From: Gaute Hope Date: Sun, 7 Feb 2016 10:14:09 +0000 (+0000) Subject: Re: api-doc: return status for notmuch_query_search_threads_st ... X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=11644308ee96a46a450abaa12154dd1fe9e682e0;p=notmuch-archives.git Re: api-doc: return status for notmuch_query_search_threads_st ... --- diff --git a/f8/84049f28ce0070be7a192f40015453bfb3b0d0 b/f8/84049f28ce0070be7a192f40015453bfb3b0d0 new file mode 100644 index 000000000..c41c187f8 --- /dev/null +++ b/f8/84049f28ce0070be7a192f40015453bfb3b0d0 @@ -0,0 +1,112 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by arlo.cworth.org (Postfix) with ESMTP id 609806DE0A94 + for ; Sun, 7 Feb 2016 02:14:15 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at cworth.org +X-Spam-Flag: NO +X-Spam-Score: -0.29 +X-Spam-Level: +X-Spam-Status: No, score=-0.29 tagged_above=-999 required=5 tests=[AWL=0.411, + DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_LOW=-0.7, + RCVD_IN_MSPIKE_H2=-0.001] autolearn=disabled +Received: from arlo.cworth.org ([127.0.0.1]) + by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id nGB4_PZqv8DL for ; + Sun, 7 Feb 2016 02:14:13 -0800 (PST) +Received: from mail-lb0-f176.google.com (mail-lb0-f176.google.com + [209.85.217.176]) + by arlo.cworth.org (Postfix) with ESMTPS id E36CC6DE0A7F + for ; Sun, 7 Feb 2016 02:14:12 -0800 (PST) +Received: by mail-lb0-f176.google.com with SMTP id x4so70878959lbm.0 + for ; Sun, 07 Feb 2016 02:14:12 -0800 (PST) +DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; + d=gaute-vetsj-com.20150623.gappssmtp.com; s=20150623; + h=date:from:subject:to:references:in-reply-to:user-agent:message-id + :mime-version:content-type:content-transfer-encoding; + bh=iNvc3N3dRxG0otTg9KxrxGHz8AyQ1izys++x1tSgm3s=; + b=P4BmMxuFUHnEcgum40eiSidvG/Qm4mr/HCwqGpBS2ZtxheL3qfGy5YOA3F38LJcJbX + zNIEtE13aGILh/V53gHmlhyH6QP88mMxl5o1gHwsXU+1aMJPKz8Qm4PKKncUOdk405mF + uNvcYv42B1sVz8YpCKpjg0GK9OuRQJd7VK1l2LOYbAaCBwZl09bB33GJg4ynaUXKt1xE + E4go1/29n31BKl5U1e7jAzv1VLS2Cf5LuPxBC5Zs0PH6WkJYI5zh6aK1B9eelwhco6st + UEMOowgDGj5kxKZj/eFMTRtgaPa8nBn5wMGzmrjIJj/7kD340HhUBU3n1o14HlL1MP0+ + vxdQ== +X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; + d=1e100.net; s=20130820; + h=x-gm-message-state:date:from:subject:to:references:in-reply-to + :user-agent:message-id:mime-version:content-type + :content-transfer-encoding; + bh=iNvc3N3dRxG0otTg9KxrxGHz8AyQ1izys++x1tSgm3s=; + b=SzC0kUEjmGedtxWb4kcVFlc6kDhcNwUZkbDGkfPkyjZ9FxnSXu3TCH1hoTn7Jgwhnz + 7QIXMhjj1S+VPOaSbrguEsSts9Gpvb6Q0qvGPwCDzm6lqqjcKSit5tbfguldC7kDF9pl + kg9u+y8c7Vbg/jmHnehbV4M4m5hxcFo7BaU2wrutW8OHELt6zmUp3M287zslpB1NOWKg + wbbWqtH0V7epSCl8z0tlPAScpIgAsizk3gZE8s/eTbmvuYGRJazJq8LKUz0P/CSXdMoe + zSPCEQNwWtIfuPHzspKfMesieR8RQEaC1FurrGJPeMVtScoYbfE1b720zsBWz70EtRLJ + 4meg== +X-Gm-Message-State: + AG10YORzwnpH2Bxmtc/g2dq60q1Zvu1QDehlpJl/aVcp8uRgvV7fByd+NyqqNKAHp91KiA== +X-Received: by 10.112.161.131 with SMTP id xs3mr9205195lbb.65.1454840051295; + Sun, 07 Feb 2016 02:14:11 -0800 (PST) +Received: from localhost (c6878BF51.dhcp.as2116.net. [81.191.120.104]) + by smtp.gmail.com with ESMTPSA id a67sm3318677lfe.6.2016.02.07.02.14.10 + for + (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); + Sun, 07 Feb 2016 02:14:10 -0800 (PST) +Date: Sun, 07 Feb 2016 10:14:09 +0000 +From: Gaute Hope +Subject: Re: api-doc: return status for notmuch_query_search_threads_st ... +To: notmuch@notmuchmail.org +References: <1454839405-astroid-0-pyvwjk7jt8-6563@strange> +In-Reply-To: <1454839405-astroid-0-pyvwjk7jt8-6563@strange> +User-Agent: astroid/v0.5 (https://github.com/gauteh/astroid) +Message-Id: <1454839957-astroid-3-etu8luubzc-6563@strange> +MIME-Version: 1.0 +Content-Type: text/plain; charset=utf-8; format=flowed +Content-Transfer-Encoding: quoted-printable +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.20 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Sun, 07 Feb 2016 10:14:15 -0000 + +Gaute Hope writes on February 7, 2016 11:06: +> Hi, +>=20 +> I am switching from the deprecated notmuch_query_search_threads to +> notmuch_query_search_threads_st, but the api-documentation does not +> specify what status values are returned and what they mean. +>=20 +> The same goes for notmuch_query_search_messages_st (...). + +Indeed the typical usage section is also outdated (for both): + +``` +notmuch_query_t *query; +notmuch_messages_t *messages; +notmuch_message_t *message; + +query =3D notmuch_query_create (database, query_string); + +for (messages =3D notmuch_query_search_messages (query); + notmuch_messages_valid (messages); + notmuch_messages_move_to_next (messages)) +{ + message =3D notmuch_messages_get (messages); + .... + notmuch_message_destroy (message); +} + +notmuch_query_destroy (query); +``` + +-gaute +=