#6187: [with patch, needs work] 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.1
Component: documentation | Keywords:
Reviewer: John Cremona | Author: John Palmieri, Mitesh Patel
Merged: |
---------------------------+------------------------------------------------
Changes (by mpatel):
* cc: mhansen, mvngu, davidloeffler (added)
Comment:
Apply only the v4 pair to the appropriate repositories. The
`testreference` patch just adds a non-trivial test document that should
build quickly. It may give an indication, at least, of the behavior to
expect when building the full reference manual.
Changes in v4:
* Reordering of some code and somewhat better case / exception handling
in the reference builder.
* First steps with Python's [http://docs.python.org/library/logging.html
logging] framework. It's powerful and easy to use, at least inside one
module. One of Sphinx's utility modules colorizes some of the output.
* More aggressive use of Python's
[http://docs.python.org/library/optparse.html optparse] module, in order
to provide several new command-line options (cf. #6488). The previous
syntax should still work, however.
* `sage-clone` should now be compatible with #6512. `--update_mtimes` is
now `--update-mtimes`.
I've focused on the reference manual, but I hope the new pieces make it
easier to improve the docbuild system for the other documents, too. Feel
free to make constructive comments, as well as changes. In particular, we
should settle on the option names.
Anyway, if possible, please test the patches in multiple real-world
scenarios, including those mentioned on [http://groups.google.com/group
/sage-
devel/browse_thread/thread/f28cef82a0a3ccd1/05b695146514021d?#05b695146514021d
sage-devel]. I'd like to take care of all known, relevant "ref-cloning"
issues (cf. #5350) before this ticket closes. It is likely we're not
there yet.
I've added a few recipients to the CC list. I hope that's OK.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6187#comment:17>
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
-~----------~----~----~----~------~----~------~--~---
