Skip to content

Commit b2ddf33

Browse files
committed
Normalize ‘open transaction’
1 parent bb30103 commit b2ddf33

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

Doc/library/sqlite3.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -634,25 +634,25 @@ Connection objects
634634

635635
.. method:: commit()
636636

637-
Commit any pending transaction to the database.
637+
Commit any open transaction to the database.
638638
If :attr:`autocommit` is ``True``, or there is no open transaction,
639639
this method does nothing.
640640
If :attr:`!autocommit` is ``False``, a new transaction is implicitly
641-
opened if a pending transaction was committed by this method.
641+
opened if an open transaction was committed by this method.
642642

643643
.. method:: rollback()
644644

645-
Roll back to the start of any pending transaction.
645+
Roll back to the start of any open transaction.
646646
If :attr:`autocommit` is ``True``, or there is no open transaction,
647647
this method does nothing.
648648
If :attr:`!autocommit` is ``False``, a new transaction is implicitly
649-
opened if a pending transaction was rolled back by this method.
649+
opened if an open transaction was rolled back by this method.
650650

651651
.. method:: close()
652652

653653
Close the database connection.
654654
If :attr:`autocommit` is ``False``,
655-
any pending transaction is implicitly rolled back.
655+
any open transaction is implicitly rolled back.
656656
If :attr:`!autocommit` is ``True`` or :data:`LEGACY_TRANSACTION_CONTROL`,
657657
no implicit transaction control is executed.
658658
Make sure to :meth:`commit` before closing
@@ -1273,7 +1273,7 @@ Connection objects
12731273
This is currently the default value of :attr:`!autocommit`.
12741274

12751275
Changing :attr:`!autocommit` to ``False`` will open a new transaction,
1276-
and changing it to ``True`` will commit any pending transaction.
1276+
and changing it to ``True`` will commit any open transaction.
12771277

12781278
See :ref:`sqlite3-transaction-control-autocommit` for more details.
12791279

@@ -1474,7 +1474,7 @@ Cursor objects
14741474
Execute the SQL statements in *sql_script*.
14751475
If the :attr:`~Connection.autocommit` is
14761476
:data:`LEGACY_TRANSACTION_CONTROL`
1477-
and there is a pending transaction,
1477+
and there is an open transaction,
14781478
an implicit ``COMMIT`` statement is executed first.
14791479
No other implicit transaction control is performed;
14801480
any transaction control must be added to *sql_script*.
@@ -2392,7 +2392,7 @@ This means:
23922392
* :mod:`!sqlite3` ensures that a transaction is always open,
23932393
so :meth:`Connection.commit` and :meth:`Connection.rollback`
23942394
will implicitly open a new transaction immediately after closing
2395-
the pending one.
2395+
the open one.
23962396
:mod:`!sqlite3` uses ``BEGIN DEFERRED`` statements when opening transactions.
23972397
* Transactions should be committed explicitly using :meth:`!commit`.
23982398
* Transactions should be rolled back explicitly using :meth:`!rollback`.
@@ -2437,7 +2437,7 @@ new transactions are implicitly opened before
24372437
``INSERT``, ``UPDATE``, ``DELETE``, or ``REPLACE`` statements;
24382438
for other statements, no implicit transaction handling is performed.
24392439
Use the :meth:`~Connection.commit` and :meth:`~Connection.rollback` methods
2440-
to respectively commit and roll back pending transactions.
2440+
to respectively commit and roll back open transactions.
24412441
You can choose the underlying `SQLite transaction behaviour`_ —
24422442
that is, whether and what type of ``BEGIN`` statements :mod:`!sqlite3`
24432443
implicitly executes –
@@ -2452,7 +2452,7 @@ The underlying SQLite library autocommit mode can be queried using the
24522452
:attr:`~Connection.in_transaction` attribute.
24532453

24542454
The :meth:`~Cursor.executescript` method implicitly commits
2455-
any pending transaction before execution of the given SQL script,
2455+
any open transaction before execution of the given SQL script,
24562456
regardless of the value of :attr:`~Connection.isolation_level`.
24572457

24582458
.. versionchanged:: 3.6

0 commit comments

Comments
 (0)