#10118: upgrade sphinx to version 1.0.4
-------------------------------+--------------------------------------------
   Reporter:  mvngu            |       Owner:  tbd         
       Type:  enhancement      |      Status:  needs_review
   Priority:  major            |   Milestone:  sage-4.6.1  
  Component:  packages         |    Keywords:              
     Author:  Minh Van Nguyen  |    Upstream:  N/A         
   Reviewer:                   |      Merged:              
Work_issues:                   |  
-------------------------------+--------------------------------------------
Changes (by newvalueoldvalue):

 * cc: sage-combinat (added)
  * status:  new => needs_review
  * author:  => Minh Van Nguyen


Old description:

> As the subject says. See this [http://groups.google.com/group/sage-
> devel/browse_thread/thread/8bad71b8a6a8382e sage-devel] thread for some
> background on why we need to upgrade [http://sphinx.pocoo.org/ Sphinx].

New description:

 As the subject says. See this [http://groups.google.com/group/sage-
 devel/browse_thread/thread/8bad71b8a6a8382e sage-devel] thread for some
 background on why we need to upgrade [http://sphinx.pocoo.org/ Sphinx].

 '''Apply:'''

  1. Prerequisite: #9850.
  1. The upgraded Sphinx package at
 
http://sage.math.washington.edu/home/mvngu/spkg/standard/sphinx/sphinx-1.0.4.p0.spkg.
 For reference, my patch for that spkg is [attachment:trac-10118_sphinx-
 spkg.patch], but do not apply that patch; it's already applied to the
 upgraded spkg.
  1. Apply [attachment:trac-10118_sage-lib.patch] to the Sage library.
  1. Apply [attachment:trac-10118_sagenb.patch] to the Sage notebook
 library.

--

Comment:

 See the ticket description for instructions on which patch/spkg to apply.
 Here are the results of my testing.

  * bsd.math -- Both the HTML and PDF versions of the documentation built
 OK.

  * cicero.skynet -- The HTML version of the documentation built OK, with
 numerous warnings regarding a missing LaTeX installation. This also meant
 that I can't build the PDF version of the documentation.

  * cleo.skynet -- Sage 4.6.1.alpha0 fails to build on this machine, hence
 can't test building the documentation.

  * eno.skynet -- The HTML version of the documentation built OK, with
 numerous warnings regarding a missing LaTeX installation. This also meant
 that I can't build the PDF version of the documentation.

  * flavius.skynet -- The PDF version of the documentation built fine. The
 HTML version built with numerous warnings due to missing the dvipng
 command.

  * gcc11 -- The HTML documentation built OK, with some warnings due to an
 incomplete LaTeX installation. Can't build the PDF version of the
 documentation due to this reason.

  * gcc16 -- The HTML documentation built OK, with some warnings due to an
 incomplete LaTeX installation. Can't build the PDF version of the
 documentation due to this reason.

  * hawk (David Kirkby's !OpenSolaris box) -- Both the PDF and HTML
 versions of the documentation built fine.

  * iras.skynet -- Sage 4.6.1.alpha0 fails to build on this machine, hence
 can't test building the documentation.

  * lena.skynet -- The HTML version of the documentation built OK, with
 numerous warnings about a missing LaTeX installation, hence cannot parse
 math expressions typeset using LaTeX. The missing LaTeX installation also
 prevents us from building the PDF version of the documentation.

  * rh.math -- Has a LaTeX installation, but missing utf8x.def, hence
 unable to successfully build the PDF version of the documentation. The
 HTML version of the documentation built with numerous warnings due to
 missing utf8x.def.

  * rosemary.math -- Sage 4.6.1.alpha0 fails to build on this machine,
 hence can't test building the standard documentation.

  * sage.math -- Both the HTML and PDF versions of the documentation built
 fine.

  * sextus.skynet -- The HTML version of the documentation built OK, with
 numerous warnings about a missing LaTeX installation, hence cannot parse
 math expressions typeset using LaTeX. The missing LaTeX installation also
 prevents us from building the PDF version of the documentation.

  * taurus.skynet -- The HTML documentation built fine. This machine
 doesn't have a LaTeX installation, so I can't build the PDF version of the
 documentation.

 What the above tests mean is that the HTML documentation can be built
 without a LaTeX installation, but the resulting documentation would not
 render LaTeX typeset math expressions. For best result, you should install
 a LaTeX distribution on your system before building the Sage
 documentation. Of course, when you compile Sage, the configure script that
 is first run does warn about having a LaTeX installation if your system
 doesn't already have a LaTeX installation.
 [[BR]]

 I'm CC'ing the sage-combinat team because [attachment:trac-10118_sage-
 lib.patch] touches files in the combinatorics module.

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