notmuch/lib/notmuch.h, branch 0.17_rc1

lib: Document extent of some return values

2013-11-09T00:14:08Z

This documents the extent of the notmuch_messages_t* pointers returned by notmuch_thread_get_toplevel_messages and notmuch_thread_get_messages.

lib: add library version check macro

2013-11-07T23:15:06Z

There have been some plans for making build incompatible changes to the library API. This is inconvenient, but it is much more so without a way to easily conditional build against multiple versions of notmuch. The macro has been lifted from glib.

lib: update documentation of callback functions for database_compact and database_upgrade.

2013-11-07T10:50:50Z

Compact was missing callback documentation entirely, and upgrade did not discuss the closure parameter.

lib: add closure parameter to compact status update callback

2013-11-07T10:46:42Z

This provides much more flexibility for the caller.

database: Add notmuch_database_compact_close

2013-10-10T00:46:49Z

This function uses Xapian's Compactor machinery to compact the notmuch database. The compacted database is built in a temporary directory and later moved into place while the original uncompacted database is preserved. Signed-off-by: Ben Gamari

lib: Document which strings are returned in UTF-8

2013-08-13T15:43:34Z

Any string that ultimately comes from notmuch_message_file_get_header is in UTF-8.

lib: Correct out-of-date doc comment

2013-08-13T15:43:07Z

notmuch_message_get_header started returning some headers straight from the database in 567bcbc, but this comment explicitly claimed all headers were read from the message file.

lib: add NOTMUCH_EXCLUDE_FLAG to notmuch_exclude_t

2013-06-25T05:53:16Z

Add NOTMUCH_EXCLUDE_FLAG to notmuch_exclude_t so that it can cover all four values of search --exclude in the cli. Previously the way to avoid any message being marked excluded was to pass in an empty list of excluded tags: since we now have an explicit option we might as well honour it. The enum is in a slightly strange order as the existing FALSE/TRUE options correspond to the new NOTMUCH_EXCLUDE_FLAG/NOTMUCH_EXCLUDE_TRUE options so this means we do not need to bump the version number. Indeed, an example of this is that the cli count and show still use FALSE/TRUE and still work.

lib: add --exclude=all option

2013-05-14T00:32:03Z

Adds a exclude all option to the lib which means that excluded messages are completely ignored (as if they had actually been deleted).

lib: Add an iterator over all messages in a thread

2013-02-19T00:20:59Z

Previously, getting the list of all messages in a thread required recursively traversing the thread's message hierarchy, which was both difficult and resulted in messages being out of order. This adds a public function to retrieve an iterator over all of the messages in a thread in oldest-first order.