On 12/28/2009 09:02 AM, John Cremona wrote: > Luckily my edits worked first time so I did not have to do the cycle > again; but and work on docstrings will be rather tedious unless > someone can work out why this is happening.
I think the source may be #7683 http://trac.sagemath.org/sage_trac/ticket/7683 which adds a config value autodoc_builtin_argspec to Sphinx. This lets us set autodoc_builtin_argspec = sage.misc.sageinspect.sage_getargspec to detect the arguments of methods and functions defined in Cython files. Sphinx compares the current set of config values to a pickled set to decide whether to reread all documents on the grounds [config changed] But autodoc_builtin_argspec is a function, which, I think, Sphinx pickles as None. Moreover, sage_getargspec gets a different identity id(sage_getargspec) [nearly] each time Sphinx is run. This mismatch may trigger the full rebuild. A possible workaround: In SAGE_LOCAL/lib/python2.6/site-packages/Sphinx-0.6.3-py2.6.egg/sphinx/environment.py import inspect and insert, e.g., if inspect.isfunction(config[key]): continue around line 474. -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
