On Oct 5, 10:08 am, Robert Bradshaw <rober...@math.washington.edu> wrote: > > Why are we using double-colons to pick up doctests at all, shouldn't > we just search for lines starting with "sage:" double-colons are just > for ReST (where I think they're highly redundant as well).
This whole discussion only applies to doctests in ReST files. Double colons are used to set off code blocks, and we restrict doctests to these code blocks. Or rather, we extract these code blocks to produce a python file, and then doctest that. That's my understanding, anyway. As William says, we also want those code blocks formatted and highlighted in the html and pdf documentation. In the old pre-Sphinx docs, we used to have verbatim blocks, and we turned those into the python file instead. This is the descendant of that idea. John --~--~---------~--~----~------------~-------~--~----~ To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
