#9976: Decorated functions/methods have generic signature in documentation
-----------------------------------------------------+----------------------
   Reporter:  jsrn                                   |       Owner:  jsrn       
                             
       Type:  enhancement                            |      Status:  needs_work 
                             
   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:  Cosmetical changes, indirect doctests  |  
-----------------------------------------------------+----------------------

Comment(by SimonKing):

 Replying to [comment:118 jsrn]:
 > I still seem to get some warnings when compiling the documentation; as
 before, they do not seem to be because of either of our patches. I
 couldn't figure out what was wrong with the first (not a very helpful
 error message). These are the warnings I get:

 Concerning two of the warnings:

 > /home/jsrn/sage-dev/local/lib/python2.6/site-
 packages/sage/categories/category_types.py:docstring of
 sage.categories.category_types:2: (ERROR/3) Unexpected indentation.

 See
 
[http://sagemath.org/doc/reference/sage/categories/category_types.html#sage.categories.category_types.ChainComplexes
 here] for a broken doc string in that module.

 > /home/jsrn/sage-dev/local/lib/python2.6/site-
 packages/sage/combinat/sf/jack.py:docstring of
 sage.combinat.sf.jack.ZonalPolynomials:3: (WARNING/2) Literal block
 expected; none found.

 See
 
[http://sagemath.org/doc/reference/sage/combinat/sf/jack.html#sage.combinat.sf.jack.JackPolynomials_p.scalar_jack_basis
 here] for some broken doc string in that module.

 So, it could really be that it has nothing to do with our patches.

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