notmuch/lib/notmuch.h, branch 0.33

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.

lib/config: add NOTMUCH_CONFIG_AUTOCOMMIT

2021-06-27T16:59:42Z

This will be used to control how often atomic transactions are committed.

lib: provide notmuch_config_path

2021-03-27T12:26:14Z

Since the library searches in several locations for a config file, the caller does not know which of these is chosen in the usual case of passing NULL as a config file. This changes provides an API for the caller to retrieve the name of the config file chosen. It will be tested in a following commit.

lib: add NOTMUCH_STATUS_NO_DATABASE

2021-03-27T12:26:14Z

This will allow more precise return values from various open related functions.

lib/config: add config_pairs iterators

2021-03-27T12:26:14Z

The layer of shims here seems a bit wasteful compared to just calling the corresponding string map functions directly, but it allows control over the API (calling with notmuch_database_t *) and flexibility for future changes.

lib/config: add notmuch_config_get_values_string

2021-03-27T12:26:14Z

This is to support the less common (at least in the notmuch codebase) case of accessing a ;-delimited list config value with an arbitrary string key.

lib: provide notmuch_database_load_config

2021-03-27T12:26:14Z

This is mainly targetted at notmuch-config.c, or similar applications that don't necessarily need both a configuration file and a database to exist.