#17847: Cython: embed signatures in docstrings
-------------------------------------+-------------------------------------
Reporter: jdemeyer | Owner:
Type: enhancement | Status: new
Priority: major | Milestone: sage-6.6
Component: cython | Resolution:
Keywords: | Merged in:
Authors: Jeroen Demeyer | Reviewers:
Report Upstream: Fixed upstream, | Work issues:
but not in a stable release. | Commit:
Branch: | 1a36cc96d1e9ebd5d46a3dd9c027a41e89da2ebc
u/jdemeyer/ticket/17847 | Stopgaps:
Dependencies: |
-------------------------------------+-------------------------------------
Comment (by SimonKing):
Meanwhile I became aware that the it was in your commits that
`_sage_getdoc_unformatted` was changed to actively search for docstrings
with embedding information. I am preparing a commit that reverts it.
I really think the job of `_sage_getdoc_unformatted(obj)` is to get the
docstring of `obj` without formatting. The user of
`_sage_getdoc_unformatted` has to decide for him or herself whether
`obj.__init__.__doc__` would be more useful than `obj.__doc__`.
Something else: Do I see that correctly that you did not change
`sage_getargspec` to using the new embedded information on the argspec? Or
is Python's `inspect.getargspec` using that information, so that we will
benefit from it implicitly?
--
Ticket URL: <http://trac.sagemath.org/ticket/17847#comment:32>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.
