#7948: fix docstring processing errors in 4.3.1.rc0
-----------------------------+----------------------------------------------
Reporter: cremona | Owner: mvngu
Type: defect | Status: needs_review
Priority: major | Milestone: sage-4.3.1
Component: documentation | Keywords:
Work_issues: | Author:
Upstream: N/A | Reviewer:
Merged: |
-----------------------------+----------------------------------------------
Comment(by jhpalmieri):
Here's a third patch; together with the others, this gets us down to 144
warnings. One of the remaining warnings is because of the problems I
mentioned earlier about the sageinspect.py code for cython functions --
the code essentially needs to parse the {{{def f(...):}}} part of the
function to find the arguments. Right now, it does some simple searching
to find the part {{{(...)}}} in parentheses, and then it splits that up at
each comma. This breaks if there is a default argument like
{{{(vec=(1,0,0))}}}, and leads to the message "Could not parse cython
argspec".
For most of the other 143 warnings, I don't know what to do. (There are
some easy ones, but they're in sagenb, and I don't feel like working on
that right now. It should probably be a separate ticket, anyway.)
Sometimes, I also get the message
{{{
checking consistency...
/Applications/sage/devel/sage/doc/en/reference/sage/misc/attach.rst::
WARNING: document isn't included in any toctree
}}}
To deal with this, delete (by hand) the file
{{{SAGE_DOC/en/reference/sage/misc/attach.rst}}}.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/7948#comment:6>
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.
