Skip to content

Commit

Permalink
pythongh-90923: Improve sqlite3.Connection.execute* docs
Browse files Browse the repository at this point in the history
- Drop 'nonstandard'; it does not add any value
- Try to be more concise
- Make return value a little more explicit
  • Loading branch information
Erlend E. Aasland committed Apr 17, 2022
1 parent 0ddc63b commit 0a48dd6
Showing 1 changed file with 9 additions and 12 deletions.
21 changes: 9 additions & 12 deletions Doc/library/sqlite3.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Creates a new :class:`Cursor` object and calls
:meth:`~Cursor.execute` on it with the given *sql* and *parameters*.
Returns 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.
Creates a new :class:`Cursor` object and calls
:meth:`~Cursor.executemany` on it with the given *sql* and *parameters*.
Returns 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.
Creates a new :class:`Cursor` object and calls
:meth:`~Cursor.executescript` on it with the given *sql_script*.
Returns the new cursor object.

.. method:: create_function(name, num_params, func, *, deterministic=False)

Expand Down

0 comments on commit 0a48dd6

Please sign in to comment.