#8533: browse thematic tutorials from command line and within notebook
-------------------------------+--------------------------------------------
Reporter: mvngu | Owner: mvngu
Type: enhancement | Status: positive_review
Priority: major | Milestone: sage-4.5
Component: documentation | Keywords:
Author: Minh Van Nguyen | Upstream: N/A
Reviewer: John Palmieri | Merged:
Work_issues: |
-------------------------------+--------------------------------------------
Changes (by jhpalmieri):
* status: needs_review => positive_review
* reviewer: => John Palmieri
Comment:
In addition to #8442, does this also depend on #8465 and #8469? Without
those, commands like {{{browse_sage_doc.funcprogramming_tutorial}}}
(available via tab completion) don't work and give a message
{{{
OSError: The document 'thematic_tutorials/functional_programming' does not
exist. Please build it
with 'sage -docbuild thematic_tutorials/functional_programming html
--jsmath' and try again.
}}}
which is misleading, since that command won't succeed.
I have no idea if there is any good way to doctest functions like
{{{
def faq(self):
"""
The Sage FAQ. A collection of frequently asked questions, together
with answers to those questions.
"""
self._open("faq")
}}}
It would be nice to not lower our coverage by including functions like
this. Here's an idea: replace the function by
{{{
faq = lambda self: self._open('faq')
}}}
Or is that cheating? This belongs on another ticket, in any case.
Given my understanding of the dependencies, this gets a positive review.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/8533#comment:5>
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.
