New submission from Tim Hoffmann <tim.hoffm...@posteo.de>:

The sphinx conf.py entry `needs_version=1.8` 
(https://github.com/python/cpython/blob/1470edd6131c29b8a09ce012cdfee3afa269d553/Doc/conf.py#L48)

is not in sync with the doc build requirements 
(https://github.com/python/cpython/blob/1470edd6131c29b8a09ce012cdfee3afa269d553/Doc/requirements.txt#L6)

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 <rep...@bugs.python.org>
<https://bugs.python.org/issue42820>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to