Package: python3-sphinx
Version: 8.1.3-5
Severity: important

Dear Maintainer,

the mentioned patch includes the hunk:

    --- a/sphinx/application.py
    +++ b/sphinx/application.py
    @@ -122,7 +122,6 @@ _first_party_themes = (
         'alabaster',
     )
     builtin_extensions += _first_party_themes
    -builtin_extensions += _first_party_extensions
     
     ENV_PICKLE_FILENAME = 'environment.pickle'

which causes `sphinx-build -b htmlhelp` to fail with the highly non-helpful
error message:

    Sphinx error:
    Builder name htmlhelp not registered or available through entry point

This is since that line causes Sphinx to actively probe for installed
(Debian or otherwise) first-party extensions. Without that line, Sphinx 
instead expects the package to export an according entry point, which Sphinx’ 
own first-party extensions do not do.

Please remove the hunk in question and instead add the following hunks to have 
Sphinx attempt to load all first-party extensions but still tolerate their 
absence:

--- application.py   2025-08-28 14:39:46.514868940 +0200
+++ /usr/lib/python3/dist-packages/sphinx/application.py 2025-08-28 
14:44:27.414862345 +0200
@@ -20,7 +20,7 @@
 from sphinx import locale, package_dir
 from sphinx.config import ENUM, Config, _ConfigRebuild
 from sphinx.environment import BuildEnvironment
-from sphinx.errors import ApplicationError, ConfigError, 
VersionRequirementError
+from sphinx.errors import ApplicationError, ConfigError, 
VersionRequirementError, ExtensionError
 from sphinx.events import EventManager
 from sphinx.highlighting import lexer_classes
 from sphinx.locale import __
@@ -248,7 +249,10 @@
         # load all built-in extension modules, first-party extension modules,
         # and first-party themes
         for extension in builtin_extensions:
-            self.setup_extension(extension)
+            try:
+                self.setup_extension(extension)
+            except ExtensionError:
+                pass  # DEBIAN: Allow missing first-party extensions
 
         # load all user-given extension modules
         for extension in self.config.extensions:


Hunk to remove:

@@ -122,7 +122,6 @@
     'alabaster',
 )
 builtin_extensions += _first_party_themes
-builtin_extensions += _first_party_extensions
 
 ENV_PICKLE_FILENAME = 'environment.pickle'
 

Sincerely,
Erin of Yukis


-- System Information:
Debian Release: 13.0
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 
'stable'), (100, 'trixie-fasttrack'), (100, 'trixie-backports-staging')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 6.16.3-1-liquorix-amd64 (SMP w/4 CPU threads; PREEMPT)
Locale: LANG=de_AT.UTF-8, LC_CTYPE=de_AT.UTF-8 (charmap=UTF-8), 
LANGUAGE=de:en_US
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python3-sphinx depends on:
ii  python3 [python3-supported-min]  3.13.5-1
ii  python3-alabaster                0.7.16-0.1
ii  python3-babel                    2.17.0-1
ii  python3-defusedxml               0.7.1-3
ii  python3-docutils                 0.21.2+dfsg-2
ii  python3-imagesize                1.4.1-1
ii  python3-jinja2                   3.1.6-1
ii  python3-packaging                25.0-1
ii  python3-pygments                 2.18.0+dfsg-2
ii  python3-requests                 2.32.3+dfsg-5
ii  python3-snowballstemmer          2.2.0-4
ii  python3-tomli                    2.2.1-2+b1
ii  sphinx-common                    8.1.3-5

Versions of packages python3-sphinx recommends:
ii  make         4.4.1-2
ii  python3-pil  11.1.0-5+b1

Versions of packages python3-sphinx suggests:
ii  dvipng                           1.18-1
pn  dvisvgm                          <none>
ii  fonts-freefont-otf               20211204+svn4273-2
ii  imagemagick                      8:7.1.1.43+dfsg1-1
ii  imagemagick-7.q16 [imagemagick]  8:7.1.1.43+dfsg1-1
ii  latexmk                          1:4.86~ds-1
pn  node-mathjax-full                <none>
ii  python3-sphinx-rtd-theme         3.0.2+dfsg-2
pn  sphinx-doc                       <none>
ii  tex-gyre                         20180621-6
ii  texlive-fonts-extra              2024.20250309-2
ii  texlive-fonts-recommended        2024.20250309-1

Attachment: signature.asc
Description: This is a digitally signed message part.

Reply via email to