On Wednesday, January 20, 2016 at 11:46:35 PM UTC-8, Jori Mäntysalo wrote:
>
> On Wed, 20 Jan 2016, John H Palmieri wrote:
>
> > Does this patch fix it?
>
> > --- a/src/doc/common/conf.py
> >
> > See sage.misc.sagedoc.skip_TESTS_block for more information.
> > """
> > + if len(docstringlines) == 0:
> > + return
>
> Yes. Thanks!
>
> > (I don't know why, but Sphinx is trying to read docstrings from
> functions
> > which have no docstrings, and these seem to be causing the errors.)
>
> Why we have functions without docstring?
>
>
For testing, I put in a "try ... except" block to see where it was failing,
and it said
sage/ext/interactive_constructors_c <sphinx.application.Sphinx object
at 0x10646eb50> function sage.ext.interactive_constructors_c.inject_off
<built-in function inject_off> []
The function inject_off has no docstring. The file
sage/ext/interactive_constructors_c.pyx is included in
src/doc/en/reference/repl/index.rst.
(And can Sphinx be used to found function without, say, EXAMPLES-blocks?)
>
Sphinx reads all docstrings from all included py and pyx files.
John
>
> --
> Jori Mäntysalo
>
--
You received this message because you are subscribed to the Google Groups
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.
