9c/9a9fc0f5da7625af2fc3453a23ff0d93462581

   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 34C79431FD0\r
   6         for <notmuch@notmuchmail.org>; Mon, 12 Aug 2013 11:40:59 -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 DX+DxqMv2KUi for <notmuch@notmuchmail.org>;\r
  16         Mon, 12 Aug 2013 11:40:53 -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 DFFEA431FAF\r
  20         for <notmuch@notmuchmail.org>; Mon, 12 Aug 2013 11:40:52 -0700 (PDT)\r
  21 X-AuditID: 12074425-b7f0c8e000000953-9f-52092c34f7bb\r
  22 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43])\r
  23         by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 09.BF.02387.43C29025; Mon, 12 Aug 2013 14:40:52 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11])\r
  26         by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r7CIepwH029101; \r
  27         Mon, 12 Aug 2013 14:40:51 -0400\r
  28 Received: from drake.dyndns.org (26-4-172.dynamic.csail.mit.edu [18.26.4.172])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r7CIemSB003741\r
  32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  33         Mon, 12 Aug 2013 14:40:50 -0400\r
  34 Received: from amthrax by drake.dyndns.org with local (Exim 4.77)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1V8x2u-0005yU-K1; Mon, 12 Aug 2013 14:40:48 -0400\r
  37 From: Austin Clements <amdragon@MIT.EDU>\r
  38 To: notmuch@notmuchmail.org\r
  39 Subject: [PATCH 1/6] lib: Correct out-of-date doc comment\r
  40 Date: Mon, 12 Aug 2013 14:40:34 -0400\r
  41 Message-Id: <1376332839-22825-2-git-send-email-amdragon@mit.edu>\r
  42 X-Mailer: git-send-email 1.7.10.4\r
  43 In-Reply-To: <1376332839-22825-1-git-send-email-amdragon@mit.edu>\r
  44 References: <1376332839-22825-1-git-send-email-amdragon@mit.edu>\r
  45 X-Brightmail-Tracker:\r
  46  H4sIAAAAAAAAA+NgFtrIIsWRmVeSWpSXmKPExsUixCmqrWuiwxlkMOeVvMX1mzOZHRg9nq26\r
  47         xRzAGMVlk5Kak1mWWqRvl8CVMeXBP7aCuRwVD7/tZm9gPMnWxcjJISFgIrFl62x2CFtM4sK9\r
  48         9UBxLg4hgX2MElvbFzBDOBsZJU5s7mEEqRISOMIksXy5JURiLqPE9dNdYO1sAhoS2/YvBysS\r
  49         EZCW2Hl3NmsXIwcHs4CaxJ8uFRBTWMBS4tVKeZAKFgFViTv3t4B18go4SEy8/5cZ4ghFie5n\r
  50         E8CO4xRwlLi//BwLxFoHiY27ehgnMPIvYGRYxSibklulm5uYmVOcmqxbnJyYl5dapGuhl5tZ\r
  51         opeaUrqJERQy7C6qOxgnHFI6xCjAwajEw5vxkSNIiDWxrLgy9xCjJAeTkijvJE3OICG+pPyU\r
  52         yozE4oz4otKc1OJDjBIczEoivFtYgXK8KYmVValF+TApaQ4WJXHe50/PBgoJpCeWpGanphak\r
  53         FsFkZTg4lCR4hbSBGgWLUtNTK9Iyc0oQ0kwcnCDDeYCGu4PU8BYXJOYWZ6ZD5E8xKkqJ81qA\r
  54         JARAEhmleXC9sJh+xSgO9IowryBIFQ8wHcB1vwIazAQ02KiZA2RwSSJCSqqBUcG0Okn3ZbJ4\r
  55         q5HeascPproWE2IbVKW25L4Vsdrto2UavUngYObxjl1utzvqbu5ctlLgZOWHHQq3hCJdBG+t\r
  56         9tjaxbh8c+NTz+DDHlP0zFckXVfwmy1udON54+ToX3sFurgtvT3bp5x+umy7lzjLZTZD72xr\r
  57         Sdkjt/auF57E7f+a7cC9FGN2JZbijERDLeai4kQAaO/GcsQCAAA=\r
  58 X-BeenThere: notmuch@notmuchmail.org\r
  59 X-Mailman-Version: 2.1.13\r
  60 Precedence: list\r
  61 List-Id: "Use and development of the notmuch mail system."\r
  62         <notmuch.notmuchmail.org>\r
  63 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  64         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  65 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  66 List-Post: <mailto:notmuch@notmuchmail.org>\r
  67 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  68 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  69         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  70 X-List-Received-Date: Mon, 12 Aug 2013 18:40:59 -0000\r
  71 \r
  72 notmuch_message_get_header started returning some headers straight\r
  73 from the database in 567bcbc, but this comment explicitly claimed all\r
  74 headers were read from the message file.\r
  75 ---\r
  76  lib/notmuch.h |    7 +++++--\r
  77  1 file changed, 5 insertions(+), 2 deletions(-)\r
  78 \r
  79 diff --git a/lib/notmuch.h b/lib/notmuch.h\r
  80 index 73c85a4..9fc34ef 100644\r
  81 --- a/lib/notmuch.h\r
  82 +++ b/lib/notmuch.h\r
  83 @@ -1015,8 +1015,11 @@ notmuch_message_get_date  (notmuch_message_t *message);\r
  84  \r
  85  /* Get the value of the specified header from 'message'.\r
  86   *\r
  87 - * The value will be read from the actual message file, not from the\r
  88 - * notmuch database. The header name is case insensitive.\r
  89 + * Common headers are stored in the database when the message is\r
  90 + * indexed and will be returned from the database.  Other headers will\r
  91 + * be read from the actual message file.\r
  92 + *\r
  93 + * The header name is case insensitive.\r
  94   *\r
  95   * The returned string belongs to the message so should not be\r
  96   * modified or freed by the caller (nor should it be referenced after\r
  97 -- \r
  98 1.7.10.4\r
  99 \r