@@ -310,7 +310,7 @@ Module functions
310310 to avoid data corruption.
311311 See:attr: `threadsafety ` for more information.
312312
313- :param Connection factory:
313+ :param~sqlite3. Connection factory:
314314 A custom subclass of:class: `Connection ` to create the connection with,
315315 if not the default:class: `Connection ` class.
316316
@@ -337,7 +337,7 @@ Module functions
337337 The default will change to ``False `` in a future Python release.
338338:type autocommit: bool
339339
340- :rtype: Connection
340+ :rtype: ~sqlite3. Connection
341341
342342 ..audit-event ::sqlite3.connect database sqlite3.connect
343343 ..audit-event ::sqlite3.connect/handle connection_handle sqlite3.connect
@@ -1129,7 +1129,7 @@ Connection objects
11291129 Works even if the database is being accessed by other clients
11301130 or concurrently by the same connection.
11311131
1132- :param Connection target:
1132+ :param~sqlite3. Connection target:
11331133 The database connection to save the backup to.
11341134
11351135:param int pages:
@@ -1530,12 +1530,12 @@ Cursor objects
15301530
15311531 For every item in *parameters *,
15321532 repeatedly execute the:ref: `parameterized <sqlite3-placeholders >`
1533- SQL statement *sql *.
1533+ :abbr: ` DML ( Data Manipulation Language ) ` SQL statement *sql *.
15341534
15351535 Uses the same implicit transaction handling as:meth: `~Cursor.execute `.
15361536
15371537:param str sql:
1538- A single SQL:abbr: ` DML ( Data Manipulation Language ) ` statement.
1538+ A single SQL DML statement.
15391539
15401540:param parameters:
15411541 An:term: `!iterable ` of parameters to bind with
@@ -1558,6 +1558,13 @@ Cursor objects
15581558 # cur is an sqlite3.Cursor object
15591559 cur.executemany("INSERT INTO data VALUES(?)", rows)
15601560
1561+ ..note ::
1562+
1563+ Any resulting rows are discarded,
1564+ including DML statements with `RETURNING clauses `_.
1565+
1566+ .. _RETURNING clauses :https://www.sqlite.org/lang_returning.html
1567+
15611568 ..deprecated-removed ::3.12 3.14
15621569
15631570:exc: `DeprecationWarning ` is emitted if