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

2016-07-14 Thread Andreas Tille
Hi,

On Sun, Jul 10, 2016 at 11:34:53AM +1000, Brian May wrote:
> Moved to debian-python list from bug report.

Great - so I can step in here with an equivalent problem. :-)
 
> 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.

So how to solve this?

Kind regards

   Andreas.

[1] https://anonscm.debian.org/git/debian-med/python-biom-format.git

-- 
http://fam-tille.de



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

2016-07-14 Thread Sergio Durigan Junior
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/



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

2016-07-14 Thread Piotr Ożarowski
[Andreas Tille, 2016-07-14]
> override_dh_auto_build:
> # arch
> USE_CYTHON=true dh_auto_build
> # indep:

override_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
> 

(python-sphinx is only in Build-Depends-Indep hence you cannot use it in
override_dh_auto_build)
-- 
Piotr Ożarowski Debian GNU/Linux Developer
www.ozarowski.pl  www.griffith.cc   www.debian.org
GPG Fingerprint: 1D2F A898 58DA AF62 1786 2DF7 AEF6 F1A2 A745 7645