Hi everyone

Can someone please review ticket #9976; its patch has been there for
~6 months now.
It fixes a problem with decorators and Sphinx: as it is now, most
decorated functions will get a generic signature in the Sphinx
documentation. Notable examples include most of the plot commands,
e.g.
  http://sagemath.org/doc/reference/sage/plot/plot.html#sage.plot.plot.plot
as well as any function decorated with the "deprecated"-decorator
(used for deprecating named arguments).

The ticket introduces a new way of handling this by slightly patching
Sphinx and including extra information in the "sage_wraps" decorator.
The latter is an extension of the pure Python "wraps" decorator, which
is already mandatory to use in decorators meant to decorate top-level
callables.

Cheers,
Johan

-- 
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to 
sage-devel+unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org

Reply via email to