[docs] [issue27188] sqlite3 execute* methods return value not documented

[Berker Peksag]

Berker Peksag added the comment:

Could you also change the function signatures from

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

to

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

and document that parameters should be list (or sequence or iterable -- I'm a the airport now so I can't check what is the correct term)?

I'm not a native speaker but this sentence sounds a bit weird to me:

    This is a nonstandard shortcut that creates a cursor object by calling the cursor method, calls the cursor's :meth:`execute <Cursor.execute>` [...]

Perhaps it can be changed to


    This is a nonstandard shortcut that creates a cursor object by calling the cursor's :meth:`execute <Cursor.execute>` method [...]

Also, please change the following usages

    :meth:`execute <Cursor.execute>`

with

    :meth:`~Cursor.execute`

----------
versions: +Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27188>
_______________________________________