#sphinx-doc

I have a sphinx issue ( **kargs in __init__ not processed correctly) ... can someone please have a look? https://github.com/iminuit/iminuit/pull/132#iss...

Guest26433: where does the signature come from? it should be in the ..class:: argument

It comes from here: https://github.com/iminuit/iminuit/blob/master/...

Included via autosummary here: https://github.com/iminuit/iminuit/blame/master...

What do I have to change?

that looks good to me

I'll clone and check

You should clone this branch: https://github.com/cdeil/iminuit/tree/rtd-theme (the master branch has other Sphinx issues which I fixed in that branch). Thanks!!!

I'm getting other warnings like WARNING: failed to import Minuit.mnprofile

You have to run these commands: `python setup.py build_ext -i; cd doc; make html`

ah yes.

Guest26433: ok. it seems that putting the signature in the class docstring is not supported due to a bug

Is there a workaround?

If no, not a big deal ... can you open an issue that I can watch?

sure, let me try a few things

Guest26433: there is no good workaround, but I will fix it for the next bugfix versions

well, you could set autoclass_content to "init" and add the signature in __init__ docstring

I'll just remove the -W option from the Sphinx build and ignore the warning for now ... it's OK if this gets fixed with the next Sphinx version ...

ok!

sorry for the inconvenience

Thanks for helping me out!!!

[sphinx] birkenfeld pushed 2 commits to default [+0/-0/±4] https://bitbucket.org/birkenfeld/sphinx/commits/

[sphinx] Georg Brandl <georg@python.org>; 6449819 - Fix :confval:`autodoc_docstring_signature` not working with signatures in class docstrings.

[sphinx] Georg Brandl <georg@python.org>; d912ef6 - merge with stable

[sphinx] birkenfeld pushed 1 commit to default [+0/-0/±1] https://bitbucket.org/birkenfeld/sphinx/commits/

[sphinx] Georg Brandl <georg@python.org>; 1ac4150 - Py3 fix.

is there a built in way when using dirhtml builder to keep downloads near html files vs always going into _downloads?

and also why does it copy every download file every time i build vs seeing the files haven't changed?