Bug 2221956

Summary:	raft fails to build with Sphinx 7.x
Product:	[Fedora] Fedora	Reporter:	Karolina Surma <ksurma>
Component:	raft	Assignee:	Reto Gantenbein <reto.gantenbein>
Status:	CLOSED WORKSFORME	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	39	CC:	reto.gantenbein
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:	2024-03-08 11:42:37 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:	2188968

Description Karolina Surma 2023-07-11 11:52:31 UTC

raft fails to build with Sphinx 7.x in Fedora 39 (currently Rawhide).

The issue detected:
```
+ /usr/bin/python3 setup.py build_sphinx -b html

usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
or: setup.py --help [cmd1 cmd2 ...]
or: setup.py --help-commands
or: setup.py cmd --help

error: invalid command 'build_sphinx'
```

Sphinx 7 has removed the setuptools integration (see: https://github.com/sphinx-doc/sphinx/pull/11363).
`setup.py` has been long deprecated and projects are encouraged to migrate away from using it.


For the logs from testing build attempts, see:
https://copr.fedorainfracloud.org/coprs/ksurma/doc-stack/package/raft/

You can test you package in mock running:

$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/doc-stack/fedora-rawhide-x86_64/ --no-clean your.src.rpm
$ mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/doc-stack/fedora-rawhide-x86_64/ shell

We'd like to include Sphinx 7 in Fedora 39.
Let us know here if you have any questions. Thank you!

Comment 1 Fedora Release Engineering 2023-08-16 07:18:56 UTC

This bug appears to have been reported against 'rawhide' during the Fedora Linux 39 development cycle.
Changing version to 39.

Comment 2 Reto Gantenbein 2024-03-08 11:41:43 UTC

I can't seem to reproduce this. raft builds fine against Sphinx 7.x in Fedora 39 and higher. See https://koji.fedoraproject.org/koji/packageinfo?packageID=34666