#6908: [with patch, needs review] programmers' guide --- doctesting and parallel
doctesting
---------------------------+------------------------------------------------
Reporter: mvngu | Owner: tba
Type: enhancement | Status: new
Priority: major | Milestone: sage-4.1.2
Component: documentation | Keywords:
Reviewer: | Author: Minh Van Nguyen
Merged: |
---------------------------+------------------------------------------------
Comment(by jhpalmieri):
line 93:
{{{
[mv...@mod sage-4.1.1]$ sage devel/sage-main/sage/games/sudoku.py
}}}
is missing "-t". I don't understand this example, though. If I do
{{{./sage -t devel/sage/sage/games/sudoku.py}}}, it works. If I use the
system version instead -- {{{sage -t devel/...}}} -- I get
{{{
(sage-4.1.2.alpha1-64bit) [10:48]$ sage -t devel/sage/sage/games/sudoku.py
sage -t "builds/sage-4.1.2.alpha1-64bit/devel/sage/sage/games/sudoku.py"
File "./sudoku.py", line 18
from devel/sage/sage/games/sudoku import *
^
SyntaxError: invalid syntax
[1.0 s]
}}}
If you can reproduce this error, perhaps it should be included also? (By
the way, the only way I've found to doctest a .py file (for example) in a
different build of Sage, or completely outside the Sage library, is to cd
to the actual directory containing the file and then running {{{sage -t
sudoku.py}}}.)
Lines 134-135 have a line break which shouldn't be there.
At the end, is it worth giving brief descriptions of what these do?
{{{
make test
make check
make testlong
make ptest
make ptestlong
}}}
Or do you think it's clear enough without that?
Other than that, I think it looks pretty good.
Regarding kcrisman's comment about doctesting, this file doesn't contain
anything which gets doctested: run "sage -t -verbose -long" on it.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6908#comment:3>
Sage <http://sagemath.org/>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en
-~----------~----~----~----~------~----~------~--~---
