#13852: fix "SEVERE" warning during docbuilding for matrix/benchmark.py
---------------------------------+------------------------------------------
Reporter: jhpalmieri | Owner: tbd
Type: defect | Status: new
Priority: blocker | Milestone: sage-5.6
Component: PLEASE CHANGE | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: John Palmieri | Merged in:
Dependencies: | Stopgaps:
---------------------------------+------------------------------------------
Description changed by jhpalmieri:
Old description:
> When building the documentation, a warning appears:
> {{{
> SAGE_ROOT/local/lib/python2.7/site-
> packages/sage/matrix/benchmark.py:docstring of
> sage.matrix.benchmark.SetPartitionsAk:3: SEVERE: Unexpected section
> title.
>
> Methods
> -------
> }}}
> I think this is due to the line
> {{{
> from sage.all import *
> }}}
> at the top of that file. Its page in the reference manual includes (for
> reasons I don't understand) entries from all kinds of functions which are
> not present in that file, like
> "sage.matrix.benchmark.SetPartitionsAk(k)",
> "sage.matrix.benchmark.allocatemem", and others. Changing the import
> statement to be more precise seems to fix things.
New description:
When building the documentation, a warning appears:
{{{
SAGE_ROOT/local/lib/python2.7/site-
packages/sage/matrix/benchmark.py:docstring of
sage.matrix.benchmark.SetPartitionsAk:3: SEVERE: Unexpected section title.
Methods
-------
}}}
I think this is due to the line
{{{
from sage.all import *
}}}
at the top of that file. Its page in the reference manual includes (for
reasons I don't understand) entries from all kinds of functions which are
not present in that file, like `sage.matrix.benchmark.SetPartitionsAk(k)`,
`sage.matrix.benchmark.allocatemem`, and others. Changing the import
statement to be more precise seems to fix things.
--
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13852#comment:1>
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.
