#10823: environment variable SAGE_SPKG_INSTALL_DOCS to build and install spkg 
docs
---------------------------+------------------------------------------------
   Reporter:  jason        |       Owner:  tbd         
       Type:  enhancement  |      Status:  needs_review
   Priority:  major        |   Milestone:  sage-4.6.2  
  Component:  packages     |    Keywords:              
     Author:               |    Upstream:  N/A         
   Reviewer:               |      Merged:              
Work_issues:               |  
---------------------------+------------------------------------------------

Comment(by drkirkby):

 Replying to [comment:6 jason]:
 > CCing our resident shell script expert for comments: David, is there
 anything else that should be done in the above snippet of shell script?

 I would indent the

 {{{
     echo "Error building numpy docs."
     exit 1
 }}}

 for clarity. Apart from that, it looks OK. It will put the docs in a
 directory

 {{{
 $SAGE_ROOT/local/share/doc/numpy/html
 }}}

 not

 {{{
 $SAGE_ROOT/local/share/doc/numpy
 }}}

 but I think that's a good idea, as some docs might be in pdf, others in
 html etc.

 I think it would be more normal to copy the files, rather than move them,
 so the build directory remains intact. (It usually gets deleted anyway,
 but there are ways of saving the contents).

 Overall, I think this is a good proposal. Lots of programs used by Sage
 have documentation which we don't use. There may be other tools needed to
 generate some of the files - (GNU info for example). In cases like that,
 it might be worth checking if the right tool existed.

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/10823#comment:10>
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.

Reply via email to