[petsc-dev] Docs do not build for me

[Matthew Knepley]

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/>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20221023/82720c80/attachment.html>