#9976: Decorated functions/methods have generic signature in documentation
--------------------------------+-------------------------------------------
   Reporter:  jsrn              |       Owner:  jsrn                            
        
       Type:  enhancement       |      Status:  needs_review                    
        
   Priority:  major             |   Milestone:  sage-4.7                        
        
  Component:  documentation     |    Keywords:  sphinx, documentation, cython 
inspection
     Author:  jsrn, Simon King  |    Upstream:  N/A                             
        
   Reviewer:  Simon King        |      Merged:                                  
        
Work_issues:                    |  
--------------------------------+-------------------------------------------
Changes (by SimonKing):

  * status:  needs_work => needs_review


Comment:

 The patch is updated. It is now always (recursively) using the `.func`
 attribute of a `functools.partial` instance. With that change, things
 should look nice.

 One idea concerning the warning: What one could do is modify
 `sage_getdoc`, so that it prepends a warning message to the doc string of
 any `functools.partial` instance. Then, the warning would both appear in
 the reference and in introspection via `?` (not via `??`, but I could be
 mistaken).

 But that's a different ticket.

 Needs review...

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9976#comment:163>
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.

Reply via email to