03/cceda4830a5662eda2388535326c08fa09377c

   1 Return-Path: <amdragon@mit.edu>\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 olra.theworths.org (Postfix) with ESMTP id DC16D421161\r
   6         for <notmuch@notmuchmail.org>; Thu, 24 Oct 2013 08:19:33 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id Do3b0VRLGNqs for <notmuch@notmuchmail.org>;\r
  16         Thu, 24 Oct 2013 08:19:29 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-8.mit.edu (dmz-mailsec-scanner-8.mit.edu\r
  18         [18.7.68.37])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 92FB5429E47\r
  20         for <notmuch@notmuchmail.org>; Thu, 24 Oct 2013 08:19:22 -0700 (PDT)\r
  21 X-AuditID: 12074425-b7f1c8e0000009c7-05-52693a7af5ad\r
  22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
  23         by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id F9.31.02503.A7A39625; Thu, 24 Oct 2013 11:19:22 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11])\r
  26         by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id r9OFJF9p012678; \r
  27         Thu, 24 Oct 2013 11:19:15 -0400\r
  28 Received: from drake.dyndns.org\r
  29         (216-15-114-40.c3-0.arl-ubr1.sbo-arl.ma.cable.rcn.com\r
  30         [216.15.114.40]) (authenticated bits=0)\r
  31         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  32         by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r9OFJC53012911\r
  33         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  34         Thu, 24 Oct 2013 11:19:14 -0400\r
  35 Received: from amthrax by drake.dyndns.org with local (Exim 4.77)\r
  36         (envelope-from <amdragon@mit.edu>)\r
  37         id 1VZMgq-0006dn-Na; Thu, 24 Oct 2013 11:19:12 -0400\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: notmuch@notmuchmail.org\r
  40 Subject: [PATCH v2 03/11] lib: Document extent of some return values\r
  41 Date: Thu, 24 Oct 2013 11:19:03 -0400\r
  42 Message-Id: <1382627951-25252-4-git-send-email-amdragon@mit.edu>\r
  43 X-Mailer: git-send-email 1.8.4.rc3\r
  44 In-Reply-To: <1382627951-25252-1-git-send-email-amdragon@mit.edu>\r
  45 References: <1382627951-25252-1-git-send-email-amdragon@mit.edu>\r
  46 X-Brightmail-Tracker:\r
  47  H4sIAAAAAAAAA+NgFjrKIsWRmVeSWpSXmKPExsUixCmqrFtllRlkcH2TpEXTdGeL1XN5LK7f\r
  48         nMnswOyxc9Zddo9b91+zezxbdYs5gDmKyyYlNSezLLVI3y6BK6Nz7ySWgvUcFcdaF7I1MH5g\r
  49         62Lk5JAQMJH49P8AlC0mceHeeiCbi0NIYB+jRNsBGGcjo8StqwvZIZw7TBK/L29ihXDmMkqc\r
  50         nPAdrJ9NQENi2/7ljCC2iIC0xM67s1lBbGaBaIkjl2cA1XBwCAu4SEz6XgcSZhFQlVjTcpMZ\r
  51         xOYVcJC48ew71BlKEgtPbQNr5RRwlPj5+hrYSCGgml+/z7BMYORfwMiwilE2JbdKNzcxM6c4\r
  52         NVm3ODkxLy+1SNdCLzezRC81pXQTIyi02F1UdzBOOKR0iFGAg1GJh7fhU3qQEGtiWXFl7iFG\r
  53         SQ4mJVHee6aZQUJ8SfkplRmJxRnxRaU5qcWHGCU4mJVEeKfpAeV4UxIrq1KL8mFS0hwsSuK8\r
  54         tzjsg4QE0hNLUrNTUwtSi2CyMhwcShK8/yyBGgWLUtNTK9Iyc0oQ0kwcnCDDeYCG3wOp4S0u\r
  55         SMwtzkyHyJ9iVJQS5+UFRq+QAEgiozQPrhcW+68YxYFeEeb9ANLOA0wbcN2vgAYzAQ2esiQN\r
  56         ZHBJIkJKqoGR79fzkhs7eqWlL6aFJ9/fPnX3fc4M/0Ltn8mv3XfG1zYVs8nkBau9+BYim1e6\r
  57         6YryYrHNocEPl6wq/+OVefU/X7f+7lzB0t3vNj33XuYacvjZ2i1brsTq3er0aHEMOOz5Were\r
  58         Qaag5hTm40Xbb0qkdS+cP++tRTSb6+ynn/uW3w2IfBh9dssdJZbijERDLeai4kQAPmBYZtgC        AAA=\r
  59 X-BeenThere: notmuch@notmuchmail.org\r
  60 X-Mailman-Version: 2.1.13\r
  61 Precedence: list\r
  62 List-Id: "Use and development of the notmuch mail system."\r
  63         <notmuch.notmuchmail.org>\r
  64 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  65         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  66 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  67 List-Post: <mailto:notmuch@notmuchmail.org>\r
  68 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  69 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  70         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  71 X-List-Received-Date: Thu, 24 Oct 2013 15:19:34 -0000\r
  72 \r
  73 This documents the extent of the notmuch_messages_t* pointers returned\r
  74 by notmuch_thread_get_toplevel_messages and\r
  75 notmuch_thread_get_messages.\r
  76 ---\r
  77  lib/notmuch.h | 4 ++++\r
  78  1 file changed, 4 insertions(+)\r
  79 \r
  80 diff --git a/lib/notmuch.h b/lib/notmuch.h\r
  81 index 9dab555..0fb7121 100644\r
  82 --- a/lib/notmuch.h\r
  83 +++ b/lib/notmuch.h\r
  84 @@ -765,12 +765,16 @@ notmuch_thread_get_total_messages (notmuch_thread_t *thread);\r
  85   * This iterator will not necessarily iterate over all of the messages\r
  86   * in the thread. It will only iterate over the messages in the thread\r
  87   * which are not replies to other messages in the thread.\r
  88 + *\r
  89 + * The returned list will be destroyed when the thread is destroyed.\r
  90   */\r
  91  notmuch_messages_t *\r
  92  notmuch_thread_get_toplevel_messages (notmuch_thread_t *thread);\r
  93  \r
  94  /* Get a notmuch_thread_t iterator for all messages in 'thread' in\r
  95   * oldest-first order.\r
  96 + *\r
  97 + * The returned list will be destroyed when the thread is destroyed.\r
  98   */\r
  99  notmuch_messages_t *\r
 100  notmuch_thread_get_messages (notmuch_thread_t *thread);\r
 101 -- \r
 102 1.8.4.rc3\r
 103 \r