unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
From: Allan Wind <allan_wind@lifeintegrity.com>
To: notmuch@notmuchmail.org
Subject: [PATCH] lib: update notmuch_tags_get examle to reflect api change
Date: Sun, 29 Jan 2012 10:29:01 -0500	[thread overview]
Message-ID: <1327850941-12441-1-git-send-email-allan_wind@lifeintegrity.com> (raw)

The function notmuch_database_find_message_by_filename now requires a
notmuch_message_t and returns a notmuch_status_t.  This
change was introduced with 02a3076711, LIBNOTMUCH_VERSION_MAJOR = 2,
version 0.9.
---
 lib/notmuch.h |   21 +++++++++++----------
 1 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/lib/notmuch.h b/lib/notmuch.h
index 7929fe7..5e6e449 100644
--- a/lib/notmuch.h
+++ b/lib/notmuch.h
@@ -941,21 +941,22 @@ notmuch_message_get_header (notmuch_message_t *message, const char *header);
  * Typical usage might be:
  *
  *     notmuch_message_t *message;
+ *     notmuch_status_t status;
  *     notmuch_tags_t *tags;
  *     const char *tag;
  *
- *     message = notmuch_database_find_message (database, message_id);
- *
- *     for (tags = notmuch_message_get_tags (message);
- *          notmuch_tags_valid (tags);
- *          notmuch_result_move_to_next (tags))
- *     {
- *         tag = notmuch_tags_get (tags);
- *         ....
+ *     status = notmuch_database_find_message (database, message_id, &message);
+ *     if(!status && message) {
+ *          for (tags = notmuch_message_get_tags (message);
+ *               notmuch_tags_valid (tags);
+ *               notmuch_result_move_to_next (tags))
+ *          {
+ *               tag = notmuch_tags_get (tags);
+ *               ....
+ *          }
+ *          notmuch_message_destroy (message);
  *     }
  *
- *     notmuch_message_destroy (message);
- *
  * Note that there's no explicit destructor needed for the
  * notmuch_tags_t object. (For consistency, we do provide a
  * notmuch_tags_destroy function, but there's no good reason to call
-- 
1.7.2.5

             reply	other threads:[~2012-01-29 15:29 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-01-29 15:29 Allan Wind [this message]
2012-01-30  7:53 ` [PATCH] lib: update notmuch_tags_get examle to reflect api change Tomi Ollila
  -- strict thread matches above, loose matches on Subject: below --
2012-01-30 14:02 Allan Wind
2012-01-30 14:04 ` Allan Wind
2012-01-30 14:04 ` Tomi Ollila
2012-01-30 14:05 Allan Wind
2012-01-30 19:49 ` Dmitry Kurochkin
2012-01-30 20:38   ` Allan Wind
2012-01-30 22:38 ` Austin Clements

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://notmuchmail.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1327850941-12441-1-git-send-email-allan_wind@lifeintegrity.com \
    --to=allan_wind@lifeintegrity.com \
    --cc=notmuch@notmuchmail.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).