#8244: Annoying warnings when building the HTML reference manual
-----------------------------+----------------------------------------------
Reporter: mpatel | Owner: mvngu
Type: defect | Status: new
Priority: major | Milestone: sage-4.3.3
Component: documentation | Keywords:
Author: | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
-----------------------------+----------------------------------------------
Changes (by jhpalmieri):
* cc: mhansen, craigcitro (added)
Comment:
I've looked at these a bit, but I have no idea how to fix them. Oh,
except for
{{{
plot/plot3d/base.rst:6: (WARNING/2) error while formatting signature for
sage.plot.plot3d.base.Graphics3d.export_jmol: Could not parse cython
argspec
}}}
This is because {{{_sage_getargspec_cython}}} in sage.misc.sageinspect is
a little broken, and fixing it might be lot of work: right now it parses
arguments to Cython function by doing basic string and regular expression
manipulations, in particular separating arguments by splitting the line on
commas. The function {{{export_jmol}}} has argspec
{{{
def export_jmol(self, filename='jmol_shape.jmol', force_reload=False,
zoom=100, spin=False, background=(1,1,1),
stereo=False,
mesh=False, dots=False,
perspective_depth = True,
orientation = (-764,-346,-545,76.39), **ignored_kwds):
}}}
and so splitting at commas doesn't work. To do this right, we either need
to write a good parser (which deals with nested lists, tuples, etc.), or
perhaps change the whole way we deal with argspecs for Cython functions;
for example, just read off the entire string of all the arguments and pass
that to the appropriate function, instead of trying to break it into
arguments, default values, etc. This is a pretty rare problem and it
looks annoying to deal with, so I haven't felt like putting any time into
it.
mhansen and craigcitro: any comments or ideas?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/8244#comment:2>
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.
