From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id B5B966DE023C for ; Mon, 17 Dec 2018 10:06:31 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: 0.362 X-Spam-Level: X-Spam-Status: No, score=0.362 tagged_above=-999 required=5 tests=[KHOP_DYNAMIC=0.001, RDNS_DYNAMIC=0.363, SPF_HELO_PASS=-0.001, SPF_PASS=-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 SkLX2zj5FEBE for ; Mon, 17 Dec 2018 10:06:31 -0800 (PST) X-Greylist: delayed 511 seconds by postgrey-1.36 at arlo; Mon, 17 Dec 2018 10:06:30 PST Received: from porcupinefactory.org (91.218.216.54.siec.idealan.pl [91.218.216.54]) by arlo.cworth.org (Postfix) with ESMTPS id DE67F6DE00F5 for ; Mon, 17 Dec 2018 10:06:30 -0800 (PST) Received: from movable.Speedport_W_723V_1_46_000 (unknown [192.168.6.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by porcupinefactory.org (Postfix) with ESMTPSA id 64D0C675582; Mon, 17 Dec 2018 18:57:25 +0100 (CET) From: rhn To: notmuch@notmuchmail.org Cc: rhn Subject: [PATCH 1/3] lib: Explicitly state when replies will be destroyed Date: Mon, 17 Dec 2018 17:57:46 +0000 Message-Id: <20181217175748.10814-2-gihu.rhn@porcupinefactory.org> X-Mailer: git-send-email 2.17.2 In-Reply-To: <20181217175748.10814-1-gihu.rhn@porcupinefactory.org> References: <20181217175748.10814-1-gihu.rhn@porcupinefactory.org> X-Mailman-Approved-At: Mon, 17 Dec 2018 10:14:15 -0800 X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.29 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: Mon, 17 Dec 2018 18:06:31 -0000 Without an explicit guarantee, it's not clear how to use the reference. --- lib/notmuch.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/lib/notmuch.h b/lib/notmuch.h index 247f6ad7..aa032e09 100644 --- a/lib/notmuch.h +++ b/lib/notmuch.h @@ -1400,6 +1400,8 @@ notmuch_message_get_thread_id (notmuch_message_t *message); * If there are no replies to 'message', this function will return * NULL. (Note that notmuch_messages_valid will accept that NULL * value as legitimate, and simply return FALSE for it.) + * + * The returned list will be destroyed when the thread is destroyed. */ notmuch_messages_t * notmuch_message_get_replies (notmuch_message_t *message); -- 2.17.2