#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):
Overall, it's looking good. I have a few more comments and questions.
Replying to [comment:5 mvngu]:
> I don't know how to reproduce that error.
Try using a version of Sage for which you have all the necessary
permissions, and doctest a file outside of the Sage library by specifying
a path name including slashes:
{{{
[mv...@sage sage-4.1.1]$ ./sage -t ../testing/junk.py
}}}
or
{{{
[mv...@sage sage-4.1.1]$ ./sage -t [path to
sage-4.0]/devel/sage/sage/algebras/steenrod_algebra.py
}}}
Does that give you an error?
Maybe my point is that "sage -t" is inconsistent: it can accept a filename
within the current directory, or it can accept a pathname if that path
points to a location within the Sage library (can it accept any such
path?), but it won't accept a path which includes directories pointing
outside of the Sage library. This throws me off all the time, and I don't
think I even knew the pattern until writing this. I'm not even sure that
I have it right. Since inconsistencies are confusing, perhaps this could
be mentioned, or the allowable file- and/or path-name arguments to {{{sage
-t}}} described.
Along these lines, do you want cross-references between this new chapter
and the section on "Automated Testing" in conventions.rst?
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6908#comment:6>
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
-~----------~----~----~----~------~----~------~--~---
