#7477: Matroids
----------------------------------------------------+-----------------------
       Reporter:  ncohen                            |         Owner:  jkantor   
  
           Type:  enhancement                       |        Status:  
needs_review
       Priority:  major                             |     Milestone:  sage-5.10 
  
      Component:  combinatorics                     |    Resolution:            
  
       Keywords:                                    |   Work issues:            
  
Report Upstream:  N/A                               |     Reviewers:            
  
        Authors:  Stefan van Zwam, Rudi Pendavingh  |     Merged in:            
  
   Dependencies:                                    |      Stopgaps:            
  
----------------------------------------------------+-----------------------

Comment (by rbeezer):

 Some errors with building the HTML documentation follow.  I think this is
 from using intersphinx, but am not certain.  Perhaps also related to the
 `conf.py` files.  I'll ping John Palmieri off-list to see if he wants to
 take a look.  On 5.10.beta2, but very similar behaviour on 5.10.beta4.

 Two files in `devel/sage/doc/en/reference`:  `conf.py` and `conf_sub.py`.
 The first has a long list of top-level sections of the documentation.  But
 to my eye it seems we use the second and not the first (and setup patch
 here also seems to reference the second).

 I added {{{'matroids'}}} to the first and tried rebuilding (two passes).
 Then tried rebuilding with

 {{{sage -docbuild reference html -S -aE}}}

 which my notes say will for a rebuild from scratch.

 Here are the symptoms I'm trying to fix.  Many many of these, and indeed
 the `objects.inv` is not created for the matroids section.

 {{{
 [homology ] WARNING: intersphinx inventory
 
'/sage/sage-5.10.beta2/devel/sage/doc/output/html/en/reference/matroids/objects.inv'
 not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file
 or directory:
 
'/sage/sage-5.10.beta2/devel/sage/doc/output/html/en/reference/matroids/objects.inv'
 }}}

 I get about seven of these.  Perhaps it is due to cdef'ed class
 definitions.  That is a guess.  However, limited Googling suggests this
 can be fixed with a proper `conf.py`, so maybe another symptom of the same
 problem.  For each file/module, it seem severe enough to keep the whole
 module's worth of documentation from rendering at all - there is just a
 title, and no real content.

 {{{
 [reference]
 
/sage/sage-5.10.beta2/devel/sage/doc/en/reference/matroids/sage/matroids/basis_exchange_matroid.rst:11:
 WARNING: autodoc can't import/find module
 'sage.matroids.basis_exchange_matroid', it reported error: "'module'
 object has no attribute 'BasisExchangeMatroid'", please check your
 spelling and sys.path
 }}}

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/7477#comment:32>
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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to