Package: python3-rocm-docs
Version: 1.31.1-3
Severity: important

Dear Maintainer,

The rocm_docs.doxygen Sphinx extension crashes at build time when used with
Python 3.14. This causes all ROCm documentation packages (e.g. librocfft-doc)
to produce empty HTML directories, resulting in lintian errors and missing
documentation in the published debs.

== Error ==

When running `rocm-docs-build` (triggered via debian/rules
execute_after_dh_auto_build-indep), Sphinx fails with:

sphinx.errors.ExtensionError: Handler <function _run_doxygen at ...>
for event 'config-inited' threw an exception
(exception: '_Opt' object is not subscriptable)

Full traceback observed in the Launchpad PPA build log for
rocfft 7.2.4-0ubuntu1~ppa3~26.10:
https://launchpad.net/~igorluppi/+archive/ubuntu/rocfft-7.2.3/+build/32925021/+files/buildlog_ubuntu-stonking-amd64.rocfft_7.2.4-0ubuntu1~ppa3~26.10_BUILDING.txt.gz

(search for "Extension error (rocm_docs.doxygen)")

== Impact ==

- rocm-docs-build exits without generating HTML
- dh_sphinxdoc reports "Sphinx documentation not found"
- The resulting -doc package ships an empty html/ directory
- lintian reports E: doc-base-file-references-missing-file on the published deb
- Affects all ROCm packages that use rocm-docs-build for documentation

== Platform ==

- Ubuntu stonking (26.10), Python 3.14.5
- Does NOT affect resolute (26.04), which uses Python 3.12 — docs build fine 
there

== Steps to reproduce ==

Build any ROCm source package that uses rocm-docs-build (e.g. rocfft, hipfft)
on stonking. The libXXX-doc deb will be ~6 KiB instead of the expected ~several 
MB.

-- System Information:
Debian Release: forky/sid
  APT prefers resolute-updates
  APT policy: (500, 'resolute-updates'), (500, 'resolute-security'), (500, 
'resolute')
Architecture: amd64 (x86_64)

Kernel: Linux 7.0.0-15-generic (SMP w/16 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL 
set to C.UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python3-rocm-docs depends on:
ii  python3                       3.14.3-0ubuntu2
pn  python3-breathe               <none>
pn  python3-fastjsonschema        <none>
pn  python3-git                   <none>
pn  python3-github                <none>
pn  python3-myst-nb               <none>
pn  python3-pydata-sphinx-theme   <none>
pn  python3-sphinx                <none>
pn  python3-sphinx-book-theme     <none>
pn  python3-sphinx-copybutton     <none>
pn  python3-sphinx-design         <none>
pn  python3-sphinx-external-toc   <none>
pn  python3-sphinx-notfound-page  <none>
ii  python3-yaml                  6.0.3-1build1

python3-rocm-docs recommends no packages.

Versions of packages python3-rocm-docs suggests:
pn  python-rocm-docs-core-doc  <none>

Reply via email to