[issue42820] Sphinx conf.py needs_version entry is outdated
New submission from Tim Hoffmann <tim.hoffmann@posteo.de>: The sphinx conf.py entry `needs_version=1.8` (https://github.com/python/cpython/blob/1470edd6131c29b8a09ce012cdfee3afa269d...) is not in sync with the doc build requirements (https://github.com/python/cpython/blob/1470edd6131c29b8a09ce012cdfee3afa269d...) Possible solutions: a) Drop the `needs_version` config value. It's optional. b) Make sure to update both places. c) Or at minimum add a comment that `needs_version` is only a safeguard against very old sphinx versions but is not necessarily sufficient to build. ---------- assignee: docs@python components: Documentation messages: 384305 nosy: docs@python, timhoffm priority: normal severity: normal status: open title: Sphinx conf.py needs_version entry is outdated _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue42820> _______________________________________
Change by Terry J. Reedy <tjreedy@udel.edu>: ---------- nosy: +mdk _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue42820> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: This is related to #42843, which is about deciding what the min sphinx should be. Since the alternative to 3.2 is some 2.x, 1,8 is certainly wrong. ---------- nosy: +terry.reedy _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue42820> _______________________________________
participants (2)
-
Terry J. Reedy
-
Tim Hoffmann