From f2886b80c1addc3d358ba910a4eebf76ba74c00b Mon Sep 17 00:00:00 2001 From: David Bremner Date: Mon, 27 Jun 2016 20:38:40 +0200 Subject: [PATCH] doc: forbid further operations on a closed database We could add many null pointer checks, but currently I don't see a use case that justifies it. --- lib/notmuch.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/lib/notmuch.h b/lib/notmuch.h index cb46fc05..a43e167c 100644 --- a/lib/notmuch.h +++ b/lib/notmuch.h @@ -331,7 +331,9 @@ notmuch_database_status_string (const notmuch_database_t *notmuch); * functions on objects derived from this database may either behave * as if the database had not been closed (e.g., if the required data * has been cached) or may fail with a - * NOTMUCH_STATUS_XAPIAN_EXCEPTION. + * NOTMUCH_STATUS_XAPIAN_EXCEPTION. The only further operation + * permitted on the database itself is to call + * notmuch_database_destroy. * * notmuch_database_close can be called multiple times. Later calls * have no effect. -- 2.26.2