diff options
author | Erlend Egeberg Aasland <erlend.aasland@innova.no> | 2022-04-17 21:12:55 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-04-17 21:12:55 (GMT) |
commit | 017f07a229a337e9c17bed8cd1879e0177a8d89d (patch) | |
tree | c357f47e25c6994fa2785747e2b9384c5a101fad /Doc | |
parent | 0b906ae562fa057162a67d4a5b7ea426f6b9dd23 (diff) | |
download | cpython-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.rst | 21 |
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) |