* Close the database connection
*
* This should only be called after any transactions have been resolved,
- * aside from read-only transactions (assuming no callbacks are registered).
- * If a transaction is still open anyway, it will be committed if possible.
+ * aside from read-only automatic transactions (assuming no callbacks are registered).
+ * If a transaction is still open anyway, it will be rolled back.
*
* @throws DBError
* @return bool Operation success. true if already closed.
public function onTransactionPreCommitOrIdle( callable $callback, $fname = __METHOD__ );
/**
- * Run a callback each time any transaction commits or rolls back
+ * Run a callback after each time any transaction commits or rolls back
*
* The callback takes two arguments:
* - IDatabase::TRIGGER_COMMIT or IDatabase::TRIGGER_ROLLBACK