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 <rep...@bugs.python.org> <http://bugs.python.org/issue27188> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com