Hi Neil!

On Fri, Nov 19, 2021 at 09:48:56AM +0000, Neil Williams wrote:
> tag 1000184 - pending
> thanks
>
> Does dh_sphinxdoc need to also disable https: or does
> intersphinx_mapping have to be patched out of every package using Sphinx?

dh_sphinxdoc is a packaging helper that is called *after* the documentation
is built and installed. It cannot affect the docs build process in any way.

If you want to disable network access, you should set the environment
variables yourself in debian/rules. http_proxy is not enough, you need to
set https_proxy to the same value.

> This will inevitably cause another difference between the upstream
> documentation and the packaged documentation, unless some sort of cache
> can be created.
>
> For python-jira and a number of other Python packages, the only
> solution for now is to patch out intersphinx support entirely.
>
> (Spotted via a reproducibility failure).

You can make it link to packaged versions of documentation. See what I do
in packaging of sphinx itself:

https://salsa.debian.org/python-team/packages/sphinx/-/blob/debian/master/debian/patches/intersphinx_local.diff

--
Dmitry Shachnev

Attachment: signature.asc
Description: PGP signature

Reply via email to