#13147: Delay the evaluation of SAGE_TMP in order to facilitate forking in
doctesting
------------------------------------------+---------------------------------
Reporter: roed | Owner: mvngu
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-5.2
Component: doctest | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: David Roe, Mike Hansen | Merged in:
Dependencies: | Stopgaps:
------------------------------------------+---------------------------------
Comment (by roed):
Replying to [comment:35 jhpalmieri]:
> Keshav: I'm thinking that when I read the documentation, either for the
whole module or just for `_LazyString` or `lazy_string`, I should see
something less terse than "Creates a lazy string by invoking func with
args". Maybe just one more sentence like: "A typical usage might be ...".
Maybe another sentence like: "Sage uses this code in constructing the path
for the directory SAGE_TMP -- see sage.misc.misc."
>
> And this could either be in the documentation for `lazy_string` or in a
module-level docstring. I guess my point is this: I see the docstrings
here, and I still have to think for a bit and read the examples to
understand what this does and why you might want it. I'd rather not have
to think. I also don't know why this is in Sage at all; I certainly think
that there is some cruft in the Sage which should be removed, so I'd like
to know why this is here. Regarding the existing doctests, they don't
quite convince me why I would want to use this instead of just
constructing the strings when I need them.
Makes sense. I'm going to be out of communication for a few days but I
can add some more documentation when I get back. Keshav, if you want to
do it before then that would be cool too. ;-)
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13147#comment:37>
Sage <http://www.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.
