Skip to content

Commit 017f07a

Browse files
author
Erlend Egeberg Aasland
authored
pythongh-90923: Improve sqlite3.Connection.execute* docs (python#91643)
- Drop 'nonstandard'; it does not add any value - Try to be more concise - Make return value a little more explicit
1 parent 0b906ae commit 017f07a

File tree

1 file changed

+9
-12
lines changed

1 file changed

+9
-12
lines changed

Doc/library/sqlite3.rst

+9-12
Original file line numberDiff line numberDiff line change
@@ -431,24 +431,21 @@ Connection Objects
431431

432432
.. method:: execute(sql[, parameters])
433433

434-
This is a nonstandard shortcut that creates a cursor object by calling
435-
the :meth:`~Connection.cursor` method, calls the cursor's
436-
:meth:`~Cursor.execute` method with the *parameters* given, and returns
437-
the cursor.
434+
Create a new :class:`Cursor` object and call
435+
:meth:`~Cursor.execute` on it with the given *sql* and *parameters*.
436+
Return the new cursor object.
438437

439438
.. method:: executemany(sql[, parameters])
440439

441-
This is a nonstandard shortcut that creates a cursor object by
442-
calling the :meth:`~Connection.cursor` method, calls the cursor's
443-
:meth:`~Cursor.executemany` method with the *parameters* given, and
444-
returns the cursor.
440+
Create a new :class:`Cursor` object and call
441+
:meth:`~Cursor.executemany` on it with the given *sql* and *parameters*.
442+
Return the new cursor object.
445443

446444
.. method:: executescript(sql_script)
447445

448-
This is a nonstandard shortcut that creates a cursor object by
449-
calling the :meth:`~Connection.cursor` method, calls the cursor's
450-
:meth:`~Cursor.executescript` method with the given *sql_script*, and
451-
returns the cursor.
446+
Create a new :class:`Cursor` object and call
447+
:meth:`~Cursor.executescript` on it with the given *sql_script*.
448+
Return the new cursor object.
452449

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

0 commit comments

Comments
 (0)