1 Return-Path: <eg@gaute.vetsj.com>
\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 24893431FBD
\r
6 for <notmuch@notmuchmail.org>; Wed, 10 Sep 2014 00:23:34 -0700 (PDT)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\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 4oKDAAJdh7G3 for <notmuch@notmuchmail.org>;
\r
16 Wed, 10 Sep 2014 00:23:28 -0700 (PDT)
\r
17 Received: from mail-la0-f47.google.com (mail-la0-f47.google.com
\r
18 [209.85.215.47]) (using TLSv1 with cipher RC4-SHA (128/128 bits))
\r
19 (No client certificate requested)
\r
20 by olra.theworths.org (Postfix) with ESMTPS id C3ED6431FBC
\r
21 for <notmuch@notmuchmail.org>; Wed, 10 Sep 2014 00:23:27 -0700 (PDT)
\r
22 Received: by mail-la0-f47.google.com with SMTP id q1so1249328lam.20
\r
23 for <notmuch@notmuchmail.org>; Wed, 10 Sep 2014 00:23:24 -0700 (PDT)
\r
24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
\r
25 d=1e100.net; s=20130820;
\r
26 h=x-gm-message-state:from:to:cc:subject:date:message-id;
\r
27 bh=8THwH1TqJi8m4jqXuuyPoU11Px34PTy8icmfKvGrMAI=;
\r
28 b=jgYTjmyitE/0xmFLgiYyIjvzZVTKc1v17vgQOYX1utA3ROiCZTlN4D4CWy3jLeTcNx
\r
29 YZrReIZ/eAr5I+7b9iU8H+Sj18SDXbcsQuLZc0Aw0eea+ydI25F7TYU4ZL86DvWbh+WX
\r
30 wMtmPCLWB+y4cKoMnxTBUu6gXToRkHe8lAgZ/QZAM/+cBBE783K7PUMJzMYfvenGOGbN
\r
31 d2AbKnsbeAezK+Q6xgCTy49oTTeKWfGL07RwidlaPPdNJPQVeU0Tv5F+Qmsy2hoPuuu9
\r
32 ytmV9Y4WnZcGq21oUfjw8lietudUHxAbl8GsO438KpY+Jm3neShhAc0JaMTFc/ebilN1
\r
35 ALoCoQltkEmhvYTqV5GO+kOgz8oMz5SNzAKE5dScuzNzS5+YAATqOnKbTftoPeiWqkyns1yQ/+3a
\r
36 X-Received: by 10.112.148.133 with SMTP id ts5mr38591173lbb.45.1410333802903;
\r
37 Wed, 10 Sep 2014 00:23:22 -0700 (PDT)
\r
38 Received: from localhost (cD572BF51.dhcp.as2116.net. [81.191.114.213])
\r
39 by mx.google.com with ESMTPSA id ue4sm5340499lbc.0.2014.09.10.00.23.21
\r
40 for <multiple recipients>
\r
41 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
\r
42 Wed, 10 Sep 2014 00:23:22 -0700 (PDT)
\r
43 From: Gaute Hope <eg@gaute.vetsj.com>
\r
44 To: notmuch@notmuchmail.org
\r
45 Subject: [PATCH] notmuch_thread_get_authors: document match grouping with |
\r
46 Date: Wed, 10 Sep 2014 09:24:18 +0200
\r
47 Message-Id: <1410333858-14573-1-git-send-email-eg@gaute.vetsj.com>
\r
48 X-Mailer: git-send-email 2.1.0
\r
49 X-BeenThere: notmuch@notmuchmail.org
\r
50 X-Mailman-Version: 2.1.13
\r
52 List-Id: "Use and development of the notmuch mail system."
\r
53 <notmuch.notmuchmail.org>
\r
54 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
55 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
56 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
57 List-Post: <mailto:notmuch@notmuchmail.org>
\r
58 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
59 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
60 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
61 X-List-Received-Date: Wed, 10 Sep 2014 07:23:34 -0000
\r
63 as stated in thread.cc:115
\r
65 /* Construct an authors string from matched_authors_array and
\r
66 * authors_array. The string contains matched authors first, then
\r
67 * non-matched authors (with the two groups separated by '|'). Within
\r
68 * each group, authors are listed in date order. */
\r
70 this is, however, not reflected in the public API documentation in
\r
71 notmuch.h:970. This patch a paragraph explaining how | separates the
\r
72 group of authors of messages matching the query and those of messages
\r
73 that do not, but are still contained in the thread.
\r
75 lib/notmuch.h | 4 ++++
\r
76 1 file changed, 4 insertions(+)
\r
78 diff --git a/lib/notmuch.h b/lib/notmuch.h
\r
79 index 21a5225..fe2340b 100644
\r
82 @@ -973,6 +973,10 @@ notmuch_thread_get_matched_messages (notmuch_thread_t *thread);
\r
83 * authors of mail messages in the query results that belong to this
\r
86 + * The string contains authors of messages matching the query first, then
\r
87 + * non-matched authors (with the two groups separated by '|'). Within
\r
88 + * each group, authors are ordered by date.
\r
90 * The returned string belongs to 'thread' and as such, should not be
\r
91 * modified by the caller and will only be valid for as long as the
\r
92 * thread is valid, (which is until notmuch_thread_destroy or until
\r