[Python-modules-team] Bug#966325: sphinx-common: dh_sphinxdoc doesn't remove .doctrees from man

[Christopher Hoskin]

Package: sphinx-common
Version: 2.4.3-4
Severity: wishlist

Dear Maintainer,

The wiki page on building Sphinx documentation shows building documentation in
both PDF and man page formats:

https://wiki.debian.org/SphinxDocumentation

dh_sphinxdoc removes .doctrees from html documentationm but not from man pages
(fix_sphinx_doc returns if it doesn't detect html before drop_cruft  is
called). This leads to a lintian warning "package-contains-python-doctree-file".

Please consider if dh_sphinxdoc could drop cruft such as .doctrees from man
page as well. Alternatively, make it clear in the dh_sphinxdoc man page that
dh_sphinxdoc only applies to html documentation.

Thanks,

Christopher Hoskin


-- System Information:
Debian Release: bullseye/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.7.0-1-amd64 (SMP w/4 CPU threads)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE=en_GB:en
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages sphinx-common depends on:
ii  libjs-sphinxdoc  2.4.3-4

Versions of packages sphinx-common recommends:
ii  python3-sphinx  2.4.3-4

sphinx-common suggests no packages.

-- no debconf information