notmuch/lib/notmuch.h, branch 0.32.3

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: 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.

lib/config: add configuration variable for backup directory

2021-03-20T10:51:36Z

Like the hook directory, we primarily need a way to communicate this directory between various components, but we may as well let the user configure it. Most of the diff is generalizing choose_hook_dir to work for both backup and hook directories.

lib: support splitting mail from database location.

2021-03-20T10:39:12Z

Introduce a new configuration value for the mail root, and use it to locate mail messages in preference to the database.path (which previously implied the mail messages were also in this location. Initially only a subset of the CLI is tested in a split configuration. Further changes will be needed for the remainder of the CLI to work in split configurations.

lib: support reopening databases for write access.

2021-03-18T11:04:06Z

In the future Xapian will apparently support this more conveniently for the cases other than READ_ONLY => READ_ONLY Conceptually this function seems to fit better in lib/open.cc; database.cc is still large enough that moving the function makes sense.