On Thu, Jul 9, 2009 at 11:51 PM, davidloeffler<[email protected]> wrote:
<SNIP> >> Thanks for noting this. This is one of the problems we're trying to >> eliminate at >> >> http://trac.sagemath.org/sage_trac/ticket/6187 >> >> I will try to update the current patches so that the builder does not >> throw an error, if an auto-generated .rst file is missing. >> > > I'm seeing a possibly related problem. I have a branch X, in which I > have done a patch that adds lots of files to the reference manual. If > I build docs in branch X, then switch to a different branch Y and try > and build docs there, I get loads of warnings about bad formatting in > the relevant files, since somehow the ReST parser can still see them, > and sees the un-edited versions with non-ReSTified docstrings -- even > though they're not linked into the reference manual in branch Y! How > on earth can this happen? I'm getting a similar problem with a cloned repository. I'm working on Cythonizing a Sage library module written in Python. After converting that module to Cython, I also added some extra documentation to the docstring of the module. I did create a .pxd file containing relevant declarations, and have added this new Cythonized module to the list of Cython modules in the file module_list.py. I don't see a need to touch the relevant .rst file under doc/en/reference, since I've only changed the file extension from .py to .pyx. The Cythonized module compiled OK and all doctests passed. Immediately after making a clone repository in which to do this Cythonization, I built the reference manual. After Cythonizing the module, compiled it, and ran all doctests, I rebuilt the reference manual. However, when I viewed the relevant HTML page of the reference manual, the extra documentation that I added to the Cythonized module didn't show up. In fact, that page is the same as it was prior to the Cythonization. -- Regards Minh Van Nguyen --~--~---------~--~----~------------~-------~--~----~ 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-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
