summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniele Varrazzo <daniele.varrazzo@gmail.com>2017-02-08 10:15:16 +0000
committerDaniele Varrazzo <daniele.varrazzo@gmail.com>2017-02-08 10:31:19 +0000
commitd2cafe26847140bd9b612237166420fb51229a0c (patch)
treec7dc7cc051b30dadd1bea13d03fc7ce7b4598923
parentd2cd1236a8638eeee39d78187e76572ed6bfc19d (diff)
downloadpsycopg2-d2cafe26847140bd9b612237166420fb51229a0c.tar.gz
Dropped references to prepare in cur.execute[many] docs
They were copied from the DBAPI spec but that's not how psycopg works.
-rw-r--r--doc/src/cursor.rst11
1 files changed, 5 insertions, 6 deletions
diff --git a/doc/src/cursor.rst b/doc/src/cursor.rst
index 4161f2a..219a56f 100644
--- a/doc/src/cursor.rst
+++ b/doc/src/cursor.rst
@@ -171,9 +171,9 @@ The ``cursor`` class
.. rubric:: Commands execution methods
- .. method:: execute(operation [, parameters])
+ .. method:: execute(query, vars=None)
- Prepare and execute a database operation (query or command).
+ Execute a database operation (query or command).
Parameters may be provided as sequence or mapping and will be bound to
variables in the operation. Variables are specified either with
@@ -184,11 +184,10 @@ The ``cursor`` class
values can be retrieved using |fetch*|_ methods.
- .. method:: executemany(operation, seq_of_parameters)
+ .. method:: executemany(query, vars_list)
- Prepare a database operation (query or command) and then execute it
- against all parameter tuples or mappings found in the sequence
- `seq_of_parameters`.
+ Execute a database operation (query or command) against all parameter
+ tuples or mappings found in the sequence `seq_of_parameters`.
The function is mostly useful for commands that update the database:
any result set returned by the query is discarded.