notmuch/lib/notmuch.h, branch debian/unstable

lib: bump minor version

2026-01-17T00:22:58Z

This reflects the addition of a new API functions, notmuch_{messages,threads}_status

lib: add notmuch_threads_status()

2025-08-04T13:43:35Z

While a number of errors can happen when iterating over threads (DatabaseModifiedError, memory allocation errors, etc.), the API currently cannot signal them to the caller, and either triggers an internal error (aborting the caller) or returns NULL from notmuch_threads_get() with no information on what actually went wrong. Add a new public function notmuch_threads_status() - similar to previously added notmuch_messages_status() - that allows propagating those errors to the caller. Use this to remove the INTERNAL_ERROR() in _notmuch_thread_create() (triggered by T642). Fixes: https://github.com/pazz/alot/issues/1460 Amended-By: db. Resolved whitespace disagreement between emacs and uncrustify in favour of uncrustify.

lib: handle DatabaseModifiedError in _notmuch_message_create

2025-07-24T10:30:58Z

If an open database is modified sufficiently by other callers, the open instance becomes invalid and operations on it throw DatabaseModifiedError. Per Xapian documentation, the caller is then supposed to reopen the database and restart the query. This exception is currently not handled in _notmuch_message_create(), leading to the default handler abort()ing the process. Catch this exception in _notmuch_message_create() and return an error instead of crashing. Since the entire query becomes invalid - including results that have already been read by the caller - this situation cannot be handled by libnotmuch transparently. A new public function - notmuch_messages_status() - is added to allow the callers to check whether the messages iterator was exhausted or terminated early due to a runtime error. This also allows memory allocation failure to be signalled to the caller. Amended-By: David Bremner [replace use of notmuch_messages_valid]

config: allow custom separators in author lists

2024-07-26T06:59:11Z

Allow distinguishing between commas separating authors and separating first and last names. Amended by db: reformat NEWS entry and commit message. Tweaked whitespace in lib/thread.cc.

doc/lib: clarify ownership for notmuch_database_get_revision

2023-07-09T15:08:28Z

The ownership is implicit in the const declaration (I think!), but that does not show up in the doxygen generated API docs.

lib: add config key INDEX_AS_TEXT

2023-04-02T22:21:37Z

Higher level processing as a list of regular expressions and documentation will follow.

lib/notmuch: update example

2023-02-27T12:34:38Z

Likely missed in 86cbd215e, when notmuch_query_search_messages_st was renamed to notmuch_query_search_messages.

lib: add better diagnostics for over long filenames.

2023-02-20T13:22:32Z

Previously we just crashed with an internal error. With this change, the caller can handle it better. Update notmuch-new so that it doesn't crash with "unknown error code" because of this change.

lib: add NOTMUCH_STATUS_CLOSED_DATABASE, use in _n_d_ensure_writable

2022-06-25T19:06:18Z

In order for a database to actually be writeable, it must be the case that it is open, not just the correct type of Xapian object. By explicitely checking, we are able to provide better error reporting, in particular for the previously broken test in T566-lib-message.

lib/tag: handle NULL argument to notmuch_tags_valid

2022-06-25T19:05:45Z

Make the behaviour when passed NULL consistent with notmuch_filenames_valid. The library already passes the result of notmuch_message_get_tags without checking for NULL, so it should be handled.