The new doctesting framework allows doctests with continuation to be written like

sage:
....:
....:

instead of the old

sage:
...
...

The new syntax is much better because it has correct alignment and it would allow expected output to start with ... if we disallow the old syntax. It is also the syntax that one sees in the IPython command line.

The problem is that people will keep adding doctests in the old style. So I am thinking about ways to help the transition of ... to ....:

The following is an idea I am inclined to try:

Automatically replace replace ... to ....: in newly added/changed doctests? This can be done with some sed magic when merging the patch. And moreover, it could even be done in a way to avoid merge conflicts (if patch A adds a ... doctest and patch B changes that ... doctest, I can handle that). The main disadvantage here is that patches on Trac will not match the actually merged patches. I am even thinking about having 2 branches in the Mercurial repository, one with the patches as on Trac and one with the doctests changed (the latter one being the "official" master branch).


Any ideas?
Jeroen.

--
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to