#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
Reporter: mpatel | Owner:
tba
Type: enhancement | Status:
needs_review
Priority: major | Milestone:
sage-pending
Component: documentation | Resolution:
Keywords: days38 | Work issues:
Report Upstream: N/A | Reviewers:
Volker Braun
Authors: Mitesh Patel, John Palmieri, Florent Hivert | Merged in:
Dependencies: #13143 | Stopgaps:
---------------------------------------------------------------+------------
Comment (by jhpalmieri):
Replying to [comment:132 jdemeyer]:
> Does this patch enable links like {{{:func:`plot()`}}} from other
manuals (e.g. the developer manual) to the reference manual?
I think so, but it ought to be tested. You might need to specify the
cross-reference more explicitly, the way you might if you want to
reference the Python docs, for instance.
Replying to [comment:133 kcrisman]:
> > I consider it a requirement that there are no visible warnings/errors
when building the documentation from scratch. Otherwise, it becomes
difficult to differentiate warnings caused by this ticket from true
warnings.
> John, is this even possible under this setup? It would really be a shame
to hold this up but Jeroen makes a good point as well.
I thought that Florent had ideas about how to get rid of the one remaining
warning. (As I said before, the intersphinx warnings are turned off on the
first pass through the reference manual when you do `sage --docbuild all
html`, and I think this is appropriate.)
I'll try to look into both of these. Anyone else is welcome, also.
Florent, do you have any time these days?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:134>
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.
