diff -r 3a57eafd8401 Doc/library/sqlite3.rst --- a/Doc/library/sqlite3.rst Tue May 24 09:15:14 2016 +0300 +++ b/Doc/library/sqlite3.rst Mon Jun 06 17:23:54 2016 -0700 @@ -300,24 +305,26 @@ call :meth:`commit`. If you just close your database connection without calling :meth:`commit` first, your changes will be lost! - .. method:: execute(sql, [parameters]) + .. method:: execute(sql[, parameters]) - This is a nonstandard shortcut that creates an intermediate cursor object by - calling the cursor method, then calls the cursor's :meth:`execute - ` method with the parameters given. + This is a nonstandard shortcut that creates a cursor object by + calling the cursor method, calls the cursor's :meth:`execute + ` method with the parameters given, and returns the cursor. - .. method:: executemany(sql, [parameters]) + .. method:: executemany(sql[, parameters]) - This is a nonstandard shortcut that creates an intermediate cursor object by - calling the cursor method, then calls the cursor's :meth:`executemany - ` method with the parameters given. + This is a nonstandard shortcut that creates a cursor object by + calling the cursor method, calls the cursor's :meth:`executemany + ` method with the parameters given, and returns the + cursor. .. method:: executescript(sql_script) - This is a nonstandard shortcut that creates an intermediate cursor object by - calling the cursor method, then calls the cursor's :meth:`executescript - ` method with the parameters given. + This is a nonstandard shortcut that creates a cursor object by + calling the cursor method, calls the cursor's :meth:`executescript + ` method with the given script, and returns the + cursor. .. method:: create_function(name, num_params, func) @@ -524,7 +531,7 @@ A :class:`Cursor` instance has the following attributes and methods. - .. method:: execute(sql, [parameters]) + .. method:: execute(sql[, parameters]) Executes an SQL statement. The SQL statement may be parameterized (i. e. placeholders instead of SQL literals). The :mod:`sqlite3` module supports two