@@ -285,10 +285,7 @@ public Dbi<T> openDbi(final String name, final Comparator<T> comparator,
285285 }
286286
287287/**
288- * Open the {@link Dbi}.
289- *
290- * <p>
291- * This method must not be called from concurrent threads.
288+ * Convenience method that opens a {@link Dbi} with a UTF-8 database name.
292289 *
293290 * @param name name of the database (or null if no name is required)
294291 * @param flags to open the database with
@@ -315,6 +312,10 @@ public Dbi<T> openDbi(final byte[] name, final DbiFlags... flags) {
315312 * comparator is typically more efficient (as there is no need for the native
316313 * library to call back into Java for the comparator result).
317314 *
315+ * <p>
316+ * This method (and its overloaded convenience variants) must not be called
317+ * from concurrent threads.
318+ *
318319 * @param name name of the database (or null if no name is required)
319320 * @param comparator custom comparator callback (or null to use LMDB default)
320321 * @param flags to open the database with