On Nov 28, 2007 10:36 PM, jonhanke <[EMAIL PROTECTED]> wrote:
>
>
>
> On Nov 29, 6:22 am, "William Stein" <[EMAIL PROTECTED]> wrote:
>
> > On Nov 28, 2007 9:11 PM, jonhanke <[EMAIL PROTECTED]> wrote:
> >
> > > > So you needn't be afraid of worksheets being stored in some
> > > > weird internal database or binary file -- they're just in
> > > > the directory sage_notebook/worksheets/username/number/worksheet.txt
> >
> > > > One nice benefit of this is if you want to find all worksheets on your
> > > > computer
> > > > in any directory that contain "this worksheet proves the Riemann
> > > > Hypothesis",
> > > > say, then you can just do a full text search and you'll find them.
> >
> > > > William
> >
> > > Great! That's exactly what I wanted to know. =)
> >
> > Could you think back about when/how/where you might have looked or
> > thought to look in the documentation for this sort of information? It's of
> > course not anywhere in the documentation, but if you could explain where
> > you think it should have been, we could stick it here. Even better, you
> > could even put it there and submit a patch.
>
> Yes, I googled for """sage notebook data files""", which gave me the
> following Sage Reference Manual links:
>
>
> http://modular.math.washington.edu/sage/doc/html/ref/module-sage.server.notebook.twist.html
> http://www.sagemath.org/doc/html/inst/node10.html
> http://modular.math.washington.edu/sage/doc/html/prog/node73.html
>
> and the talk of Alex Clemesha:
>
>
> http://modular.math.washington.edu/sage/talks/2006-11-17-alex-clemesha/sage-talk-notebook.pdf
>
> Not surprisingly, the Sage Days talk notes tend to be very useful
> references for core functionality (and I would suggest possibly making
> a home for some of them by topic on sagemath under Documentation).
>
> This should really be mentioned in two separate places:
>
> 1) Describing structure (and location) of the sage_notebook
> directory
> [Programming Guide]
>
> 2) Migration from a previous version
> [Users Guide]
>
> (The Users Guide to me is something between the Tutorial and the
> Reference Manual, and describes common operations and questions. The
> topics here should initially come from complete answers given in the
> sage-support list, as well as common-knowledge practices for power
> users.)
>
> I'm maintaining for myself a list of common tasks that I have to do,
> and would be happy to assemble these in a document and add it
> somewhere. Is there any good documentation documentation? I found
> this thread:
>
> http://groups.google.com/group/sage-devel/browse_thread/thread/40b31802dd3405a3/126b407a062cda63?hl=en&lnk=gst&q=documentation#126b407a062cda63
>
> but it only describes how to dynamically update a local copy of the
> Reference manual. What about changing the Tutorial/Programming Guide?
For the tutorial edit
SAGE_ROOT/devel/doc/tut/tut.tex
and for the programming guide edit
SAGE_ROOT/devel/doc/prog/prog.tex
Once you edit one of those files do
cd SAGE_ROOT/devel/doc/tut/
./build_dvi
to build the dvi version in the current directory, or ./build_pdf to
build a pdf.
Make sure it looks good. Then do hg_doc.ci(); hg_doc.export(...) or
hg_doc.send(...)
etc.
-- William
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-support@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/sage-support
URLs: http://sage.math.washington.edu/sage/ and http://sage.scipy.org/sage/
-~----------~----~----~----~------~----~------~--~---
