doc: Remove sphinxcontrib-seqdiag Python package from RTD builds

This is a proactive PR to avoid breaking docs builds when Setuptools 81
starts to be used in the RTD builds process.

The sphnixcontrib-seqdiag Python package is not compatible with
Setuptools 81 or later due to use of pkg_resources:
https://setuptools.pypa.io/en/latest/pkg_resources.html

Setuptools 81 release should be imminent, with the Python deprecation
warning stating pkg_resources "removal as early as 2025-11-30".

Seqdiag seems to be unmaintained with the latest update at Pypi in
the year 2021 and also no updates to the seqdiag git repo.

There are no seqdiag directives left in the docs after last seqdiags
were removed in PR #52308.

Two other options would exist for fixing the situation (see PR for
discussion) but this seems to be the suitable one.

Signed-off-by: Ville Ojamo <14869000+bluikko@users.noreply.github.com>
(cherry picked from commit 15481e509b)

Conflicts:
	doc/conf.py: formatting difference
This commit is contained in:
Ville Ojamo 2026-01-05 13:10:45 +07:00 committed by Patrick Donnelly
parent 1fa258301a
commit fa0e7b5bd4
No known key found for this signature in database
GPG Key ID: FA47FD0B0367D313
2 changed files with 1 additions and 7 deletions

View File

@ -15,7 +15,6 @@ sphinx_rtd_theme
Sphinx-Substitution-Extensions
sphinxcontrib-mermaid
sphinxcontrib-openapi
sphinxcontrib-seqdiag
# m2r2 replaces mistune https://github.com/CrossNox/m2r2?tab=readme-ov-file#m2r-the-original
m2r2
natsort

View File

@ -132,8 +132,7 @@ extensions = [
'ceph_confval',
'sphinxcontrib.mermaid',
'sphinxcontrib.openapi',
'sphinxcontrib.seqdiag',
]
]
ditaa = shutil.which("ditaa")
if ditaa is not None:
@ -242,10 +241,6 @@ for c in pybinds:
openapi_logger = sphinx.util.logging.getLogger('sphinxcontrib.openapi.openapi30')
openapi_logger.setLevel(logging.WARNING)
# seqdiag
seqdiag_antialias = True
seqdiag_html_image_format = 'SVG'
# ceph_confval
ceph_confval_imports = glob.glob(os.path.join(top_level,
'src/common/options',