notmuch/lib/notmuch.h, branch 0.34.3

lib/load_config: document expectations for db on error, add tests

2021-10-30T16:49:37Z

This is a bit different than n_d_{open,create}_with_config, since there are several non-zero status codes where we do want to return a non-NULL database structure.

lib/create: document expectations for db on error, add tests

2021-10-30T16:45:40Z

It seems sensible to harmonize the behaviour with n_d_open_with_config. In this commit we just assert the desired behaviour.

lib: document n_o_w_config can return NOTMUCH_STATUS_NO_CONFIG

2021-10-30T16:41:57Z

This should be treated as fatal by callers, since we didn't succeed in opening a Xapian database.

lib: bump lib minor version to 5

2021-10-15T11:34:39Z

One new function (and an enum) was added to the API/ABI.

lib: add new status code for query syntax errors.

2021-09-05T00:07:19Z

This will help provide more meaningful error messages without special casing on the client side.

lib: define notmuch_query_create_with_syntax

2021-09-05T00:07:19Z

Set the parsing syntax when the (notmuch) query object is created. Initially the library always returns a trivial query that matches all messages when using s-expression syntax. It seems better to select the syntax at query creation time because the lazy parsing is an implementation detail.

Merge tag 'debian/0.32.3-1'

2021-08-19T04:46:42Z

notmuch release 0.32.3-1 for unstable (sid) [dgit] [dgit distro=debian no-split --quilt=linear]

lib: bump libnotmuch minor version

2021-08-17T23:30:22Z

Notmuch 0.32 corresponds to libnotmuch 5.4 as indicated by docstrings; however, the minor number wasn't bumped. Any libnotmuch downstream consumer using the LIBNOTMUCH_CHECK_VERSION macro to support multiple versions won't be able to access the new 5.4 functions. Signed-off-by: Austin Ray

lib: correct deprecated db open functions' docs

2021-08-17T23:30:05Z

Both notmuch_database_open() and notmuch_database_open_verbose()'s documentation state they call notmuch_database_open_with_config() with config_path=NULL; however, their implementations pass an empty string. The empty string is the correct value to maintain their original behavior of not loading the user's configuration so their documentation is incorrect.

lib: update transaction documentation

2021-06-27T17:06:30Z

Partly this is to recognize the semantics we inherit from Xapian, partly to mention the new autocommit feature.