On Sep 27, 2008, at 11:52 AM, Gabriel Gellner wrote: > Well I have done some major updating to the Sphinx docs located at: > > www.mudskipper.ca/cython-doc/ > > (and under cython mercurial at: > hg.cython.org/cython-docs)
Thank you again so much! Improving the docs is something that has been on my todolist for a long time, but never quite made it to the top. > Highlights: > > * The very start of a tutorial (much more work will be done over > the next > week) > * Added Dag's Numpy Tutorial > * Basic Pygments Cython highlighter (still some bugs, but I will > iron them > out), so Cython is highlighted! > * Ipython highlighter added from the matplotlib guys (check out the > numpy > tutorial) > * Begun giving some real information on how to write setup.py files in > 'Source files and Compilation'. > * Removed some crufty information from sections like limitations. It's looking good. The tutorial part is especially useful for beginners. One comment about highlighted, it might be nice to have a highlighted style where the new keywords (cdef, cimport, ...) stand out. People often find this useful. > Short run plans: > > * Finish the Tutorial, relying heavily on Robert's scipy08 talk. > * Finish the setup.py examples > * Find all old Pyrex'y information and remove it. > * Document that range(n) expansion is the default. > > As always tell me what you think. While it's good to clean up the inconsistent (and sometimes confusing) use of the name Pyrex vs. Cython, I feel strongly that we need to credit Pyrex and all that Greg Ewing did (and maybe a bit about our relationship with that project), preferably right there on the first page in the overview. - Robert _______________________________________________ Cython-dev mailing list [email protected] http://codespeak.net/mailman/listinfo/cython-dev
