Bug 2105931
| Summary: | kea fails to build docs with Sphinx 5+ | ||
|---|---|---|---|
| Product: | [Fedora] Fedora | Reporter: | Karolina Surma <ksurma> |
| Component: | kea | Assignee: | Martin Osvald 🛹 <mosvald> |
| Status: | CLOSED RAWHIDE | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | rawhide | CC: | fjanus, mosvald, tony, zdohnal |
| Target Milestone: | --- | ||
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | If docs needed, set a value | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2022-07-21 11:28:17 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | |||
| Bug Blocks: | 2082944 | ||
|
Description
Karolina Surma
2022-07-11 08:43:06 UTC
Hi Karolina, Thank you for the great reproducer and link to the patch! I tried to backport the commit you mentioned and test it, but it appears the mock doesn't follow the `--no-clean` option and the BUILD directory is empty for me. Maybe I am doing something wrong? ~~~ $ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5/fedora-rawhide-x86_64/ --no-clean kea-2.0.2-1.fc37.src.rpm ... $ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5/fedora-rawhide-x86_64/ shell ... <mock-chroot> sh-5.1# /usr/bin/sphinx-build -M html . ./_build -v -E -a -W -j 2 -c "/builddir/build/BUILD/kea-2.0.2/doc/sphinx" Running Sphinx v5.0.2 Traceback (most recent call last): File "/usr/lib/python3.11/site-packages/sphinx/cmd/build.py", line 272, in build_main app = Sphinx(args.sourcedir, args.confdir, args.outputdir, ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/lib/python3.11/site-packages/sphinx/application.py", line 202, in __init__ self.config = Config.read(self.confdir, confoverrides or {}, self.tags) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/lib/python3.11/site-packages/sphinx/config.py", line 163, in read raise ConfigError(__("config directory doesn't contain a conf.py file (%s)") % sphinx.errors.ConfigError: config directory doesn't contain a conf.py file (/builddir/build/BUILD/kea-2.0.2/doc/sphinx) Configuration error: config directory doesn't contain a conf.py file (/builddir/build/BUILD/kea-2.0.2/doc/sphinx) <mock-chroot> sh-5.1# ls /builddir/build/BUILD/kea-2.0.2/doc/sphinx ls: cannot access '/builddir/build/BUILD/kea-2.0.2/doc/sphinx': No such file or directory <mock-chroot> sh-5.1# ~~~ Anyway, I made a scratch build with the included patch so please, could you test it by yourself and report whether it fixes the issue? https://koji.fedoraproject.org/koji/taskinfo?taskID=89781004 If it works, I will release a new version including the commit. Thanks! Hi, I built kea-2.0.2-2 from the SRPM from your Koji scratch build in Copr: https://copr.fedorainfracloud.org/coprs/ksurma/sphinx-5/build/4655827/ and my local mock to both successes. I can see the built documentation in the resulting RPM. The issue is fixed. Also, please note that current Rawhide's kea is on release 3 after a few mass rebuild bumps, so you'd need to bump the release at least to 4. Regarding the reproducer, I ran the exact same steps as you in the mock: <mock-chroot> sh-5.1# /usr/bin/sphinx-build -M html . ./_build -v -E -a -W -j 2 -c "/builddir/build/BUILD/kea-2.0.2/doc/sphinx" Which resulted in the same error I started the ticket with. So I'm afraid I don't have any "proper" ideas to sell here, except for - maybe scrubbing the mock before the build would work? $ mock -r fedora-rawhide-x86_64 --scrub=all Thank you for the confirmation the backported patch fixed the issue and also for warning me about the mass rebuild! I will try to play with the repro out of curiosity for a while to see where might be a problem. Fixed in rawhide: https://bodhi.fedoraproject.org/updates/FEDORA-2022-52c16c875d |