#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.