Skip to content

Commit 4dfd05f

Browse files
Erlend Egeberg Aaslandmiss-islington
Erlend Egeberg Aasland
authored andcommitted
pythongh-90923: Improve sqlite3.Connection.execute* docs (pythonGH-91643)
- Drop 'nonstandard'; it does not add any value - Try to be more concise - Make return value a little more explicit (cherry picked from commit 017f07a) Co-authored-by: Erlend Egeberg Aasland <[email protected]>
1 parent 9a45893 commit 4dfd05f

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
@@ -378,24 +378,21 @@ Connection Objects
378378

379379
.. method:: execute(sql[, parameters])
380380

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

386385
.. method:: executemany(sql[, parameters])
387386

388-
This is a nonstandard shortcut that creates a cursor object by
389-
calling the :meth:`~Connection.cursor` method, calls the cursor's
390-
:meth:`~Cursor.executemany` method with the *parameters* given, and
391-
returns the cursor.
387+
Create a new :class:`Cursor` object and call
388+
:meth:`~Cursor.executemany` on it with the given *sql* and *parameters*.
389+
Return the new cursor object.
392390

393391
.. method:: executescript(sql_script)
394392

395-
This is a nonstandard shortcut that creates a cursor object by
396-
calling the :meth:`~Connection.cursor` method, calls the cursor's
397-
:meth:`~Cursor.executescript` method with the given *sql_script*, and
398-
returns the cursor.
393+
Create a new :class:`Cursor` object and call
394+
:meth:`~Cursor.executescript` on it with the given *sql_script*.
395+
Return the new cursor object.
399396

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

0 commit comments

Comments
 (0)