Chris Jerdonek added the comment: > (The double signature might be easier to understand, but the original issue should probably be fixed in Sphinx, even if we decide to stop using this kind of signature.) I filed an issue for this in the Sphinx tracker here: https://bitbucket.org/birkenfeld/sphinx/issue/1001/comma-after-leading-optional-argument-in ---------- _______________________________________ Python tracker <report at bugs.python.org> <http://bugs.python.org/issue15831> _______________________________________