Path: csiph.com!1.us.feeder.erje.net!2.us.feeder.erje.net!feeder.erje.net!2.eu.feeder.erje.net!news2.arglkargh.de!news.mixmin.net!news.unit0.net!news.panservice.it!bofh.it!news.nic.it!robomod From: Thomas Goirand Newsgroups: linux.debian.maint.python Subject: Re: Upstream build system, Sphinx autodoc, Python import path Date: Thu, 29 Sep 2016 23:40:02 +0200 Message-ID: References: X-Original-To: debian-python@lists.debian.org X-Mailbox-Line: From debian-python-request@lists.debian.org Thu Sep 29 21:30:34 2016 Old-Return-Path: X-Amavis-Spam-Status: No, score=-6.98 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, LDO_WHITELIST=-5, MURPHY_DRUGS_REL8=0.02, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham autolearn_force=no X-Policyd-Weight: using cached result; rate:hard: -5 X-Enigmail-Draft-Status: N1110 Organization: Debian User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Icedove/45.2.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Mailing-List: archive/latest/14256 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/8f17303d-4521-05e5-5795-7b1aa4bd7d6d@debian.org Approved: robomod@news.nic.it Lines: 18 Sender: robomod@news.nic.it X-Original-Date: Thu, 29 Sep 2016 23:30:14 +0200 X-Original-Message-ID: <8f17303d-4521-05e5-5795-7b1aa4bd7d6d@debian.org> X-Original-References: <85h991lodg.fsf@benfinney.id.au> Xref: csiph.com linux.debian.maint.python:8914 On 09/27/2016 10:48 AM, Ben Finney wrote: > https://wiki.debian.org/Python/LibraryStyleGuide#Sphinx_documentation I just had a quick look to that page, not only it advises to override the wrong dh sequence, but also it gives stupid advices for intersphinx: "sphinx-build might try to access the Internet to fetch intersphinx inventory files; http_proxy set to 127.0.0.1:9 will prevent that." Instead of attempting circumvention of the effect of using intersphinx, it's best to simply *DISABLE* intersphinx in the conf.py of the documentation. Setting-up http_proxy / https_proxy to do that, really, is the wrong way. Lots of my packages contain intersphinx disabling patch= es. Cheers, Thomas Goirand (zigo)