Skip to content

Commit 833ff16

Browse files
miss-islingtonErlend Egeberg Aasland
and
Erlend Egeberg Aasland
authored
gh-90923: Improve sqlite3.Connection.execute* docs (GH-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 2a43afd commit 833ff16

File tree

1 file changed

+9
-12
lines changed

1 file changed

+9
-12
lines changed

Doc/library/sqlite3.rst

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -373,24 +373,21 @@ Connection Objects
373373

374374
.. method:: execute(sql[, parameters])
375375

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

381380
.. method:: executemany(sql[, parameters])
382381

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

388386
.. method:: executescript(sql_script)
389387

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

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

0 commit comments

Comments
 (0)