#10200: Catch Sphinx WARNING or ERROR
-------------------------------+--------------------------------------------
   Reporter:  jdemeyer         |       Owner:  GeorgSWeber               
       Type:  defect           |      Status:  needs_work                
   Priority:  major            |   Milestone:  sage-4.6.1                
  Component:  build            |    Keywords:  sphinx build documentation
     Author:  Jeroen Demeyer   |    Upstream:  N/A                       
   Reviewer:  Minh Van Nguyen  |      Merged:                            
Work_issues:                   |  
-------------------------------+--------------------------------------------
Changes (by jdemeyer):

  * status:  positive_review => needs_work


Comment:

 There is another issue with this patch:

 {{{sage/misc/sagedoc.py}}} (very stupidly) reads the first 1000 bytes of
 {{{doc/common/builder.py}}} and searches for this part:
 {{{
 SAGE_DOC = os.environ['SAGE_DOC']
 LANGUAGES = ['en', 'fr']
 SPHINXOPTS  = ""
 PAPER       = ""
 OMIT        = ["introspect"]  # docs/dirs to omit when listing and
 building 'all'
 }}}
 In particular, it needs the "LANGUAGES" and "OMIT" variables.

 By adding my patch, these options are no longer in the first 1000 bytes.
 I believe we should use some Pythonic mechanism ({{{import}}} doesn't seem
 to work since this file is in {{{doc/}}}, not {{{sage/}}}) to read these
 options instead of essentially grepping stuff from {{{builder.py}}}.  Any
 ideas...?

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