Re: [matplotlib-devel] MEP10: Modernize documentation.

[Todd <tod...@gm...>]

On Wed, Jan 9, 2013 at 6:20 PM, Nelle Varoquaux
<nel...@gm...>wrote:
>
> - use the autodoc_docstring_signature of sphinx 1.1, which allow to have
> the explicit function signature instead of the python one in the generated
> documentation (args* and **kwargs are replaced by the explicits arguments)
>
>
If you have to  manually write out the function signature anyway, might
this be an opportunity to review whether the use of *args and **kwargs is
really necessary on a case-by-case basis?  I would think from a code
clarity and maintenance standpoint minimizing the use of *args and **kwargs
would be beneficial.