diff options
-rw-r--r-- | bindings/python/notmuch/database.py | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/bindings/python/notmuch/database.py b/bindings/python/notmuch/database.py index fc7edf0b..7f0091de 100644 --- a/bindings/python/notmuch/database.py +++ b/bindings/python/notmuch/database.py @@ -358,8 +358,14 @@ class Database(object): :param msgid: The message ID :type msgid: string - :returns: :class:`Message` or `None` if no message is found or if an - out-of-memory situation occurs. + :returns: :class:`Message` or `None` if no message is found or + if any xapian exception or out-of-memory situation + occurs. Do note that Xapian Exceptions include + "Database modified" situations, e.g. when the + notmuch database has been modified by + another program in the meantime. A return value of + `None` is therefore no guarantee that the message + does not exist. :exception: :exc:`NotmuchError` with STATUS.NOT_INITIALIZED if the database was not intitialized. """ |