Successfully created the database.
The given 'path' argument is NULL.
Out of memory.
An error occurred trying to create the * database file (such as permission denied, or file not found, * etc.), or the database already exists.
A Xapian exception occurred.
Create a new, empty notmuch database located at 'path'.
The path should be a top-level directory to a collection of plain-text email messages (one message per file). This call will create a new ".notmuch" directory within 'path' where notmuch will store its data.
After a successful call to notmuch_database_create, the returned database will be open so the caller should call notmuch_database_destroy when finished with it.
The database will not yet have any data in it (notmuch_database_create itself is a very cheap function). Messages contained within 'path' can be added to the database by calling notmuch_database_add_message.
In case of any failure, this function returns an error status and sets *database to NULL (after printing an error message on stderr).
Return value: