Further clarification of mdb_open()

diff --git a/libraries/libmdb/mdb.h b/libraries/libmdb/mdb.h
index 45f7704..bcf3665 100644 (file)
--- a/libraries/libmdb/mdb.h
+++ b/libraries/libmdb/mdb.h
@@ -582,9 +582,10 @@ int  mdb_txn_renew(MDB_txn *txn);
 
        /** @brief Open a database in the environment.
         *
-        * The database handle may be discarded by calling #mdb_close(). Only
-        * one thread at a time may call this function; it is not mutex-protected in
-        * a read-only transaction.
+        * The database handle may be discarded by calling #mdb_close().  The
+        * database handle resides in the shared environment, it is not owned
+        * by the given transaction. Only one thread should call this function;
+        * it is not mutex-protected in a read-only transaction.
         * @param[in] txn A transaction handle returned by #mdb_txn_begin()
         * @param[in] name The name of the database to open. If only a single
         *      database is needed in the environment, this value may be NULL.