#12810: Broken links in the documentation of graph/ files
---------------------------------+------------------------------------------
       Reporter:  ncohen         |         Owner:  jason, ncohen, rlm
           Type:  defect         |        Status:  needs_work        
       Priority:  major          |     Milestone:  sage-5.0          
      Component:  graph theory   |    Resolution:                    
       Keywords:                 |   Work issues:                    
Report Upstream:  N/A            |     Reviewers:                    
        Authors:  Nathann Cohen  |     Merged in:                    
   Dependencies:                 |      Stopgaps:                    
---------------------------------+------------------------------------------
Changes (by davidloeffler):

  * status:  needs_review => needs_work


Comment:

 I still get a bunch of warnings when I install this and rebuild the docs:
 {{{
 masiao@fermat:/storage/masiao/sage-5.0.beta12/devel/sage-12810$ sage
 -docbuild --warn-links reference html
 sphinx-build -b html -d
 /storage/masiao/sage-5.0.beta12/devel/sage/doc/output/doctrees/en/reference
 -n  /storage/masiao/sage-5.0.beta12/devel/sage/doc/en/reference
 /storage/masiao/sage-5.0.beta12/devel/sage/doc/output/html/en/reference
 Running Sphinx v1.1.2
 loading pickled environment... done
 loading intersphinx inventory from
 /storage/masiao/sage-5.0.beta12/devel/sage/doc/common/python.inv...
 building [html]: targets for 9 source files that are out of date
 updating environment: 1 added, 9 changed, 0 removed
 reading sources... [100%] sage/graphs/trees
 docstring of sage.graphs.base.c_graph:12: WARNING: Bullet list ends
 without a blank line; unexpected unindent.
 looking for now-outdated files... none found
 pickling environment... done
 checking consistency... done
 preparing documents... done
 writing output... [100%] sage/graphs/trees
 <autodoc>:1: WARNING: py:class reference target not found:
 sage.graphs.base.graph_backends.GenericGraphBackend
 
/storage/masiao/sage-5.0.beta12/devel/sage/doc/en/reference/sage/graphs/generic_graph.rst:11:
 WARNING: py:class reference target not found:
 sage.graphs.generic_graph_pyx.GenericGraph_pyx
 /storage/masiao/sage-5.0.beta12/local/lib/python2.7/site-
 packages/sage/graphs/graph_latex.py:docstring of
 sage.graphs.graph_latex.GraphLatex.get_option:9: WARNING: py:data
 reference target not found: __graphlatex_options
 /storage/masiao/sage-5.0.beta12/local/lib/python2.7/site-
 packages/sage/graphs/graph_latex.py:docstring of
 sage.graphs.graph_latex.GraphLatex.latex:3: WARNING: py:meth reference
 target not found: sage.graphs.generic_graph.GenericGraph._latex_
 /storage/masiao/sage-5.0.beta12/local/lib/python2.7/site-
 packages/sage/graphs/graph_latex.py:docstring of
 sage.graphs.graph_latex.GraphLatex.set_option:11: WARNING: py:data
 reference target not found:
 sage.graphs.graph_latex.GraphLatex.__graphlatex_options
 writing additional files... genindex py-modindex search
 copying images... [100%] sage/graphs/../../media/heawood-graph-latex.png
 copying static files... done
 dumping search index... done
 dumping object inventory... done
 build succeeded, 6 warnings.
 Build finished.  The built documents can be found in
 /storage/masiao/sage-5.0.beta12/devel/sage/doc/output/html/en/reference
 }}}

 Five of these are "link not found" warnings that presumably weren't easily
 fixable, but one of them is a genuine formatting error which would have
 come up even without --warn-links, and we can't have that -- sorry!

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