#7796: prevent Sphinx from rebuilding full document
-----------------------------+----------------------------------------------
Reporter: mvngu | Owner: mvngu
Type: defect | Status: needs_review
Priority: major | Milestone: sage-4.3.1
Component: documentation | Keywords:
Work_issues: | Author: Minh Van Nguyen
Upstream: N/A | Reviewer:
Merged: |
-----------------------------+----------------------------------------------
Comment(by mvngu):
I took the source tarball of Sage 4.3 and replaced the package
sphinx-0.6.3.p3.spkg` with `sphinx-0.6.3.p4.spkg`. I then built Sage 4.3
with the updated Sphinx package. On a newly compiled Sage 4.3 with the
updated Sphinx spkg, I tested the updated Sphinx spkg as follows:
1. The command "./sage -docbuild all html" didn't rebuild any of the
documents in the standard documentation.
1. I made a clone of the main branch and executed "./sage -docbuild all
html", which build the doc.
1. I made a trivial change to a file in the cloned branch. Again, I ran
"./sage -docbuild all html", which only rebuilt the portion of the
document that has changed.
1. Switching back to the main branch didn't rebuild any of the documents.
So the problem here is that the updated Sphinx spkg needs to also be built
and installed during the build process of Sage. That is, you need to
replace the previous version of the Sphinx package with the updated spkg
before compiling Sage 4.3 from source. You would still experience the same
problem of documents rebuilding if you force an installation of the
updated Sphinx spkg on an already compiled Sage.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/7796#comment:3>
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.
