Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


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

sphinx-build vs. Python 3

From Ondrej Novy <novy@ondrej.org>
Newsgroups linux.debian.maint.python
Subject sphinx-build vs. Python 3
Date 2018-08-20 10:10 +0200
Message-ID <woNq9-3Oq-3@gated-at.bofh.it> (permalink)
Organization linux.* mail to news gateway

Show all headers | 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