#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
Reporter: mpatel | Owner:
tba
Type: enhancement | Status:
needs_review
Priority: major | Milestone:
sage-5.1
Component: documentation | Resolution:
Keywords: days38 | Work issues:
Report Upstream: N/A | Reviewers:
Volker Braun
Authors: Mitesh Patel, John Palmieri, Florent Hivert | Merged in:
Dependencies: #12016 | Stopgaps:
---------------------------------------------------------------+------------
Comment (by hivert):
Hi John,
> I think this looks very good. I'm just about ready to give Florent's
part a
> positive review.
Wow !!! This is extremely cool. Thanks a lot ! I'm sorry for my current
silence. I didn't had the time to look at your part4 code. I'll try to do
it
shortly.
> Two questions: can we reinstate the `-Q` flag for the first pass on the
> reference manual, to silence all of the warnings?
No problem. I just wanted to have some idea of the progress and forgot to
switch back to a silent mode.
> Also, I see this warning message; do you know if it's important?
{{{
preparing documents... WARNING: search index couldn't be loaded, but not
all documents will be built: the index will be incomplete.
}}}
> (This occurs if I do `sage --docbuild all html`, at the end of the
second
pass through the reference manual.)
I'm not sure now. I'll though I had silenced this warning. Give me a few
day
to investigate a little more. It is probably not important as the produced
index is correct but I may be missing to merge somme part of it.
> I'm attaching one more version of the part 4 patch, just to fix a few
typos
> and grammar issues in the files Florent added.
Thanks for those rereading. I planned to polish more the code and try to
get
some feedback from Sphinx and didn't find the time. However I now think
that
we should let the code enter sage as soon as possible because it allows
the
doc to compile on small machine. At sage days 48, with mguaypaq (see
above) we
manage to compile the documentation in a seemingly satisfactory way on a
1GB
machine. Moreover its a requirement to the feature #12878 which I think is
definitely needed at least for huge classes such as graphs...
Thanks a lot,
Florent
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:91>
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.
