From e369fb5f0d26a5e84a1315bf30c23feac4ce897c Mon Sep 17 00:00:00 2001 From: Daniele Varrazzo Date: Fri, 27 Jul 2012 17:44:28 +0100 Subject: [PATCH] Fixed incorrect and outdated connection.commit() doc --- doc/src/connection.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/doc/src/connection.rst b/doc/src/connection.rst index e229f41b..e0b34ab8 100644 --- a/doc/src/connection.rst +++ b/doc/src/connection.rst @@ -60,11 +60,17 @@ The ``connection`` class pair: Transaction; Commit .. method:: commit() - - Commit any pending transaction to the database. Psycopg can be set to - perform automatic commits at each operation, see - `~connection.set_isolation_level()`. - + + Commit any pending transaction to the database. + + By default, Psycopg opens a transaction before executing the first + command: if `!commit()` is not called, the effect of any data + manipulation will be lost. + + The connection can be also set in "autocommit" mode: no transaction is + automatically open, commands have immediate effect. See + :ref:`transactions-control` for details. + .. index:: pair: Transaction; Rollback @@ -77,7 +83,7 @@ The ``connection`` class .. method:: close() - + Close the connection now (rather than whenever `del` is executed). The connection will be unusable from this point forward; an `~psycopg2.InterfaceError` will be raised if any operation is