Bug#836248: /usr/bin/dh_sphinxdoc: please provide substvar for Built-Using
Hi Sean, On Wed, Aug 31, 2016 at 07:12:04PM -0700, Sean Whitton wrote: > If a package installs sphinx documentation then it can embed code from > sphinx themes, such as python3-alabaster. That means it needs a > "Built-Using: python3-alabaster (= foo)". dh_sphinxdoc could provide a > substvar for this purpose. This makes sense. I will implement it when I have time. In fact it affects not only Alabaster, but most other themes too (like Sphinx' own built-in basic.css). > (Is there some reason why the copy of the theme is not turned into > symlinks by dh_sphinxdoc, as embedded javascript is?) alabaster.css is generated from the template, so the resulting files may vary from package to package. If you open /usr/lib/python3/dist-packages/alabaster/static/alabaster.css_t you will see quite a lot template code there which will be replaced in actual packages. -- Dmitry Shachnev signature.asc Description: PGP signature
Bug#836248: /usr/bin/dh_sphinxdoc: please provide substvar for Built-Using
Package: sphinx-common Version: 1.4.6-1 Severity: normal File: /usr/bin/dh_sphinxdoc Dear maintainer, If a package installs sphinx documentation then it can embed code from sphinx themes, such as python3-alabaster. That means it needs a "Built-Using: python3-alabaster (= foo)". dh_sphinxdoc could provide a substvar for this purpose. I selected severity 'normal' rather than 'wishlist' since without such a substvar packages using sphinx themes are violating policy. It is not really feasible to supply Built-Using without a substvar as then a exactly-equal build dependency on the sphinx theme in question would be required. (Is there some reason why the copy of the theme is not turned into symlinks by dh_sphinxdoc, as embedded javascript is?) Thanks. -- System Information: Debian Release: stretch/sid APT prefers testing APT policy: (900, 'testing') Architecture: i386 (i686) Kernel: Linux 4.5.0-2-686-pae (SMP w/2 CPU cores) Locale: LANG=en_GB.utf8, LC_CTYPE=en_GB.utf8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Init: systemd (via /run/systemd/system) Versions of packages sphinx-common depends on: ii libjs-sphinxdoc 1.4.6-1 Versions of packages sphinx-common recommends: ii python3-sphinx 1.4.6-1 sphinx-common suggests no packages. -- no debconf information -- Sean Whitton signature.asc Description: PGP signature
