Reformat mdb_dbi_open() doc for clarity

libraries/liblmdb/lmdb.h

@@ -1043,14 +1043,16 @@ int  mdb_txn_renew(MDB_txn *txn);
 	 * The database handle may be discarded by calling #mdb_dbi_close().
 	 * The old database handle is returned if the database was already open.
 	 * The handle may only be closed once.
+	 *
 	 * The database handle will be private to the current transaction until
 	 * the transaction is successfully committed. If the transaction is
 	 * aborted the handle will be closed automatically.
-	 * After a successful commit the
+	 * After a successful commit the handle will reside in the shared
-	 * handle will reside in the shared environment, and may be used
+	 * environment, and may be used by other transactions.
-	 * by other transactions. This function must not be called from
+	 *
-	 * multiple concurrent transactions in the same process. A transaction
+	 * This function must not be called from multiple concurrent
-	 * that uses this function must finish (either commit or abort) before
+	 * transactions in the same process. A transaction that uses
+	 * this function must finish (either commit or abort) before
 	 * any other transaction in the process may use this function.
 	 *
 	 * To use named databases (with name != NULL), #mdb_env_set_maxdbs()