Path: csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From: PICCA Frederic-Emmanuel <frederic-emmanuel.picca@synchrotron-soleil.fr>
Newsgroups: linux.debian.maint.python
Subject: how to build sphinx doc when there is extension
Date: Tue, 30 Aug 2016 09:40:02 +0200
Message-ID: <sbLOi-1No-21@gated-at.bofh.it>
Old-Return-Path: <frederic-emmanuel.picca@synchrotron-soleil.fr>
Thread-Topic: how to build sphinx doc when there is extension
Thread-Index: AdICjjSie4mBbJQMSH6CcC2KCwA2rA==
Accept-Language: fr-FR, en-US
Content-Language: fr-FR
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Approved: robomod@news.nic.it
Lines: 25
Organization: linux.* mail to news gateway
Sender: robomod@news.nic.it
Xref: csiph.com linux.debian.maint.python:8825

Hello

I am using this snipset when I want to build the sphinx documentation for a=
ll python available. (this is a sort of unit test).
Usually the sphinx doc use auto-doc and then it allows to check that all mo=
dules can be imported.=20

override_dh_sphinxdoc:
ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS)))
	PYBUILD_SYSTEM=3Dcustom \
	PYBUILD_BUILD_ARGS=3D"cd doc && PYTHONPATH=3D{build_dir} http_proxy=3D'127=
.0.0.1:9' {interpreter} -c \"import sys;from sphinx import main;sys.exit(ma=
in(sys.argv))\" -N -bhtml source build/html" dh_auto_build  # HTML generato=
r
	dh_installdocs "doc/build/html" -p python-pyfai-doc
	dh_sphinxdoc -O--buildsystem=3Dpybuild
endif


I would like your opinion about this and if there is better way to do this =
?

thanks

Frederic=