#7943: move docbuild commands to their own targets in SAGE_ROOT/makefile
-------------------------------+--------------------------------------------
Reporter: mvngu | Owner: mvngu
Type: defect | Status: positive_review
Priority: major | Milestone: sage-4.3.3
Component: documentation | Keywords:
Author: Mitesh Patel | Upstream: N/A
Reviewer: Minh Van Nguyen | Merged:
Work_issues: |
-------------------------------+--------------------------------------------
Comment(by jhpalmieri):
I think I object to the positive review here, because having complete
documentation is an important part of Sage, but it looks like with these
patches, building Sage from source will not build the documentation.
Correct me if I'm wrong about this.
At the very least, since this is a major change, this should discussed
more thoroughly in sage-devel before doing this.
What happens if we add "doc" to the targets in the makefile for "make
all"?
> Since the test targets in SAGE_ROOT/makefile do not depend on the doc
targets, we may get reports about failed doctests in sage.misc.sagedoc
If you feel, as I do, that the documentation is an integral part of Sage,
then it's reasonable that if you try doctesting with an incomplete Sage
build (for example, if you're missing the documentation), you should not
be surprised if there are doctest failures. The failures do say "Warning,
the following Sage documentation...", so it's more or less clear why they
failed.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/7943#comment:9>
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.
