22/a318fe99f017bd65ec49a6ab9e7ab6756b32da

   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 EBA51431FC0\r
   6         for <notmuch@notmuchmail.org>; Sat, 24 Nov 2012 20:57:19 -0800 (PST)\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 sYjC4unLnkr0 for <notmuch@notmuchmail.org>;\r
  16         Sat, 24 Nov 2012 20:57:19 -0800 (PST)\r
  17 Received: from dmz-mailsec-scanner-7.mit.edu (DMZ-MAILSEC-SCANNER-7.MIT.EDU\r
  18         [18.7.68.36])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 54DDD431FAF\r
  20         for <notmuch@notmuchmail.org>; Sat, 24 Nov 2012 20:57:19 -0800 (PST)\r
  21 X-AuditID: 12074424-b7fce6d000000925-36-50b1a52d07e5\r
  22 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36])\r
  23         by dmz-mailsec-scanner-7.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 70.DA.02341.D25A1B05; Sat, 24 Nov 2012 23:57:17 -0500 (EST)\r
  25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
  26         by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id qAP4vGEq023558; \r
  27         Sat, 24 Nov 2012 23:57:16 -0500\r
  28 Received: from drake.dyndns.org\r
  29         (209-6-116-242.c3-0.arl-ubr1.sbo-arl.ma.cable.rcn.com\r
  30         [209.6.116.242]) (authenticated bits=0)\r
  31         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  32         by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id qAP4vDVU000080\r
  33         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  34         Sat, 24 Nov 2012 23:57:16 -0500 (EST)\r
  35 Received: from amthrax by drake.dyndns.org with local (Exim 4.77)\r
  36         (envelope-from <amdragon@mit.edu>)\r
  37         id 1TcUHJ-0003Zj-QV; Sat, 24 Nov 2012 23:57:13 -0500\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: notmuch@notmuchmail.org\r
  40 Subject: [PATCH 0/6] API for iterating over all messages in a thread\r
  41 Date: Sat, 24 Nov 2012 23:57:01 -0500\r
  42 Message-Id: <1353819427-13182-1-git-send-email-amdragon@mit.edu>\r
  43 X-Mailer: git-send-email 1.7.10.4\r
  44 X-Brightmail-Tracker:\r
  45  H4sIAAAAAAAAA+NgFlrMIsWRmVeSWpSXmKPExsUixG6noqu7dGOAwZVGQYvVc3ksrt+cyezA\r
  46         5LFz1l12j2erbjEHMEVx2aSk5mSWpRbp2yVwZTxZYVgwiati58NlzA2M8zi6GDk5JARMJNrv\r
  47         bWKGsMUkLtxbz9bFyMUhJLCPUWLOptvMEM4GRonHtz6AVQkJPGKSmLumCiIxl1Hi8PStYAk2\r
  48         AQ2JbfuXM4LYIgLSEjvvzmYFsZkFZCV+nP8DZgsLuEj03zzKDmKzCKhKdDTNBOvlFXCQ6Jrb\r
  49         ywRxhqJE97MJbBMYeRcwMqxilE3JrdLNTczMKU5N1i1OTszLSy3SNdfLzSzRS00p3cQIDgsX\r
  50         lR2MzYeUDjEKcDAq8fDeSNwYIMSaWFZcmXuIUZKDSUmUN3MRUIgvKT+lMiOxOCO+qDQntfgQ\r
  51         owQHs5IIr7UqUI43JbGyKrUoHyYlzcGiJM57PeWmv5BAemJJanZqakFqEUxWhoNDSYJXZAlQ\r
  52         o2BRanpqRVpmTglCmomDE2Q4D9BwUZAa3uKCxNzizHSI/ClGRSlxXnOQhABIIqM0D64XFrev\r
  53         GMWBXhHmdQCp4gHGPFz3K6DBTECDn85eBzK4JBEhJdXAqPbxYOm+Uz/ZPwv8tGieMnevQ4Ks\r
  54         bGPVJv5j9z4w5RxnrXyza+eTJInbQmzXNihMeSNiWB4ud8dUcd8UM0eL5y4/9F7dvLz7kIuA\r
  55         9bzHqxqzpsxeN6PlGmPJnEPn4u/wCQf8OiGoPPF7jvIRtq71Uu/DeoUry2bV79swTefH2oCZ\r
  56         dl0HdrsHFimxFGckGmoxFxUnAgAsvMeotgIAAA==\r
  57 X-BeenThere: notmuch@notmuchmail.org\r
  58 X-Mailman-Version: 2.1.13\r
  59 Precedence: list\r
  60 List-Id: "Use and development of the notmuch mail system."\r
  61         <notmuch.notmuchmail.org>\r
  62 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  63         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  64 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  65 List-Post: <mailto:notmuch@notmuchmail.org>\r
  66 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  67 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  68         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  69 X-List-Received-Date: Sun, 25 Nov 2012 04:57:20 -0000\r
  70 \r
  71 This series adds a library API for iterating over all messages in a\r
  72 thread in sorted order.  This is easy for the library to provide and\r
  73 difficult to obtain from the current API.  Plus, if you don't count\r
  74 the code added to the bindings, this series is actually a net\r
  75 decrease of 4 lines of code because of simplifications it enables.\r
  76 \r
  77 Do we want the API to do more?  Currently it's very minimal, but I can\r
  78 imagine two ways it could be generalized.  It could take an argument\r
  79 to indicate which message list to return, which could be all messages,\r
  80 matched messages, top-level messages, or maybe even unmatched messages\r
  81 (possibly all in terms of message flags).  It could also take an\r
  82 argument indicating the desired sort order.  Currently, the caller can\r
  83 use existing message flag APIs to distinguish matched and unmatched\r
  84 messages and there's a separate function for the top-level messages.\r
  85 However, if the API could do all of these things, it would subsume\r
  86 various other API functions, such as notmuch_thread_get_*_date.\r
  87 \r
  88 Also, is this the right name for the new API?  In particular, if we do\r
  89 later want to add a function that returns, say, the list of matched\r
  90 messages, we'll have a convention collision with\r
  91 notmuch_thread_get_matched_messages, which returns only a count.\r
  92 \r