#17847: Cython: embed signatures in docstrings of Sage library code
-------------------------------------+-------------------------------------
Reporter: jdemeyer | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.6
Component: cython | Resolution:
Keywords: | Merged in:
Authors: Jeroen Demeyer, | Reviewers: Simon King, Jeroen
Simon King | Demeyer
Report Upstream: Fixed upstream, | Work issues:
but not in a stable release. | Commit:
Branch: | 23390a1d85791bfe3a6f12ef667cf27d7bbf69a2
u/jdemeyer/ticket/17847 | Stopgaps:
Dependencies: |
-------------------------------------+-------------------------------------
Comment (by jdemeyer):
Replying to [comment:89 SimonKing]:
> Replying to [comment:84 jdemeyer]:
> > I'm diffing the old and new HTML manual, and things look good. The
newer manual seems to omit docstrings, but that's just because you're no
longer displaying the `__init__` methods of base classes.
>
> Do we want to keep these?
No, I think the output is good. I was commenting. There are annoying cases
where both the class and `__init__` have non-trivial docstrings, that
really should be discouraged.
--
Ticket URL: <http://trac.sagemath.org/ticket/17847#comment:90>
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.
