Further clarification of mdb_open()

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.