sagetex documentation

[John Cremona]

According to the online documentation at
http://www.sagemath.org/doc/installation/sagetex.html the
documentation for sagetex is in
SAGE_ROOT/local/share/texmf/tex/generic/sagetex/sagetexpackage.pdf but
in my installation of Sage-5.7 that files does not exist in that
place. The only files with prefix sagetexpackage on my system are the
ones in the texlive documentation which I know to be out of date.

Can someone give me a pointer to the current documentation (and also
fix the bad reference cited above)?

Thanks,

John Cremona

[Johan Grönqvist]

2013-03-09 16:41, John Cremona skrev:
> According to the online documentation at
> http://www.sagemath.org/doc/installation/sagetex.html the
> documentation for sagetex is in
> SAGE_ROOT/local/share/texmf/tex/generic/sagetex/sagetexpackage.pdf but
> in my installation of Sage-5.7 that files does not exist in that
> place. The only files with prefix sagetexpackage on my system are the
> ones in the texlive documentation which I know to be out of date.

I have a file local/share/doc/sagetex/sagetex.pdf under my sage root,
which looks promising, and which has a date very close to the date in
the sagetex.sty file, which makes me think that it is up-to-date.

I am not sure if I had the file prior to running

./sage --docbuild all pdf

but I do have it now.

(I use sage 5.7 which I built from the source)

Hope it helps,

Johan

[John Cremona]

Thanks, I have that file too: so the only error is in the
documentation which gives the wrong path to the file.

The pdf I have in my 5.7 build from source was part of the
distribution, it seems, since it has a datestamp of Jan 15 while I
made that build in February, and had not built any pdf docs.

I did not think that the Sage source distribution included pdf files,
but it appears that I was wrong.

John

> --
> You received this message because you are subscribed to the Google Groups
> "sage-support" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to sage-support...@googlegroups.com.
> To post to this group, send email to sage-s...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sage-support?hl=en.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>

[Dan Drake]

On Sat, 09 Mar 2013 at 06:06PM +0000, John Cremona wrote:
> I did not think that the Sage source distribution included pdf files,
> but it appears that I was wrong.

SageTeX includes PDFs of the documentation because we don't want to
assume a working TeX distribution is present. (Although if you don't have
such a thing, you likely won't be using SageTeX...) There's also the
typeset version of the example file, which is nice so users can compare
the source and the output. The PDFs add about 400 KB to the source
tarball which is reasonable, considering we also ship a compiler!

I do notice that the share/doc/sagetex directory doesn't have the
example.tex file, which it should. I'll try to fix that and change the
documentation.

Dan

--
--- Dan Drake
----- http://math.pugetsound.edu/~ddrake
-------

[Dan Drake]

On Sat, 09 Mar 2013 at 06:06PM +0000, John Cremona wrote:

> Thanks, I have that file too: so the only error is in the
> documentation which gives the wrong path to the file.

This is now http://trac.sagemath.org/sage_trac/ticket/14264 .

[John Cremona]

Thanks Dan. Now I have a harder (I suspect) question...

I have quite a long Sage script which does a complicated computation I
have been working on with a student of mine (in case anyone is
interested it computes explicit models for three modular curves of
level 13, all of genus 3!). In my normal way I have a plain .sage
file which I can read in, which outputs useful info as it goes, and
which also contains a lot of comments about what it is doing. As the
script has grown, so too have the comments, to the extent that they
vastly outnumber lines of code.

I should probably convert this into a worksheet with the comments as
nice text cells. But as an alternative and an experiment I started
making it into a sagetex document -- we might even write up this
computation at some point after all. However, there are a few lines
near the beginning of the script which take a while to run (a minute
or two), and I became impatient at having to wait that time every time
I had to rerun Sage after adding to the latex file.

Wouldn't it be nice if somehow the Sage process which does the
computations required for sagetex to be kept running so that when
recompiling the latex, only new lines would be computed and not
everything from scratch? Or perhaps this is a silly idea and I should
just use a worksheet and output the whole thing to pdf when finished.

John

[John Cremona]

On 9 March 2013 18:53, Dan Drake <ddr...@pugetsound.edu> wrote:
> On Sat, 09 Mar 2013 at 06:06PM +0000, John Cremona wrote:
>> Thanks, I have that file too: so the only error is in the
>> documentation which gives the wrong path to the file.
>
> This is now http://trac.sagemath.org/sage_trac/ticket/14264 .

Correction: http://trac.sagemath.org/sage_trac/ticket/14246

John