summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorErlend Egeberg Aasland <erlend.aasland@innova.no>2022-04-17 21:12:55 (GMT)
committerGitHub <noreply@github.com>2022-04-17 21:12:55 (GMT)
commit017f07a229a337e9c17bed8cd1879e0177a8d89d (patch)
treec357f47e25c6994fa2785747e2b9384c5a101fad /Doc
parent0b906ae562fa057162a67d4a5b7ea426f6b9dd23 (diff)
downloadcpython-017f07a229a337e9c17bed8cd1879e0177a8d89d.zip
cpython-017f07a229a337e9c17bed8cd1879e0177a8d89d.tar.gz
cpython-017f07a229a337e9c17bed8cd1879e0177a8d89d.tar.bz2
gh-90923: Improve sqlite3.Connection.execute* docs (#91643)
- Drop 'nonstandard'; it does not add any value - Try to be more concise - Make return value a little more explicit
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/sqlite3.rst21
1 files changed, 9 insertions, 12 deletions
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 5c9e2e8..cbe7bb1 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -431,24 +431,21 @@ Connection Objects
.. method:: execute(sql[, parameters])
- This is a nonstandard shortcut that creates a cursor object by calling
- the :meth:`~Connection.cursor` method, calls the cursor's
- :meth:`~Cursor.execute` method with the *parameters* given, and returns
- the cursor.
+ Create a new :class:`Cursor` object and call
+ :meth:`~Cursor.execute` on it with the given *sql* and *parameters*.
+ Return the new cursor object.
.. method:: executemany(sql[, parameters])
- This is a nonstandard shortcut that creates a cursor object by
- calling the :meth:`~Connection.cursor` method, calls the cursor's
- :meth:`~Cursor.executemany` method with the *parameters* given, and
- returns the cursor.
+ Create a new :class:`Cursor` object and call
+ :meth:`~Cursor.executemany` on it with the given *sql* and *parameters*.
+ Return the new cursor object.
.. method:: executescript(sql_script)
- This is a nonstandard shortcut that creates a cursor object by
- calling the :meth:`~Connection.cursor` method, calls the cursor's
- :meth:`~Cursor.executescript` method with the given *sql_script*, and
- returns the cursor.
+ Create a new :class:`Cursor` object and call
+ :meth:`~Cursor.executescript` on it with the given *sql_script*.
+ Return the new cursor object.
.. method:: create_function(name, num_params, func, *, deterministic=False)