[issue31036] building the python docs requires the blurb module

Benjamin Peterson added the comment: New changeset 0bd59d655280ad4c4aff2d327789815b89caee18 by Benjamin Peterson in branch '2.7': [2.7] bpo-31036: Allow sphinx and blurb to be found automatically (GH-16638) https://github.com/python/cpython/commit/0bd59d655280ad4c4aff2d327789815b89caee18 --

[issue31036] building the python docs requires the blurb module

Change by Benjamin Peterson : -- pull_requests: +16223 pull_request: https://github.com/python/cpython/pull/16638 ___ Python tracker ___ ___

[issue31036] building the python docs requires the blurb module

Change by Ned Deily : -- Removed message: https://bugs.python.org/msg342110 ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: New changeset 362e9fb0de4321bf265dbca290f7dc1f383a4a47 by Ned Deily in branch '3.4': [3.5] bpo-31036: use an existing Misc/NEWS rather than trying to use blurb (#2874) (#2926) https://github.com/python/cpython/commit/362e9fb0de4321bf265dbca290f7dc1f383a4a47 ---

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: P.S. I just noticed that I forgot to credit Brett here as the source (from superseded PR 2953) of a good portion of the last round of PRs. Thanks! -- ___ Python tracker _

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: New changeset 9cc332094c5f8cbaa47400633ab3ba372da61c9d by Ned Deily in branch '3.5': [3.5] bpo-31036: Allow sphinx and blurb to be found automatically (GH-3440) https://github.com/python/cpython/commit/9cc332094c5f8cbaa47400633ab3ba372da61c9d -- _

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: For the 3.6 and master branches, I've now enhanced Doc/Makefile to better find its tools. If the doc venv is present, e.g. make venv was run, the Doc build recipe will use sphinx-build and blurb from there, otherwise the process PATH will be search for installed v

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: New changeset 645c1e421348790d49eab863279a41cb2b6a007a by Ned Deily (Miss Islington (bot)) in branch '3.6': [3.6] bpo-31036: Allow sphinx and blurb to be found automatically (GH-3440) (#3441) https://github.com/python/cpython/commit/645c1e421348790d49eab863279a41cb

[issue31036] building the python docs requires the blurb module

Changes by Roundup Robot : -- pull_requests: +3438 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mai

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: New changeset 590665c399fc4aa3c4a9f8e7104d43a02e9f3a0c by Ned Deily in branch 'master': bpo-31036: Allow sphinx and blurb to be found automatically (#3440) https://github.com/python/cpython/commit/590665c399fc4aa3c4a9f8e7104d43a02e9f3a0c -- __

[issue31036] building the python docs requires the blurb module

Changes by Ned Deily : -- pull_requests: +3437 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.py

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: New changeset abe7b60b80f5cb23f84a49f95ef6ce23521eed14 by Larry Hastings (Ned Deily) in branch '3.5': [3.5] bpo-31036: use an existing Misc/NEWS rather than trying to use blurb (#2874) https://github.com/python/cpython/commit/abe7b60b80f5cb23f84a49f95ef6ce2352

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: This is marked as a release blocker for 3.4 and 3.5; however, Ned's Doc/Makefile change has been merged in both those versions. And no other branches have been "blurbified" yet. While we may improve the solution in the future, the fundamental problem (you ca

[issue31036] building the python docs requires the blurb module

Julien Palard added the comment: We upgraded Python on docs.python.org to 3.6 (from 3.4), so blurb can run. I pushed https://github.com/python/docsbuild-scripts/pull/22 to give the right Python in the PYTHON Makefile parameter. I'm currently running a test build locally and will merge soon. -

[issue31036] building the python docs requires the blurb module

Julien Palard added the comment: Still unfixed on docs.iad1.psf.io, the venv I modified is only used for sphinx and uses Python 2. If we can easily upgrade it to Python 3 we'll be able to pass it as the PYTHON parameter for make in docsbuild-script, allowing blurb to be found. see: https://gi

[issue31036] building the python docs requires the blurb module

Julien Palard added the comment: I added blurb to the docs build script (https://github.com/python/docsbuild-scripts/commit/06375b6d74f6d5613fcd48030b3af8032854c87d), so 3.5 should build soon. The requirements looks automatically pulled from psf-salt https://github.com/python/psf-salt/blob/mas

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: New changeset 362e9fb0de4321bf265dbca290f7dc1f383a4a47 by Ned Deily in branch '3.4': [3.5] bpo-31036: use an existing Misc/NEWS rather than trying to use blurb (#2874) (#2926) https://github.com/python/cpython/commit/362e9fb0de4321bf265dbca290f7dc1f383a4a47 -

[issue31036] building the python docs requires the blurb module

Changes by Ned Deily : -- pull_requests: +2977 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyt

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: New changeset 3de144890ad3bc50694368a1b33be6d7f3a780b3 by larryhastings (Ned Deily) in branch '3.5': [3.5] bpo-31036: use an existing Misc/NEWS rather than trying to use blurb (#2874) https://github.com/python/cpython/commit/3de144890ad3bc50694368a1b33be6d7f3a

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: And, in the past, I'm not aware that the availability of tools in the Debian ecosystem has been a strong determining factor in the choice of tooling for CPython. In particular, I'm not aware of any tool in the Debian package ecosystem that would solve the pro

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: We changed *revision control systems* "within subminor version updates". If your argument is "you mustn't add a new tool used to build the documentation until 3.7", you're not going to win that argument, you should try another tactic. -- ___

[issue31036] building the python docs requires the blurb module

Matthias Klose added the comment: > I'm not sure I understand your position. External tools are only > permissible if Debian packages exist for them? for a package build to use them, yes. > And, it's not "core python", it's the Python documentation, which has > always depended on external tool

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: What you're missing is that Misc/NEWS.d is removed from tarballs. We ship Misc/NEWS in tarballs but *not* Misc/NEWS.d. If you start with a CPython tarball (e.g. 3.5.4rc1), and then apply vendor-specific patches on top of that, and those patches include news e

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: > I expect that in a tarball, Misc/NEWS and Misc/NEWS.d contain exactly the > same entries. They don't. See for yourself :) https://www.python.org/ftp/python/3.5.4/Python-3.5.4rc1.tgz -- ___ Python tracker

[issue31036] building the python docs requires the blurb module

STINNER Victor added the comment: If we provide a prebuilt Misc/NEWS in tarball, if Makefile doesn't need blurb if Misc/NEWS already exists, doko's issue is fixed: Debian package builder will not need blurb anymore (PR 2874). > If the upstream patches are extracted from GitHub PRs, then they'

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: I just pushed PR 2874 (for 3.5) for review. I think it will solve the tarball problem. Review comments welcome. I'm still thinking about how to make blurb more easily "discoverable". That would be a separate PR. -- _

[issue31036] building the python docs requires the blurb module

Changes by Ned Deily : -- pull_requests: +2925 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyt

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: I guess it depends on what the upstream patches look like. If they're always coded against release tarballs and not against git repos, then they'll assume (correctly) that Misc/NEWS exists. In that case you shouldn't have to do anything. If the upstream pat

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: (Of course the above also applies to installed copies of Misc/NEWS, like Debian's /usr/share/doc/pythonx.x/NEWS.gz. The vanilla main Python Makefile doesn't install NEWS.) -- ___ Python tracker

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: The good news is that the released tarballs starting now and going forward will already have a generated Misc/NEWS just like they always have had. So blurb is not needed if you are building docs from such tarballs (like 3.5.4rc1). We did forget about building doc

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: > Sorry to say, but the assumption that pip should be used to be able to build > core python seems to be the wrong direction. I'm not sure I understand your position. External tools are only permissible if Debian packages exist for them? And, it's not "core

[issue31036] building the python docs requires the blurb module

Matthias Klose added the comment: > so why didn't blurb get installed for doko? it's not packaged, and I'm (and I think any other provider of distro packages) not using network access during the build. Sorry to say, but the assumption that pip should be used to be able to build core python se

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: Working on it. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyt

[issue31036] building the python docs requires the blurb module

Larry Hastings added the comment: * I was told that blurb needed to be in the core-workflow repo, that this was better than checking it in to CPython itself. Okay. If you want to debate the point, loop in Brett Cannon, he's the one with the strong opinions. * Ned has taken over the 3.3 branc

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: Please let Larry have a chance to look at this before we spend a lot of energy here rehashing discussions. We'll fix it, it's not hard! -- ___ Python tracker _

[issue31036] building the python docs requires the blurb module

Stéphane Wirtel added the comment: @haypo I don't want to add a new dependency, but it's an option. I prefer the suggestion of Ned. How do you imagine the patch ? -- ___ Python tracker ___

[issue31036] building the python docs requires the blurb module

STINNER Victor added the comment: > I will be a mess to update our copy. typo, you should read: "It will be..." ;-) (It will be a mess to update our copy of blurb.) -- ___ Python tracker _

[issue31036] building the python docs requires the blurb module

STINNER Victor added the comment: > There will be a new dependency, excepted if we store it into the Tools/ > directory. Please don't do that. I will be a mess to update our copy. It's already painful enough to embed our copy of libexpat, zlib and indirectly of OpenSSL (on Windows and macOS).

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: Unfortunately, updates to the Doc build process doc have not yet been made but the intended process is to provide blurb via the "make venv" Doc build recipe which now also pip-installs blurb from PyPI. It is the necessary to use that venv to build the docs: make

[issue31036] building the python docs requires the blurb module

STINNER Victor added the comment: Thread on python-committers: https://mail.python.org/pipermail/python-committers/2017-July/004763.html -- ___ Python tracker ___ ___

[issue31036] building the python docs requires the blurb module

Stéphane Wirtel added the comment: ok, I understand. but blurb is an external tool (github.com/python/core-workflow). There will be a new dependency, excepted if we store it into the Tools/ directory. and if we add it into Tools, we have to add it to the old branches where blurb is supposed t

[issue31036] building the python docs requires the blurb module

STINNER Victor added the comment: It will be easier to decide if Misc/NEWS was generated or not when... Misc/NEWS will be removed from Git: https://github.com/python/cpython/pull/2719 No? -- nosy: +haypo ___ Python tracker

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: > blurb should be only used when there is a release of python, and in this > case, only by the release manager. No, that's not the case. Blurb needs to be used whenever the docs are built because the NEWS file is used in the Docs build to produce the changelog.htm

[issue31036] building the python docs requires the blurb module

Stéphane Wirtel added the comment: blurb should be only used when there is a release of python, and in this case, only by the release manager. -- ___ Python tracker ___

[issue31036] building the python docs requires the blurb module

Ned Deily added the comment: We should be able to fix the Makefile recipe to handle either case, i.e. when Misc/NEWS.d is not present (as in the release tarballs), don't try to run blurb. -- versions: -Python 3.3 ___ Python tracker

[issue31036] building the python docs requires the blurb module

Changes by Stéphane Wirtel : -- nosy: +matrixise ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.p

[issue31036] building the python docs requires the blurb module

New submission from Matthias Klose: [Ned asked to submit that as a release blocker] the build of the documentation fails with at least the 3.5.4rc1. It adds a new build dependency (blurb), which is inconvenient to build on stable environments, or when pip is not available. Please could you co