Sphinx cannot see any of the TOC entries for the API: (petsc-doc-env) knepley/feature-ephemeral-label *$:/PETSc3/petsc/petsc-dev/doc$ make html SPHINXOPTS="-T -E -W -j 1" Running Sphinx v4.5.0 Warning: A custom extension duplicates code from Sphinx (4, 2, 0, 'final', 0) which differs from the current version (4, 5, 0, 'final ', 0) so unexpected behavior may be observed. checking bibtex cache... out of date parsing bibtex file /PETSc3/petsc/petsc-dev/doc/petsc.bib... parsed 3762 entries
myst v0.18.1: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions=['dollarmath', 'amsmath', 'deflist'], disable_sy ntax=[], all_links_external=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, highlight_code_blocks=True, numbe r_code_blocks=[], title_to_header=False, heading_anchors=None, heading_slug_func=None, footnote_transition=True, words_per_minute=200, sub_delimiters=('{', '}'), linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_ double_inline=False, update_mathjax=True, mathjax_classes='tex2jax_process|mathjax_process|math|output_area') ================================================================== Performing a minimal PETSc (re-)configuration needed to build docs PETSC_DIR=/PETSc3/petsc/petsc-dev PETSC_ARCH=arch-classic-docs ================================================================== ============================================================================================= Configuring PETSc to compile on your system ============================================================================================= TESTING: configureArchitecture from PETSc.options.arch(config/PETSc/options/arch.py:42)Your configure options and state has not change d; no need to run configure However you can force a configure run using the option: --force xxx=========================================================================xxx Build PETSc libraries with: make PETSC_DIR=/PETSc3/petsc/petsc-dev PETSC_ARCH=arch-classic-docs all xxx=========================================================================xxx ============================================ Assuming that the classic docs in /PETSc3/petsc/petsc-dev/doc/_build_classic are current wrt stage "pre" To rebuild, manually run the following before re-making: rm -rf /PETSc3/petsc/petsc-dev/doc/_build_classic ============================================ ============================================ Copying classic docs (pre) ============================================ Copying directory /PETSc3/petsc/petsc-dev/doc/_build_classic/docs/manualpages to ./docs/manualpages ============================================ Updating htmlmap ============================================ building [mo]: targets for 0 po files that are out of date building [html]: targets for 133 source files that are out of date updating environment: [new config] 133 added, 0 changed, 0 removed reading sources... [100%] tutorials/physics/guide_to_stokes ============================================ Assuming that the classic docs in /PETSc3/petsc/petsc-dev/doc/_build_classic are current wrt stage "post" To rebuild, manually run the following before re-making: rm -rf /PETSc3/petsc/petsc-dev/doc/_build_classic ============================================ ========================================================================== open /PETSc3/petsc/petsc-dev/doc/_build/html/index.html in your browser to view the documentation ========================================================================== Traceback (most recent call last): File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/cmd/build.py", line 276, in build_main app.build(args.force_all, filenames) File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/application.py", line 330, in build self.builder.build_update() File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 286, in build_update self.build(to_build, File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 300, in build updated_docnames = set(self.read()) File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/contextlib.py", line 120, in __exit__ next(self.gen) File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/util/logging.py", line 217, in pending_warnings memhandler.flushTo(logger) File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/util/logging.py", line 182, in flushTo logger.handle(record) File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/logging/__init__.py", line 1587, in handle self.callHandlers(record) File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/logging/__init__.py", line 1649, in callHandlers hdlr.handle(record) File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/logging/__init__.py", line 946, in handle rv = self.filter(record) File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/logging/__init__.py", line 807, in filter result = f.filter(record) File "/PETSc3/petsc/petsc-dev/petsc-doc-env/lib/python3.8/site-packages/sphinx/util/logging.py", line 425, in filter raise exc sphinx.errors.SphinxWarning: /PETSc3/petsc/petsc-dev/doc/docs/manualpages/index.rst:21:toctree contains reference to nonexisting document 'docs/manualpages/AO/index.html' Warning, treated as error: /PETSc3/petsc/petsc-dev/doc/docs/manualpages/index.rst:21:toctree contains reference to nonexisting document 'docs/manualpages/AO/index.html' make: *** [html] Error 2 Thanks, Matt -- What most experimenters take for granted before they begin their experiments is infinitely more interesting than any results to which their experiments lead. -- Norbert Wiener https://www.cse.buffalo.edu/~knepley/ <http://www.cse.buffalo.edu/~knepley/>