Hi,
I like to have some advice on how to develop my own code and have a 
proper documentation for it.
In python all is clear, you write a .py file and supply the docstring 
with proper reST text and code for epydoc, doctest and/or Sphinx. With 
nzmath you can do a lot of math things (and it works also on my phone :-)
Sage uses .sage files and worksheets, and the way to document is 
described in the development manual.
With sage -t I can test my code, but can I also use epydoc and/or Sphinx 
for myself, without wanting to build the sage documentation, from within 
sage?
What about the worksheetcode? It looks as if the worksheet is good for 
prototyping, researching (very very handy), but not for development of 
code and unit and doctesting it. You need copy and paste to make .sage 
files, which can then be documented and tested properly, and reloaded in 
the worksheet when necessary.
So, what is a good procedure for working with sage?

At the moment I have 3.4 on a UBUNTU 8.10 system, locally compiled and 
generated docs, I prefer the A4 documentation in stead of the letter size.

regards,
Ton Biegstraaten

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

Reply via email to