Generated conf.py files in release tarball incompatible with Sphinx 8.x

[jwakely]

Summary

The doc/GSG/conf.py and doc/main/conf.py files in the release tarball https://github.com/uxlfoundation/oneTBB/archive/refs/tags/v2022.0.0.tar.gz have the following line:

intersphinx_mapping = {'https://docs.python.org/': None}

Version

2022.0.0

Environment

Fedora Linux rawhide, with Sphinx 8.1.3

Observed Behavior

The documentation produces a build error:
https://bugzilla.redhat.com/show_bug.cgi?id=2329903

Expected Behavior

Builds OK.

I would send a pull request to change it, but those files seem to be generated and I'm not sure how that's done.

For more information, see https://bugzilla.redhat.com/show_bug.cgi?id=2329903 and for a similar fix in another project see jupyterlab/jupyterlab#14423

[phprus]

Fixed in master by #1480

[omalyshe]

@jwakely This was fixed in the release branch as well - https://github.com/uxlfoundation/oneTBB/blob/onetbb_2022/doc/conf.py#L301
For me the archive at the tag https://github.com/uxlfoundation/oneTBB/archive/refs/tags/v2022.0.0.tar.gz . Please check again.

[jwakely]

The v2022.0.0.tar.gz archive has it fixed in doc/conf.py but not in the two generated files doc/GSG/conf.py and doc/main/conf.py:

tmp$ mkdir tbb
tmp$ cd tbb
tbb$ wget https://github.com/uxlfoundation/oneTBB/archive/refs/tags/v2022.0.0.tar.gz
v2022.0.0.tar.gz     100% [=========================================================================================================>]    2.53M   32.65MB/s
                          [Files: 1  Bytes: 2.53M [3.71MB/s] Redirects: 1  Todo: 0  Errors: 0                                        ]
tbb$ tar xf v2022.0.0.tar.gz 
tbb$ grep -R  intersphinx_mapping oneTBB-2022.0.0/
oneTBB-2022.0.0/doc/GSG/conf.py:intersphinx_mapping = {'https://docs.python.org/': None}
oneTBB-2022.0.0/doc/conf.py:intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}
oneTBB-2022.0.0/doc/main/conf.py:intersphinx_mapping = {'https://docs.python.org/': None}

[jwakely]

Ah, maybe they're not generated, they just don't exist on the master branch. But they're still wrong on the release branch:

oneTBB/doc/GSG/conf.py

Line 294 in 0c0ff19

intersphinx_mapping = {'https://docs.python.org/': None}

oneTBB/doc/main/conf.py

Line 290 in 0c0ff19

intersphinx_mapping = {'https://docs.python.org/': None}

[omalyshe]

@jwakely Oh, now I see what you mean. Thank you. Will take a look.

[omalyshe]

@jwakely Oh, now I see what you mean. Thank you. Will take a look.

@jwakely Those files and some others were not supposed to be in the package. It is fixed in the branch and will be fixed in the next release package. Thanks again for reporting it!

[jwakely]

Great, thanks!