Path: csiph.com!goblin2!goblin1!goblin.stu.neva.ru!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: providing sphinx3-* binaries Date: Wed, 04 Oct 2017 11:50:01 +0200 Message-ID: References: X-Original-To: "debian-python@lists.debian.org" X-Mailbox-Line: From debian-python-request@lists.debian.org Wed Oct 4 09:40:20 2017 Old-Return-Path: X-Amavis-Spam-Status: No, score=-6.9 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, FOURLA=0.1, LDO_WHITELIST=-5, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham autolearn_force=no X-Policyd-Weight: using cached result; rate: -5 Organization: Debian User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable X-Mailing-List: archive/latest/15294 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/8f5e7e9e-ca7b-91c6-0be6-bedc0cec643a@debian.org Approved: robomod@news.nic.it Lines: 62 Sender: robomod@news.nic.it X-Original-Date: Wed, 4 Oct 2017 11:39:59 +0200 X-Original-Message-ID: <8f5e7e9e-ca7b-91c6-0be6-bedc0cec643a@debian.org> X-Original-References: <877ewlqeku.fsf@curie.anarc.at> <067d5331-7558-2df6-22d4-a3a8a684b9ed@debian.org> <05e13d52-a620-6fbc-b5e2-14060c5aade1@gmail.com> Xref: csiph.com linux.debian.maint.python:9912 On 10/04/2017 04:41 AM, Ghislain Vaillant wrote: >=20 >=20 > On 03/10/17 22:46, Thomas Goirand wrote: >> On 09/29/2017 01:08 PM, PICCA Frederic-Emmanuel wrote: >>> Hello guyes. >>> >>>> override_dh_sphinxdoc: >>>> ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS))) >>> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2= =A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0= =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 ^^^^ >>> nodocs or nodoc >>> >>> I alsa do something like this when there is extensions. >>> >>> override_dh_sphinxdoc: >>> ifeq (,$(findstring nodoc, $(DEB_BUILD_OPTIONS))) >>> =C2=A0=C2=A0=C2=A0=C2=A0PYBUILD_SYSTEM=3Dcustom \ >>> =C2=A0=C2=A0=C2=A0=C2=A0PYBUILD_BUILD_ARGS=3D"cd docs && PYTHONPATH=3D= {build_dir} >>> http_proxy=3D'127.0.0.1:9' {interpreter} -m sphinx -N -bhtml source >>> build/html" dh_auto_build=C2=A0 # HTML generator >>> =C2=A0=C2=A0=C2=A0=C2=A0dh_installdocs "docs/build/html" -p python-gp= yfft-doc >>> =C2=A0=C2=A0=C2=A0=C2=A0dh_sphinxdoc -O--buildsystem=3Dpybuild >>> endif >> >> In fact, I was thinking that probably, it'd be nicer to even do: >> >> ifeq (,$(findstring nodoc, $(DEB_BUILD_PROFILES))) >> >> and have Build-Profiles: for the python-foo-doc package. This >> could even become a standard in the DPMT if everyone agrees. >> >> Thoughts anyone? >=20 > s/DEB_BUILD_PROFILES/DEB_BUILD_OPTIONS >=20 > Quoting the relevant part of the documentation for the nodoc build > profile [1]: >=20 > "Builds that set this profile must also add nodoc to DEB_BUILD_OPTIONS" >=20 > [1] https://wiki.debian.org/BuildProfileSpec >=20 > Cheers, > Ghis Yeah, I saw it, though I was wondering if it was a good idea or not to attempt to change this. I don't really see the point of having to set both options, when only a single one should be enough. Also, if you only set DEB_BUILD_OPTIONS=3Dnodoc, then you end up with an empty -doc package= , which isn't very useful. So, I don't really see the use case of having 2 options here. Your thoughts? Cheers, Thomas Goirand (zigo)