> I find the generic version of the function definitions less than
> satisfactory. I'd guess it would be had to make Sphinx pickup the
> more detailed info in these situations? I'd also guess the decorators
> could maybe manipulate the docstring and inject some information based
> on the argument
(Say that subject three times fast.)
I'm looking at a ticket whose main purpose is to apply the
@rename_keyword decorator in lots of places, outside of the plot
module, where it was first employed.
When I build the HTML version of the reference manual, it would appear
these functions are now list
