[PATCH v2 03/11] lib: Document extent of some return values
Austin Clements
amdragon at MIT.EDU
Thu Oct 24 08:19:03 PDT 2013
This documents the extent of the notmuch_messages_t* pointers returned
by notmuch_thread_get_toplevel_messages and
notmuch_thread_get_messages.
---
lib/notmuch.h | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/lib/notmuch.h b/lib/notmuch.h
index 9dab555..0fb7121 100644
--- a/lib/notmuch.h
+++ b/lib/notmuch.h
@@ -765,12 +765,16 @@ notmuch_thread_get_total_messages (notmuch_thread_t *thread);
* This iterator will not necessarily iterate over all of the messages
* in the thread. It will only iterate over the messages in the thread
* which are not replies to other messages in the thread.
+ *
+ * The returned list will be destroyed when the thread is destroyed.
*/
notmuch_messages_t *
notmuch_thread_get_toplevel_messages (notmuch_thread_t *thread);
/* Get a notmuch_thread_t iterator for all messages in 'thread' in
* oldest-first order.
+ *
+ * The returned list will be destroyed when the thread is destroyed.
*/
notmuch_messages_t *
notmuch_thread_get_messages (notmuch_thread_t *thread);
--
1.8.4.rc3
More information about the notmuch
mailing list