d1/d569fbcd6e72fe386289e904daf32ba8b254ae

   1 Return-Path: <allan@lifeintegrity.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 917AC431E64\r
   6         for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 12:35:45 -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\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         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 5hv-kfrUVvT2 for <notmuch@notmuchmail.org>;\r
  16         Mon, 30 Jan 2012 12:35:45 -0800 (PST)\r
  17 Received: from pawan.lifeintegrity.com (lifeintegrity.com [173.48.39.13])\r
  18         by olra.theworths.org (Postfix) with ESMTP id 1D74D431FBC\r
  19         for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 12:35:45 -0800 (PST)\r
  20 Received: from vent.lifeintegrity.com\r
  21         (173-162-190-62-NewEngland.hfc.comcastbusiness.net [173.162.190.62])\r
  22         by submission.lifeintegrity.com (Postfix) with ESMTPS id 50F111F8\r
  23         for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 20:35:44 +0000 (UTC)\r
  24 Received: by vent.lifeintegrity.com (Postfix, from userid 1000)\r
  25         id 0C00018284E; Mon, 30 Jan 2012 20:35:44 +0000 (UTC)\r
  26 From: Allan Wind <allan_wind@lifeintegrity.com>\r
  27 To: notmuch@notmuchmail.org\r
  28 Subject: [PATCH] lib: update notmuch_tags_get example to reflect api change\r
  29 Date: Mon, 30 Jan 2012 15:35:44 -0500\r
  30 Message-Id: <1327955744-13031-1-git-send-email-allan_wind@lifeintegrity.com>\r
  31 X-Mailer: git-send-email 1.7.2.5\r
  32 X-BeenThere: notmuch@notmuchmail.org\r
  33 X-Mailman-Version: 2.1.13\r
  34 Precedence: list\r
  35 List-Id: "Use and development of the notmuch mail system."\r
  36         <notmuch.notmuchmail.org>\r
  37 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  38         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  39 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  40 List-Post: <mailto:notmuch@notmuchmail.org>\r
  41 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  42 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  43         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  44 X-List-Received-Date: Mon, 30 Jan 2012 20:35:45 -0000\r
  45 \r
  46 The function notmuch_database_find_message_by_filename now requires a\r
  47 notmuch_message_t and returns a notmuch_status_t.  This\r
  48 change was introduced with 02a3076711, LIBNOTMUCH_VERSION_MAJOR = 2,\r
  49 version 0.9.\r
  50 ---\r
  51  lib/notmuch.h |   21 +++++++++++----------\r
  52  1 files changed, 11 insertions(+), 10 deletions(-)\r
  53 \r
  54 diff --git a/lib/notmuch.h b/lib/notmuch.h\r
  55 index 7929fe7..5e6e449 100644\r
  56 --- a/lib/notmuch.h\r
  57 +++ b/lib/notmuch.h\r
  58 @@ -941,21 +941,22 @@ notmuch_message_get_header (notmuch_message_t *message, const char *header);\r
  59   * Typical usage might be:\r
  60   *\r
  61   *     notmuch_message_t *message;\r
  62 + *     notmuch_status_t status;\r
  63   *     notmuch_tags_t *tags;\r
  64   *     const char *tag;\r
  65   *\r
  66 - *     message = notmuch_database_find_message (database, message_id);\r
  67 - *\r
  68 - *     for (tags = notmuch_message_get_tags (message);\r
  69 - *          notmuch_tags_valid (tags);\r
  70 - *          notmuch_result_move_to_next (tags))\r
  71 - *     {\r
  72 - *         tag = notmuch_tags_get (tags);\r
  73 - *         ....\r
  74 + *     status = notmuch_database_find_message (database, message_id, &message);\r
  75 + *     if (!status && message) {\r
  76 + *          for (tags = notmuch_message_get_tags (message);\r
  77 + *               notmuch_tags_valid (tags);\r
  78 + *               notmuch_result_move_to_next (tags))\r
  79 + *          {\r
  80 + *               tag = notmuch_tags_get (tags);\r
  81 + *               ....\r
  82 + *          }\r
  83 + *          notmuch_message_destroy (message);\r
  84   *     }\r
  85   *\r
  86 - *     notmuch_message_destroy (message);\r
  87 - *\r
  88   * Note that there's no explicit destructor needed for the\r
  89   * notmuch_tags_t object. (For consistency, we do provide a\r
  90   * notmuch_tags_destroy function, but there's no good reason to call\r
  91 -- \r
  92 1.7.2.5\r
  93 \r