#10620: Upgrade Sphinx to version 1.1.2
---------------------------+------------------------------------------------
   Reporter:  davidm       |          Owner:  mvngu                      
       Type:  enhancement  |         Status:  needs_review               
   Priority:  minor        |      Milestone:  sage-4.8                   
  Component:  packages     |       Keywords:  sphinx upgrade spkg autodoc
Work_issues:               |       Upstream:  N/A                        
   Reviewer:               |         Author:  John Palmieri              
     Merged:               |   Dependencies:                             
---------------------------+------------------------------------------------
Changes (by jhpalmieri):

  * status:  needs_work => needs_review


Old description:

> Just made a spkg and a change to sage_autodoc in order to upgrade sphinx
> to the latest version. Spkg and patch attached.
>
> -------
>
> New spkg:
>
>  -
> [http://sage.math.washington.edu/home/palmieri/SPKG/sphinx-1.1.2.p0.spkg]

New description:

 Just made a spkg and a change to sage_autodoc in order to upgrade sphinx
 to the latest version. Spkg and patch attached.

 -------

 New spkg:

  -
 [http://sage.math.washington.edu/home/palmieri/SPKG/sphinx-1.1.2.p0.spkg]

 Apply

  - [attachment:trac_10620-scripts-hgignore.patch] to the scripts repo
  - [attachment:trac_10620-sageinspect.patch] to the main Sage library
  - [attachment:trac_10620-sagenb-sageinspect.patch] to the sagenb repo

--

Comment:

 I think this is okay now.  It's a little more complicated than I thought.
 First, Sage does use autodoc, in the 'sphinxify' routine when doing
 introspection.  So I restored the autodoc patch.  Second, with the new
 spkg, I was getting doctest failures: one piece of output in
 sageinspect.py was wrong.  I think that the new output is actually better:
 it's processing a docstring using sphinxify and coming up with nicer
 output.  So I think it's okay to change the output for the doctest.

 So there are three or four patches, one for the scripts repo (hgignore),
 one for the Sage library (doctest), and one for the Sphinx spkg.  The
 patch for the Sage library should come with a corresponding patch for
 sagenb, but I don't know what to do about that.  Submit a ticket for the
 flask notebook?  I'll include one for the current sagenb repo, in case
 that's the right thing to do.

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