Break building docs on distros where python3==python3.6 or older
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v2 Latest3 patches 4 repliesIn review
- v1 RFC3 patches 0 repliesSuperseded
Changes in v2 from the cover letter
- I forgot to merge some hunks at the last patch;
- I ended modifying the logic: it now provides a hint at the broken distros, showing how to call sphinx-build-wrapper directly to override the python3 version.
Patches in v2 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/3 | tools/docs: python_version.py: drop a debug printtools/ | +0 | 0 replies | |
| 2/3 | tools/docs: python_version: allow check for alternatives and bail outtools/ | +35 | 0 replies | |
| 3/3 | tools/docs: sphinx-* break documentation bulds on openSUSEtools/ tools/ | +4 | 4 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.
Cover letter [PATCH v2 0/3] Break building docs on distros where python3==python3.6 or older
Add two patches improving python_version logic, adding two extra optional arguments: show_alternatives and bail_out.
The third patch changes the build behavior in a way that distros shipped with Python 3.6 like openSUSE Leap, RHEL8 and others will break.
Personally, I'm against such patch, but based on some discussions at:
Several developers voiced that the best is to break the build. So, I'll let up to the docs maintainer to decide weather or not apply the final patch or replace by something that would avoid such breakage.
This series is on top of the sphinx-build-wrapper patch:
https://lore.kernel.org/linux-doc/[email protected]/
---
v2:
- I forgot to merge some hunks at the last patch;
- I ended modifying the logic: it now provides a hint at the broken distros, showing how to call sphinx-build-wrapper directly to override the python3 version.
Mauro Carvalho Chehab (3):
tools/docs: python_version.py: drop a debug print tools/docs: python_version: allow check for alternatives and bail out tools/docs: sphinx-* break documentation bulds on openSUSE
tools/docs/lib/python_version.py | 45 +++++++++++++++++++++++++------- tools/docs/sphinx-build-wrapper | 3 ++- tools/docs/sphinx-pre-install | 3 ++- 3 files changed, 39 insertions(+), 12 deletions(-)
Signature · 1 line
2.51.0