sagemath / sage

Main repository of SageMath
https://www.sagemath.org
Other
1.39k stars 473 forks source link

`sage -docbuild reference/combinat html` ends with error message #21611

Closed mantepse closed 7 years ago

mantepse commented 8 years ago

At least using SageMath version 7.4.beta6, issuing the above after make doc-clean ends with the following message. The html looks OK, except that the style files seem to be missing.

[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat:39: WARNING: undefined label: sage.coding (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat:40: WARNING: undefined label: sage.dynamics (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat:41: WARNING: undefined label: sage.graphs (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat.__init__:39: WARNING: undefined label: sage.coding (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat.__init__:40: WARNING: undefined label: sage.dynamics (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat.__init__:41: WARNING: undefined label: sage.graphs (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/algebraic_combinatorics.py:docstring of sage.combinat.algebraic_combinatorics:35: WARNING: undefined label: sage.algebras.catalog (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/algebraic_combinatorics.py:docstring of sage.combinat.algebraic_combinatorics:36: WARNING: undefined label: sage.groups.groups_catalog (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/src/doc/en/reference/combinat/sage/combinat/counting.rst:6: WARNING: undefined label: sage.databases.oeis (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/designs/database.py:docstring of sage.combinat.designs.database.HigmanSimsDesign:13: WARNING: citation not found: BvL84
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/designs/incidence_structures.py:docstring of sage.combinat.designs.incidence_structures.IncidenceStructure.is_generalized_quadrangle:21: WARNING: citation not found: PT09
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/designs/incidence_structures.py:docstring of sage.combinat.designs.incidence_structures.IncidenceStructure.is_generalized_quadrangle:21: WARNING: citation not found: GQwiki
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/designs/twographs.py:docstring of sage.combinat.designs.twographs.taylor_twograph:3: WARNING: citation not found: BvL84
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/enumerated_sets.py:docstring of sage.combinat.enumerated_sets:59: WARNING: undefined label: sage.groups.perm_gps.permutation_groups_catalog (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/enumerated_sets.py:docstring of sage.combinat.enumerated_sets:84: WARNING: undefined label: sage.groups.matrix_gps.catalog (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/hall_polynomial.py:docstring of sage.combinat.hall_polynomial.hall_polynomial:38: WARNING: citation not found: Schiffmann
[combinat ] docstring of sage.combinat.integer_lists.invlex.IntegerListsLex:8: WARNING: undefined label: integerlistslex_finiteness (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/matrices/hadamard_matrix.py:docstring of sage.combinat.matrices.hadamard_matrix.rshcd_from_close_prime_powers:3: WARNING: citation not found: GS70
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/posets/__init__.py:docstring of sage.combinat.posets.__init__:23: WARNING: undefined label: sage.categories.category (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/quickref.py:docstring of sage.combinat.quickref:65: WARNING: undefined label: sage.groups.groups_catalog (if the link has no caption the label must precede a section header)
[combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/quickref.py:docstring of sage.combinat.quickref:72: WARNING: undefined label: sage.graphs (if the link has no caption the label must precede a section header)
Error building the documentation.
Traceback (most recent call last):
  File "/home/martin/sage-master/local/lib/python/runpy.py", line 162, in _run_module_as_main
    "__main__", fname, loader, pkg_name)
  File "/home/martin/sage-master/local/lib/python/runpy.py", line 72, in _run_code
    exec code in run_globals
  File "/home/martin/sage-master/local/lib/python2.7/site-packages/sage_setup/docbuild/__main__.py", line 2, in <module>
    main()
  File "/home/martin/sage-master/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 1630, in main
    builder()
  File "/home/martin/sage-master/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 710, in _wrapper
    getattr(DocBuilder, build_type)(self, *args, **kwds)
  File "/home/martin/sage-master/local/lib/python2.7/site-packages/sage_setup/docbuild/__init__.py", line 103, in f
    runsphinx()
  File "/home/martin/sage-master/local/lib/python2.7/site-packages/sage_setup/docbuild/sphinxbuild.py", line 215, in runsphinx
    raise exception
OSError: [combinat ] /home/martin/sage-master/local/lib/python2.7/site-packages/sage/combinat/__init__.py:docstring of sage.combinat:39: WARNING: undefined label: sage.coding (if the link has no caption the label must precede a section header)

CC: @jdemeyer @embray @tscrim

Component: documentation

Reviewer: Travis Scrimshaw

Issue created by migration from https://trac.sagemath.org/ticket/21611

fchapoton commented 7 years ago
comment:1

Such partial build of the doc is not possible. You should first do make doc

tscrim commented 7 years ago

Reviewer: Travis Scrimshaw

tscrim commented 7 years ago
comment:2

I think you can run the inv (or was it inventory?) version of the doc first, but yes, it is basically impossible (for now) because it needs other info that a partial build doesn't provide.

embray commented 7 years ago
comment:3

Closing tickets in the sage-duplicate/invalid/wontfix module with positive_review (i.e. someone has confirmed they should be closed).