Re: [Python-modules-team] Bug#830186: sphinx: intersphinx mapping extension causes network access during package builds

[Sergio Durigan Junior <sergiodj@sergiodj.net>]

On Thursday, July 14 2016, Andreas Tille wrote:

>> Not sure I understand how dh-python / pybuild help with this problem.
>> 
>> I thought the recommended way to deal with building documentation was
>> something like this in debian/rules:
>> 
>> override_dh_auto_build:
>>         dh_auto_build
>>         PYTHONPATH=. sphinx-build -b html -N Doc/ Doc/.build/html
>> 
>> ... in which case building the documentation happens outside
>> dh_auto_build.
>
> I'm using
>
> override_dh_auto_build:
>         # arch
>         USE_CYTHON=true dh_auto_build
>         # indep:
>         PYTHONPATH=. http_proxy='127.0.0.1:9' sphinx-build -N -b html doc build/html
>         PYTHONPATH=. http_proxy='127.0.0.1:9' sphinx-build -N -b man doc build/man
>
> in python-biom-format[1] which results in #831239.  I was once advised
> to specify the http_proxy that way (others here in this thread as well)
> and I wonder how to solve this.  If I try to export http_proxy and do
> not call sphinx-build manually at all no documentation will be created.

Hey Andreas,

You have to instruct debhelper to use dh_sphinxdoc.  I.e.:

  dh $@ --with python2,python3,bash-completion,sphinxdoc --buildsystem=pybuild

Cheers,

-- 
Sergio
GPG key ID: 237A 54B1 0287 28BF 00EF  31F4 D0EB 7628 65FC 5E36
Please send encrypted e-mail if possible
http://sergiodj.net/