Hi Ondřej! On Mon, Aug 20, 2018 at 09:50:25AM +0200, Ondrej Novy wrote: > 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. That wiki page was written before I changed Sphinx scripts to use Python 3 by default. That happened only recently, the relevant upload reached unstable on July 5th 2018. If you depend on python3-sphinx (>= 1.7.5-4~) then most likely the scripts will be using Python 3. The opposite will happen only if the user manually updated the alternative, and this won’t be the case on a sane build environment. > And my question is: > * should we use "python3 -m sphinx" instead of "sphinx-build" everywhere > where python3-sphinx is in B-D (mass-commit?) This won’t hurt, but as I said it won’t make any difference on the current unstable. It will make difference only when building against an older version of sphinx (e.g. backports) *and* with installed python-sphinx. > * should we change sphinx-build to be Python3 only? (and broke current > packages build with Python2 Sphinx) I would like to do this in the future, but currently there will be too many broken packages: https://lintian.debian.org/tags/build-depends-on-python-sphinx-only.html lists 386 packages. -- Dmitry Shachnev
Attachment:
signature.asc
Description: PGP signature