Thanks! However....
I have the sage programming manual on my desk (March 6, 2007) and there is no mention of a TESTS section. The official sections are (description: anonymous) INPUT OUTPUT EXAMPLES NOTES AUTHORS See p6. If a TESTS section exists then it should probably be mentionned in this manual. Michel On Jun 2, 3:02 pm, Martin Albrecht <[EMAIL PROTECTED]> wrote: > On Saturday 02 June 2007 14:59, David Harvey wrote: > > > > > On Jun 2, 2007, at 8:44 AM, Michel wrote: > > > There is something I have not fully understood yet. > > > If I understand correctly doctests appears in the documentation as > > > "examples". > > > Now many doctests deal with obscure borderline cases (as regression > > > tests) so they are uninteresting as examples. Is there a way to hide > > > such doctests from the documentation? > > > I've wondered about this issue before. One solution is to simply put > > the extra doctests somewhere else "out of the way". They could live > > in global scope in the same file, or perhaps even in a different > > file. The most important thing is that they get run when "sage -t" is > > run. (Ideally the function documentation should give a pointer to > > them as well.) > > > But as far as I know we don't have a standardised approach for this. > > It would be good if we did. As SAGE matures I hope the doctest > > coverage gets *much* more systematic and complete, especially with > > regard to border cases, and as you point out, we might not always > > want this cluttering the examples section. > > > david > > There is a TESTS section which is supposed to address this issue. It is hidden > from the user (if not its a bug) and run by sage -t. > > TESTS: > sage: 1 + 1 > 2 > > Martin > -- > name: Martin Albrecht > _pgp:http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x8EF0DC99 > _www:http://www.informatik.uni-bremen.de/~malb > _jab: [EMAIL PROTECTED] --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@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-devel URLs: http://sage.scipy.org/sage/ and http://modular.math.washington.edu/sage/ -~----------~----~----~----~------~----~------~--~---
