Skip to content

devhelp documentation doesn't build with sphinx 7.2.6 #120150

Description

@danigm

Documentation

Sphinx raises an exception when trying to build the Python 3.13 documentation:

$ cd Doc
$ sphinx-build -a -b devhelp . build/devhelp
...
dumping devhelp index...
 
Exception occurred:
File "/usr/lib/python3.11/site-packages/sphinx/environment/__init__.py", line 603, in get_doctree
    with open(filename, 'rb') as f:
         ^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: '/home/abuild/rpmbuild/BUILD/Python-3.13.0b2/Doc/build/devhelp/.doctrees/index.doctree'

This is due to the removal of master_doc = 'contents' in the conf.py file done in this PR: #117853

Environment:

  • os: openSUSE Tumbleweed
  • python version: Python 3.11.9
  • sphinx: sphinx-build 7.2.6
  • sphinxcontrib-devhelp: 1.0.6

Activity

  1. added
    docsDocumentation in the Doc dir
    on Jun 6, 2024
  2. hugovk commented on Jun 6, 2024

    @hugovk
    Member

    Thanks for the report.

    This is due to the removal of master_doc = 'contents' in the conf.py file done in this PR: #117853

    It was replaced with root_doc = 'contents', which was changed in Sphinx 4.0:

    This sounds like a bug with Sphinx or sphinxcontrib-devhelp, please could you report it to Sphinx?

  3. added
    pendingThe issue will be closed if no feedback is provided
    on Jun 6, 2024
  4. picnixz commented on Jun 6, 2024

    @picnixz
    Member

    Confirmed as a Sphinx issue (it's both a core Sphinx issue and a sphinxcontrib-devhelp issue)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dirpendingThe issue will be closed if no feedback is provided

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions