#19963: Build documentation in $SAGE_SHARE/doc/sage
-------------------------------------+-------------------------------------
Reporter: jdemeyer | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-7.1
Component: build | Resolution:
Keywords: | Merged in:
Authors: Jeroen Demeyer | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jdemeyer/build_documentation_in__sage_local_share_doc_sage|
de10a5ed704bac161fa3f43d381cd3aac0776817
Dependencies: #19127 | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by fbissey):
I am going through the changes in #19127 first. You made it incredibly
difficult to build the documentation before having installed sage at all.
Unless I was lucky before (possible but unlikely considering the amount of
stuff that can go wrong) that's a regression as far as I am concerned. But
it is too late for this in that ticket or this ticket.
The code here looks ok to me, it is mostly house keeping.
The html and the pdf documentations are moved to a new home and only the
`rst` file are left behind. The only mention left of `SAGE_DOC` in the
current form is in `sage/misc/sagedoc.py`, possibly too hard for this
ticket but if it is only for building at least some parts of `sagedoc.py`
could/should be moved to `sage_setup/docbuild`.
There is also some mention of `SAGE_DOC` and `SAGE_DOC/output` in
`sage/misc/latex_macros.py`. Only in documentation and comment blocks. At
least two of these should be replaced by `SAGE_DOC_OUTPUT`, the first
instance is to quote a path in sage's source tree. Ultimately this should
be shipped too in my opinion but at this stage is the only instance of
`SAGE_DOC` that is not superfluous once that sage is installed - outside
of `sage_setup/docbuild`.
--
Ticket URL: <http://trac.sagemath.org/ticket/19963#comment:14>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
