Bug 2132928

Summary:	bind's documentation doesn't build with Sphinx 5.2.3
Product:	[Fedora] Fedora	Reporter:	Karolina Surma <ksurma>
Component:	bind	Assignee:	Petr Menšík <pemensik>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	rawhide	CC:	aegorenkov.91, anon.amish, dns-sig, mruprich, pemensik, redhat, vonsch, zdohnal
Target Milestone:	---	Keywords:	Upstream
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	bind-9.18.8-1.fc38 bind-9.18.8-1.fc37	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-12-15 19:59:54 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:	2136100
Bug Blocks:

Description Karolina Surma 2022-10-07 08:17:47 UTC

Description of problem:
bind's documentation fails to build with Sphinx 5.2.3 which is being integrated into Fedora Rawhide.

Version-Release number of selected component (if applicable):
32:9.18.7-3 

How reproducible:
Always

Steps to Reproduce:
Mockbuild:

mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5.2.3/fedora-rawhide-x86_64/ --no-clean your.src.rpm

Explore the results:
mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5.2.3/fedora-rawhide-x86_64/  shell


Actual results:
+ make doc
Making doc in .
make[1]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build'
make[1]: Nothing to be done for 'doc-am'.
make[1]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build'
Making doc in lib
make[1]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib'
Making doc in isc
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isc'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isc'
Making doc in dns
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/dns'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/dns'
Making doc in isccc
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isccc'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isccc'
Making doc in ns
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/ns'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/ns'
Making doc in isccfg
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isccfg'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/isccfg'
Making doc in bind9
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/bind9'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/bind9'
Making doc in irs
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib/irs'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib/irs'
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/lib'
make[2]: Nothing to be done for 'doc-am'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib'
make[1]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/lib'
Making doc in doc
make[1]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/doc'
Making doc in .
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/doc'
make[2]: Nothing to be done for 'doc-am'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/doc'
Making doc in misc
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/doc/misc'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/doc/misc'
Making doc in man
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/doc/man'
make[2]: Nothing to be done for 'doc'.
make[2]: Leaving directory '/builddir/build/BUILD/bind-9.18.7/build/doc/man'
Making doc in arm
make[2]: Entering directory '/builddir/build/BUILD/bind-9.18.7/build/doc/arm'
  SPHINX   html-local

Warning, treated as error:
/builddir/build/BUILD/bind-9.18.7/doc/arm/catz.inc.rst:234:more than one target found for 'any' cross-reference 'allow-query': could be :std:ref:`allow-query` or :namedconf:ref:`namedconf-statement-allow-query`

Comment 1 Michał Kępień 2022-10-07 09:38:19 UTC

This issue will be fixed in BIND 9.19.6 and BIND 9.18.8 (due for
publication on 2022-10-19):

Upstream issue:

    https://gitlab.isc.org/isc-projects/bind9/-/issues/3572

Fixes:

      - BIND 9.19:
        https://gitlab.isc.org/isc-projects/bind9/-/merge_requests/6846

      - BIND 9.18:
        https://gitlab.isc.org/isc-projects/bind9/-/merge_requests/6861

Comment 2 Petr Menšík 2022-10-10 10:23:39 UTC

Excellent, thank you Michał. I guess we can wait few days for a fix by rebase.

Comment 3 Petr Menšík 2022-12-15 19:59:54 UTC

Fixed by rebase as part of bug #2136100.

Please reopen the bug if it still does not work.