From: Erlend Egeberg Aasland Date: Sun, 17 Apr 2022 21:12:55 +0000 (+0200) Subject: gh-90923: Improve sqlite3.Connection.execute* docs (#91643) X-Git-Tag: v3.11.0b1~330 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=017f07a229a337e9c17bed8cd1879e0177a8d89d;p=thirdparty%2FPython%2Fcpython.git 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 --- diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 5c9e2e868ab6..cbe7bb1fb9a0 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)