#9440: document more environment variables
---------------------------------+------------------------
       Reporter:  jhpalmieri     |        Owner:  mvngu
           Type:  enhancement    |       Status:  new
       Priority:  minor          |    Milestone:  sage-6.4
      Component:  documentation  |   Resolution:
       Keywords:                 |    Merged in:
        Authors:                 |    Reviewers:
Report Upstream:  N/A            |  Work issues:
         Branch:                 |       Commit:
   Dependencies:                 |     Stopgaps:
---------------------------------+------------------------

Comment (by kcrisman):

 > SAGE_DOC_JSMATH
 `SAGE_DOC_MATHJAX` is now in good shape.
 >  * SAGE_DOCBUILD_OPTS
 if it still exists
 >  * Add {{{PARI_EXTRA_OPTS}}}, which is passed to PARI's {{{Configure}}}
 when building Sage / installing the PARI spkg.
 >  * Add {{{CPPFLAGS}}}, {{{LDFLAGS}}}, {{{CXXFLAG64}}}?, {{{LDFLAG64}}}?
 {{{LD}}}?
 >  * Document that (e.g.) {{{export CFLAGS=""}}} has not the same effect
 as {{{unset CFLAGS}}}.
 >  * Add note on not putting a space between {{{-j}}} and {{{NUM}}} in the
 description of {{{MAKE}}}, because doing so has a "completely" different
 meaning...
 >  * Add warning to (setting) {{{SAGE_CHECK}}}, since this currently
 breaks most builds. This will (or should) be fixed in future releases
 though; there's afaik a ticket adding more options to the value of this
 variable...
 This is basically fine now
 >  * Add a note on / reference to {{{sage-env}}}.
 > Also, the description of some variables is incomplete, not current (in
 its use in all spkgs, e.g. {{{SAGE_DEBUG}}}), misleading, or even wrong
 ({{{SAGE_TIMEOUT*}}}).
 > I think the various variations of {{{SAGE_T[E]MP[[_]DIR]}}} are missing.
 (I wonder where e.g. {{{TMP}}} and {{{TMPDIR}}} are / may be used instead,
 or as a fall-back / default.)
 > {{{SHELL}}} might be relevant, too.
 > The {{{*ITER*}}} variables for (parallel) doctesting are missing.
 > I'm currently not sure if we have a similar section in the ''Developer's
 Guide'', but some variables like {{{SAGE_ROOT}}} and {{{SAGE_LOCAL}}}
 should be documented (there?), too.
 There is a ticket for the latter to be better, and the former is now in
 good shape.
 > I'm still pretty sure even more variables are missing... ;-)
 Indubitably.

--
Ticket URL: <http://trac.sagemath.org/ticket/9440#comment:7>
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 http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to