#7683: sphinx reference manual documentation has a major issue: in some cases 
the
input parameters to functions are completely omitted causing great
confusion!
-----------------------------+----------------------------------------------
   Reporter:  was            |       Owner:  mvngu          
       Type:  defect         |      Status:  positive_review
   Priority:  critical       |   Milestone:  sage-4.3.1     
  Component:  documentation  |    Keywords:                 
Work_issues:                 |      Author:  Mike Hansen    
   Upstream:  N/A            |    Reviewer:  John Palmieri  
     Merged:                 |  
-----------------------------+----------------------------------------------
Changes (by jhpalmieri):

  * status:  needs_review => positive_review
  * reviewer:  => John Palmieri


Comment:

 It looks good to me, and I understand the general principle behind the
 patch, but not necessarily the details.  (For instance, and this has more
 to do with Sphinx than the patch, why is essentially the same code
 repeated four times?)

 The output seems to fix the complaint, too.  Is this worth reporting to
 the Sphinx people as a suggested addition to their code?

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