On Wed, 10 Dec 2008 at 01:43AM -0600, Jason Grout wrote:
> Cool.  I just posted a note on Arxiv with a .sage program file, and
> I'm seeing the same problem.  (I thought the doctests passed, but
> apparently they don't and I'm seeing the same problem; I think I got
> around this once by "including" the file as part of the sage standard
> library and then running the doctests.).

Yeah, I can easily put the file in the standard library and doctest it,
but the point is that it should be easy for other people to run
doctests; they download the code, run a "sage -t", and when everything
passes, they start using it. This preprint will get posted sometime
soon, but (hopefully!) people will find my code useful many years from
now with a future version of Sage.

Doctesting is like putting your code in the refrigerator instead of
leaving it out -- it helps prevent bitrot. :)

> 2. (this is totally a preference thing) I think it's helpful for
> people if you put that there is a Sage program included in the
> preprint in the comments, just like you would if there was a figure or
> something.  Plus, everyone that gets the arxiv email starts seeing
> references to Sage programs; that helps our marketing department :).

Exactly! I'm using the listings package to actually put the code into
the PDF and am including some explanatory propaganda. I understand that
very few people will actually download the tarball and get the .sage
file, so I figured I can at least put the code in front of their eyes.

While I am adding to this thread, I'll mention a trick: in the article,
I want to mention how to get the .sage file -- but to do that, I need to
know the arXiv URL. But how do you find out the eprint number before you
submit? The answer is to make your submission early in the day, get it
accepted -- so you find out the eprint number! -- then go back, update
your TeX file with the URL, and resubmit. If you do this early enough
(before 4 pm ET?) it doesn't show up as a new version.

Dan

-- 
---  Dan Drake <[EMAIL PROTECTED]>
-----  KAIST Department of Mathematical Sciences
-------  http://mathsci.kaist.ac.kr/~drake

Attachment: signature.asc
Description: Digital signature

Reply via email to