homepage

It would be useful if the 
 autodoc-process-docstring
event from sphinx.ext.autodoc allowed to change the argspec of the 
function being documented. Some other hook for changing the function 
signature would also do.
We are using Sphinx for generating a reference guide for Numpy, where 
many of the functions are from extension modules for which 
inspect.getargspec does not work. Instead, the function signature is 
contained within the object's docstring. Right now I'm simply 
monkeypatching sphinx.ext.autodoc.format_signature, but a cleaner 
approach would be better.
It seems that this would be fairly easy to implement in generate_rst. 
Perhaps a .signature attribute to the Options passed to the hook would 
be an acceptable solution?
I can write a patch doing this, if someone doesn't do this faster.

Suggested patch attached. Tested on Numpy documentation.
It adds a new signal,
 autodoc-process-signature(app, what, name, obj, options,
 signature, return_annotation)
which is assumed to return either None or a 
new (signature, return_annotation) tuple. Warnings are raised
only if introspection fails and none of the event handlers returns
a new signature.

Thanks, committed the patch with a few changes in r65290. Let me know if
it works!

Thanks, works OK.