Clarify that implicit transaction control happens in the same commit()/rollback()/close() call

geryogam · geryogam · commit cb36419a64db · 2022-11-13T22:39:06.000+01:00
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
@@ -637,24 +637,24 @@ Connection objects
       Commit any open transaction to the database.
       If :attr:`autocommit` is ``True``, or there is no open transaction,
       this method does nothing.
-      If :attr:`!autocommit` is ``False``, a new transaction is implicitly
-      opened if an open transaction was committed by this method.
+      If :attr:`!autocommit` is ``False``, this method implicitly opens
+      a new transaction after committing an open transaction.
 
    .. method:: rollback()
 
       Roll back to the start of any open transaction.
       If :attr:`autocommit` is ``True``, or there is no open transaction,
       this method does nothing.
-      If :attr:`!autocommit` is ``False``, a new transaction is implicitly
-      opened if an open transaction was rolled back by this method.
+      If :attr:`!autocommit` is ``False``, this method implicitly opens
+      a new transaction after committing.
 
    .. method:: close()
 
       Close the database connection.
-      If :attr:`autocommit` is ``False``,
-      any open transaction is implicitly rolled back.
+      If :attr:`autocommit` is ``False``, this method implicitly rolls back
+      any open transaction before closing.
       If :attr:`!autocommit` is ``True`` or :data:`LEGACY_TRANSACTION_CONTROL`,
-      no implicit transaction control is executed.
+      this method does not execute any implicit transaction control.
       Make sure to :meth:`commit` before closing
       to avoid losing pending changes.
 
