debian/pyhtml2devhelp.py generates a manual in devhelp format v1, which
was replaced by format v2 in 2005 and deprecated in 2018. Applications
based on the foundry library, like manuals (which replaced devhelp in
testing/unstable) and gnome-builder, no longer support loading devhelp
format v1 libraries.

One way to address this would be to make pyhtml2devhelp.py generate a
.devhelp2 file, instead of the current .devhelp.gz, and adapt its
contents to format v2. I attach some patches to do this.

Alternatively, the packaging could use python3-sphinxcontrib.devhelp,
which provides an extended version of sphinx's HTML output that adds a
devhelp index, and was recently enhanced to generate devhelp format v2.
This would avoid needing to screen-scrape Sphinx's HTML output, which
doesn't work particularly well because it's very sensitive to the exact
HTML that's generated for the index (I'll open a separate bug for the
incomplete index entries that result from this).

Or the index could perhaps be generated by parsing Sphinx's internal
data (searchindex.js or objects.inv, or some temporary file from which
they are generated), but I don't know enough about Sphinx to know which
route would be the best for doing that.

Thanks,
    smcv

please prepare these patches for python3.15 instead.

Control: reassign -1 python3.15-doc
Control: retitle -1 python3.15-doc: devhelp documentation not shown by libfoundry-based apps such as manuals, gnome-builder
identical, and d/rules only has differences that are far enough away not
to cause conflicts.

     smcv

We believe that the bug you reported is fixed in the latest version of
python3.15, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1147626@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Matthias Klose <doko@debian.org> (supplier of updated python3.15 package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)
Format: 1.8
Date: Sun, 27 Sep 2026 09:01:56 +0200
Source: python3.15
Architecture: source
Version: 3.15.0~rc2-3
Distribution: unstable
Urgency: medium
Maintainer: Matthias Klose <doko@debian.org>
Changed-By: Matthias Klose <doko@debian.org>
Closes: 1147626
Changes:
 python3.15 (3.15.0~rc2-3) unstable; urgency=medium
 .
   [ Matthias Klose ]
   * Update to the 3.15 branch 2026-09-27.
   * Update devhelp documentation for devhelp format v2 (Simon McVittie).
     Closes: #1147626.
 .
   [ Maximiliano Curia ]
   * Use importlib.util instead of removed imp module in mkbinfmt.py.
   * Clean up PVER-minimal.README.Debian.in module list for Python 3.15: drop
     obsolete modules and add newly built-in minimal modules.
   * Add _math_integer and fix _zstd type in PVER-minimal.README.Debian.in
   * Update setup-modules.diff to include all _zstd source files in
     Modules/Setup
Checksums-Sha1:
 7c006d640e4234f046f1ffde5b4edb18258bef1e 4076 python3.15_3.15.0~rc2-3.dsc
 853f8c7bcb00aa6848e65447ed78493df9625e2d 445684 python3.15_3.15.0~rc2-3.debian.tar.xz
 26098a206927fd2ae44f526274fe59c984b59423 10499 python3.15_3.15.0~rc2-3_source.buildinfo
Checksums-Sha256:
 54a218e2c1861cc6af871884a1c08162fe89f9df35a8be1e44d4b61068f10386 4076 python3.15_3.15.0~rc2-3.dsc
 80d4622ed4e66fc5f75d34b79c694518bc85b30cc6aede474f42bcd27fd2779f 445684 python3.15_3.15.0~rc2-3.debian.tar.xz
 5faaa2686dd0800681a685f52c696a0c6b3d7bba86a5d17ae6d8e83279e15c86 10499 python3.15_3.15.0~rc2-3_source.buildinfo
Files:
 5458982c455e2e46e8fb27ad7e981983 4076 python optional python3.15_3.15.0~rc2-3.dsc
 38be946b029948040d52dffb47e2c6cd 445684 python optional python3.15_3.15.0~rc2-3.debian.tar.xz
 f853aa2816c002b5ac0847db97a7bfeb 10499 python optional python3.15_3.15.0~rc2-3_source.buildinfo
-----BEGIN PGP SIGNATURE-----

iQJEBAEBCgAuFiEE1WVxuIqLuvFAv2PWvX6qYHePpvUFAmq4wvsQHGRva29AZGVi
aWFuLm9yZwAKCRC9fqpgd4+m9UubEACt3eA35TCRVDSv+0tCD6RYsUv3WXTS/XB5
05VfI1oqy6BidHmCS4edbgaH3LBSUY0WxIlBL2fHJXanqoBzredwiQ8XKSmZiNnj
vkdM5eMSOR2knvxQyQhPFu+qDWLg/hgMUUgvYt6VQcuheH9G6haQsRcNtH+9OWNX
FSPKNzJ3X68mU8r+bwCodQ2amB1kPciHrWGcCxsZUOB8vPw+xefgkPI0myvUOnBr
76e6g1PdQi3xH3w56aWayCE1yTzBPLCXbElNESGFLhllBa+q8CXU3IOnDUqqO5Rm
a0YIVqVvKq+Y+fxQ60dqUlySGA1KHMPnX3q5HnmAh25Y1twQTN3k6txipszrmzHJ
0quS56oqvBcNzlO+F5UpT4ejDhi/CJJS/QEx1sWiUwluRix+Soi7g2vjeMd2qVuF
EgtTuyvJUMB4qjmhVknxY1Wq/+ps++njB2UwvtQz4R/ekYGp8LysJnDDkJEsaWe3
Gtf1xggFZ2yxlTibZhFK6K3skwxmrjCwBR5JjcMCn9JFiEbDNWimUMKtLNXSarPC
IMH+Z0PMlGShyh3RcB8KsYZLhTOzgKG+4dtAxDVVKV3KooBn4aBHB5fMwuZSnIQP
kWL5/1bX2tWJnZol+exaMNwIvsArTkaeDE/Vr4HV+WeefFum33R1OvlAk4YnCiOI
qIBkAOagZA==
=Br4Z
-----END PGP SIGNATURE-----