Merge "rdbms: clarify IDatabase::setTransactionListener() comment"

diff --combined includes/libs/rdbms/database/IDatabase.php
index 83216d4,f5ebbb0..f38ddb8
--- 1/includes/libs/rdbms/database/IDatabase.php
--- 2/includes/libs/rdbms/database/IDatabase.php
+++ b/includes/libs/rdbms/database/IDatabase.php
@@@ -486,8 -486,8 +486,8 @@@ interface IDatabase 
         * 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.
@@@ -670,8 -670,6 +670,8 @@@
         * Escaping of untrusted input used in values of numeric keys should be done via
         * IDatabase::addQuotes()
         *
 +       * Use an empty array, string, or '*' to update all rows.
 +       *
         * @param string|array $options
         *
         * Optional: Array of query options. Boolean options are specified by
@@@ -1575,7 -1573,7 +1575,7 @@@
        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