fesco

#2094 F31 System-Wide Change: Update Sphinx to version 2 and drop Python 2 support from Sphinx
Closed: Accepted by zbyszek. Opened by bcotton.

Closed: Accepted
Reopen Issue

The version 2.0.x of Sphinx, popular Python documentation generator and framework, is expected to be released in early 2019. It drops support for Python 2. As part of Finalizing Fedora's Switch to Python 3, we update Package-x-generic-16.pngpython-sphinx to 2.0.x and we drop Package-x-generic-16.pngpython2-sphinx and related packages from Fedora 31 and further.

Package maintainers using Sphinx on Python 2 have three options:

  • they stop using Python 2 entirely (preferred), dropping their python2 subpackages if not dependent upon by other packages,
  • they switch to Sphinx on Python 3 for building their documentation,
  • they stop building documentation.

Packages that use Sphinx on Python 2 at runtime are Sphinx extensions, themes etc. and will be removed together with Package-x-generic-16.pngpython2-sphinx.

This one is going to be quite a bit of work...

$ for i in  python-sphinx python2-sphinx /usr/bin/sphinx-build /usr/bin/sphinx-build-2; do dnf repoquery --releasever=rawhide --disablerepo=\* --enablerepo=fedora-source --arch=src --whatrequires $i|wc -l; done
21
117
16
3

(I'm not quite sure about that query...)

Some of those packages are python2-only or will be dropped for other reasons (mongo...), but in the end it's ~150 packages to update.

+1 obviously, let's get this done and over with
Edited by zbyszek

+1

@zbyszek note that packages buildrequiring /usr/bin/sphinx-build should mostly be ok if they do it right (however sometimes they don't).

I'm +1 for the record.

+1: Python 2, I can't say we hardly knew ye.

+1

Metadata Update from @churchyard:
- Issue tagged with: pending announcement

APPROVED: after 10 days, it's (+5, 0, 0).

Announced.

Metadata Update from @zbyszek:
- Issue close_status updated to: Accepted
- Issue status updated to: Closed (was: Open)

Metadata Update from @zbyszek:
- Issue untagged with: pending announcement
Metadata
None
None
None
None
None
Static archive. pagure.io was sunset in 2026; this is a read-only snapshot.
Red Hat Logo

Fedora is sponsored by Red Hat. Learn more about the relationship between Red Hat and Fedora »

© Red Hat, Inc. and others.