When you run 'make' in SAGE_ROOT, it builds sage and runs 'make doc-html'. 
I propose changing this so it instead runs 'make doc-html-jsmath', which 
uses jsMath to display math, rather than png images. In my experience, 
using jsMath is much faster, and the output looks good.  (Individual users 
can make this the default by setting the environment variable 
SAGE_DOC_JSMATH to "yes", by the way.)

[ ]  Yes, make jsMath the default when running 'make'.
[ ]  No, keep it as is.

-------

To compare the two, try this while in SAGE_ROOT:

   $ unset SAGE_DOC_JSMATH

   $ rm -rf devel/sage/doc/output
   $ time ./sage -docbuild tutorial html

Now repeat the last two lines: sometimes the first run through is slower 
than the rest. You should note how long it takes, and also look at the 
output. Then do

   $ rm -rf devel/sage/doc/output
   $ time ./sage -docbuild tutorial html -j  # "-j" says to use jsMath

and compare output and timings. On my machine, without jsMath takes about 2 
minutes, with jsMath takes about 10 seconds.

We must have had some reason for not using jsMath by default. Does anyone 
remember what it was?

-- 
John

-- 
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to 
sage-devel+unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org

Reply via email to