Sign Up to our social questions and Answers Engine to ask questions, answer people’s questions, and connect with other people.
Login to our social questions & Answers Engine to ask questions answer people’s questions & connect with other people.
Lost your password? Please enter your email address. You will receive a link and will create a new password via email.
Please briefly explain why you feel this question should be reported.
Please briefly explain why you feel this answer should be reported.
Please briefly explain why you feel this user should be reported.
I have the following function definition (docstring simplified for this example):
def ui(*classes, call_init=False):
'create a metaclass based on *classes*'
...
When I create a documentation using sphinx-autodoc (specifically, automodule), it generates the following signature for this function
ui(call_init, *classes)
Can anyone explain why sphinx-autodoc is getting the signature the wrong way round? Also, is there a way to get it to include default value of *call_init*?
According to comments made by Wooble on the question, this is a python 2/python 3 difference. And there’s already a bug report with an available patch: https://bitbucket.org/birkenfeld/sphinx/issue/828/autodoc-python3-keyword-only-arguments .