#9976: Decorated functions/methods have generic signature in documentation
--------------------------------+-------------------------------------------
Reporter: jsrn | Owner: jsrn
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-4.7
Component: documentation | Keywords: sphinx, documentation, cython
inspection
Author: jsrn, Simon King | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
--------------------------------+-------------------------------------------
Comment(by jsrn):
inspect.getargspec is used two places that we haven't touched:
plot.plot3d.plot3d and server.notebook.interact. I am wondering whether
they should use sageinspect.sage_getargspec instead.
plot3d uses it for getting information on the constructor of child classes
of Coordinate; can these ever be Cython classes e.g.? I guess they could
be decorated classes, which means that the inspection code in plot3d will
fail, as it would see the decorator's constructor.
interact uses it for the @interact decorator to get information on what
widgets to present to the user. I guess we have the same again: it might
be an already decorated function we @interact with, meaning that code will
fail. Can one write Cython code interactively in the notebook (I guess
not; it would need to be compiled)?
Continuing my review...
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9976#comment:80>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
