#11115: Rewrite cached_method in Cython
-------------------------------------------------------------------+--------
Reporter: SimonKing |
Owner: jason
Type: enhancement |
Status: needs_work
Priority: major |
Milestone: sage-pending
Component: misc |
Keywords: category cython cache
Work_issues: docbuild |
Upstream: N/A
Reviewer: Nicolas M. Thiéry, Andrey Novoseltsev, Volker Braun |
Author: Simon King
Merged: |
Dependencies: #9976 #11298 #11342 #9138 #11815
-------------------------------------------------------------------+--------
Comment(by SimonKing):
The doc for the reference manual is obtained by
`_sage_getdoc_unformatted`. The difference in the output with or without
my patch is that the docstring contains embedding information with my
patch. That is important for introspection - otherwise, one has
{{{
sage: sage_getfile(Q.modp_splitting_data)
'/mnt/local/king/SAGE/rebase/sage-4.7.2.alpha3/local/lib/python2.6/site-
packages/sage/misc/cachefunc.py'
}}}
Having the embedding information (such as `'File:
sage/algebras/quatalg/quaternion_algebra.py (starting at line 859)'`) is a
very usual thing. If I am not mistaken, it occurs for any extension class.
So, I am very surprised to see that this is a problem.
Actually, it seems that the first line of the doc string is systematically
suppressed for cached methods - the same happens for `groebner_basis()`
and other cached methods.
So, that looks to me like a bug in pre-processing the doc strings for
building the references.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11115#comment:150>
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.
