[Python-modules-team] Bug#836248: Re-open

[Dmitry Shachnev]

Hi Neil,

On Thu, Nov 03, 2016 at 06:37:23PM +0000, Neil Williams wrote:
> [...]
>
> That results in a package containing:
>
>  Built-Using: python-sphinx-bootstrap-theme, sphinx (= 1.4.8-1)
>
> The problem with that is:
> $ apt-cache show sphinx
> N: Unable to locate package sphinx
> E: No packages found
>
> So dh_sphinxdoc should be putting in python-sphinx (= 1.4.8-1)

No. Let me quite the Debian Policy § 7.8 (the emphasis is mine):

  A Built-Using field must list the corresponding *source* package for any
  such binary package incorporated during the build […]

> Also, wasn't the original intention from the bug report that I'd be
> able to use it as:
>
>  Built-Using: python-sphinx-bootstrap-theme (= ${sphinxdoc:Built-Using})
>
> [...]
>
> It's the theme which adds the CSS. Having Built-Using for sphinx is
> fine but the version of the theme is unrelated to the version of sphinx.

The original bug was asking about Alabaster, which is the default theme,
and thus much more popular than the bootstrap theme.

I can try to detect whether the documentation contains embedded CSS/JS files
from any theme, but that would be quite complicated. The only way that comes
to my mind is comparing the file names in the theme package (extracted from
build-dependencies) and in the built package, and searching for *_t → *
renamings.

However, this sounds like a huge hack to me, so I am not sure I want to do
this.

In your particular case (lava-server-doc), you have the JS, CSS and fonts
files not symlinking, which sounds like a much bigger issue for me.
In dh_sphinxdoc, I cannot support every existing Sphinx theme, so you need
to symlink these files manually.

In lava-server-doc, there are > 5 MB of files that can be symlinked, and
only two files (8.1 kB) that are generated from templates, so I don't even
think it makes sense to care about them.

> Finally, can we have some documentation of how to use
> ${sphinxdoc:Built-Using} in man dh_sphinxdoc please?

Leaving this bug open for this part of your message.

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20161103/9e45ab2c/attachment.sig>