2132928 – bind's documentation doesn't build with Sphinx 5.2.3

Bug 2132928 - bind's documentation doesn't build with Sphinx 5.2.3

Summary: bind's documentation doesn't build with Sphinx 5.2.3

Keywords:
Status:	CLOSED CURRENTRELEASE
Alias:	None
Product:	Fedora
Classification:	Fedora
Component:	bind
Sub Component:
Version:	rawhide
Hardware:	Unspecified
OS:	Unspecified
Priority:	unspecified
Severity:	unspecified
Target Milestone:	---
Assignee:	Petr Menšík
QA Contact:	Fedora Extras Quality Assurance
Docs Contact:
URL:
Whiteboard:
Depends On:	2136100
Blocks:
TreeView+	depends on / blocked

Reported:	2022-10-07 08:17 UTC by Karolina Surma
Modified:	2022-12-15 19:59 UTC (History)
CC List:	8 users (show)
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:
Clone Of:
Environment:
Last Closed:	2022-12-15 19:59:54 UTC
Type:	Bug
Embargoed:
Dependent Products:

Attachments	(Terms of Use)

Links
System	ID	Private	Priority	Status	Summary	Last Updated
Internet Systems Consortium (ISC)	isc-projects bind9 issues 3572	0	None	closed	Sphinx 5.2 reports a warning for doc/arm/catz.inc.rst	2022-10-10 10:23:38 UTC
Internet Systems Consortium (ISC)	isc-projects bind9 merge_requests 6861	0	None	merged	Deduplicate link anchors in the ARM [v9_18]	2022-10-10 10:23:38 UTC

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.

Note You need to log in before you can comment on or make changes to this bug.