#6187: [with patch, needs review] After making a clone, the reference manual
(and
other docs) should not have to be completely rebuilt.
---------------------------+------------------------------------------------
Reporter: jhpalmieri | Owner: tba
Type: enhancement | Status: new
Priority: major | Milestone: sage-4.1
Component: documentation | Keywords:
Reviewer: John Cremona | Author: John Palmieri
Merged: |
---------------------------+------------------------------------------------
Comment(by jhpalmieri):
So we could add {{{sage -docbuild reference html --update_mtimes
--jsmath}}} to the {{{sage-clone}}} script, right?
The only issue I see is that if someone has made some changes and then
clones before rebuilding the reference manual, the {{{-update_mtimes}}}
option tells Sage/Sphinx that the ref manual page doesn't need to be
changed. I guess we can add a warning to sage-clone like the warning
already there.
This works with or without the patch at #5350, and it works appropriately
with or without the {{{--jsmath}}} switch. It has no effect on other
documents, as one would expect, but I think that's fine. Same for the
other builders.
Here are two new patches, one which is just mpatel's patch to builder.py
(and which receives a positive review from me). The other adds some code
to sage-clone to do the {{{update_mtimes}}} thing to the reference manual;
it tries to figure out whether to use {{{--jsmath}}} or not; is there a
better way to do this than what I have? It also prints a brief message
about the reference manual. The only thing that needs to be reviewed is
this second patch (to the scripts repository).
I like this version better than my old patch: it keeps the old cloning
process, so it seems safer to me. So I'm changing this from "positive
review" (for the old patch) to "needs review" (for the new scripts patch).
Apply "trac_6187_mpatel.patch" to the sage repository, and apply
"trac_6187_new_scripts.patch" to the scripts repository.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6187#comment:11>
Sage <http://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
-~----------~----~----~----~------~----~------~--~---
