Groups > linux.debian.maint.python > #10814

sphinx-build vs. Python 3

Path	csiph.com!news.redatomik.org!aioe.org!bofh.it!news.nic.it!robomod
From	Ondrej Novy <novy@ondrej.org>
Newsgroups	linux.debian.maint.python
Subject	sphinx-build vs. Python 3
Date	Mon, 20 Aug 2018 10:10:01 +0200
Message-ID	<woNq9-3Oq-3@gated-at.bofh.it> (permalink)
X-Mailbox-Line	From debian-python-request@lists.debian.org Mon Aug 20 08:09:10 2018
Old-Return-Path	<ondrej.novy@gmail.com>
X-Amavis-Spam-Status	No, score=-1.997 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, EMPTY_BODY=3, FREEMAIL_FORGED_FROMDOMAIN=0.001, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.001, HTML_MESSAGE=2, LDO_WHITELIST=-5, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=no autolearn_force=no
X-Policyd-Weight	using cached result; rate: -7
Dkim-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=ondrej-org.20150623.gappssmtp.com; s=20150623; h=mime-version:from:date:message-id:subject:to; bh=0RPjORTk1aXZu+DNlhQJDS/Utmtewy7WnzEAKJix+xA=; b=n0ekDeo2PzAwKHeqwWgrzUaONeUurbnnLHf25r+iE789j0p6/SYv6t2UIb0p6JC4UV vsT+2e9Qg9cGIc1fnmkWWEs6azsewXkWw0mqKMNq6gt4nL8gQmpJnB3Au7WnV6ozLI1E ZQBhp4mFWFU+MfBatBtteBcJqBk4KddOOV7QssUWUaNBZktR4nntAv737nMylhKQNHPA TGx75mtsrxDYM5Ae+u4aQqNID3SY/3MWIoMfMsPLsxlGSPUtKAKirAdZt2RzyoUzW7IL X1u/aQ28Qvn5JpsWlHWerkaYs4bekk/SX26OccUQH5UtySgMzYTaRMd7OAZFT2JA8g+x Uqgw==
X-Google-Dkim-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=0RPjORTk1aXZu+DNlhQJDS/Utmtewy7WnzEAKJix+xA=; b=CWirw6izyOwLrUbHcwimd1iuK2Z9LJDk8cNZZ+/0fLnfV5q1RBdYkr9pNLld53BIRU NapMKKyiXywKhN4R+G9NMoU5K9MRcJWA052eAveL7gcZ5N1x7/bD9oeqzN/0IVWRZKi6 H12enGnL/yRmXZN82sE/5g9OmaMjSdQ0+zSqTPOmEVT6I79y0HCnLjwaE0DQ0X39FcZW ZzrC1CKQpr6b3tzXr5WbD70SMjSndjZUgaNACFT8DmBa5V7AKhhbr4Y1u6NGPok4k8+P YDVi/SfefYsnc5t5f9kSVYjYBcVV3Q+uSksuyjEgxqcEZf/8jnUkHl0+baGyj67hs4Og IagA==
X-Gm-Message-State	AOUpUlHMTKjL5F+gR1b0WZ9hhb4PEKoixKeY8w6TpMZJ9M3qEgK/OCWM RN1UpPOLUHH6E39B1O7sElaE4NvsQGgaxMZO/2suvA==
X-Google-SMTP-Source	AA+uWPxbysuRQ1y//q3ZmiCYGv+Rru0uqxWKLKIpPh96B8ZgJ31qtCqrJhg4LVhPvNsTTQ7TQ+TcqrWA0M4WWdNd9Kg=
X-Received	by 2002:ab0:6545:: with SMTP id x5-v6mr28612787uap.139.1534751436728; Mon, 20 Aug 2018 00:50:36 -0700 (PDT)
MIME-Version	1.0
Content-Type	multipart/alternative; boundary="000000000000346ea10573d92a06"
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/16234
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/CAOO6c=x1ct-idZy1S9WJM2wnT-FEeQewfEo8QAApCdX1+o4eXw@mail.gmail.com
Approved	robomod@news.nic.it
Lines	64
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Mon, 20 Aug 2018 09:50:25 +0200
X-Original-Message-ID	<CAOO6c=x1ct-idZy1S9WJM2wnT-FEeQewfEo8QAApCdX1+o4eXw@mail.gmail.com>
Xref	csiph.com linux.debian.maint.python:10814

Show key headers only | View raw

[Multipart message — attachments visible in raw view] - view raw

Hi,

I have question about sphinx-build and our effort to move to Python 3.

sphinx-build is currently Python 2 or Python 3 according to python-sphinx /
python3-sphinx package installed (with python3 as default if both are
installed by alternative priority).

According to:
https://wiki.debian.org/Python/LibraryStyleGuide#Sphinx_documentation we
should use "python3 -m sphinx" if we want to build docs using Python 3,
because if you run sphinx-build, you can't be sure which version of Sphinx
is run and if you need some Sphinx extension, which we typically installs
only Python 2 or Python 3 version of it.

And my question is:
* should we use "python3 -m sphinx" instead of "sphinx-build" everywhere
where python3-sphinx is in B-D (mass-commit?)
OR
* should we change sphinx-build to be Python3 only? (and broke current
packages build with Python2 Sphinx)

Thanks for your opinions.

-- 
Best regards
 Ondřej Nový

Email: novy@ondrej.org
PGP: 3D98 3C52 EB85 980C 46A5  6090 3573 1255 9D1E 064B

Back to linux.debian.maint.python | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

sphinx-build vs. Python 3 Ondrej Novy <novy@ondrej.org> - 2018-08-20 10:10 +0200
  Re: sphinx-build vs. Python 3 Thomas Goirand <zigo@debian.org> - 2018-08-20 12:40 +0200
    Re: sphinx-build vs. Python 3 Ondrej Novy <novy@ondrej.org> - 2018-08-21 10:50 +0200
      Re: sphinx-build vs. Python 3 Thomas Goirand <zigo@debian.org> - 2018-08-21 12:40 +0200
        Re: sphinx-build vs. Python 3 Ondrej Novy <novy@ondrej.org> - 2018-08-21 13:00 +0200
  Re: sphinx-build vs. Python 3 Dmitry Shachnev <mitya57@debian.org> - 2018-08-21 15:10 +0200
    Re: sphinx-build vs. Python 3 Mattia Rizzolo <mattia@debian.org> - 2018-08-21 22:30 +0200

csiph-web