This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author vstinner
Recipients Maciej Olko, benjamin.peterson, docs@python, doko, eric.araujo, ezio.melotti, georg.brandl, mdk, miss-islington, ned.deily, python-dev, rhettinger, serhiy.storchaka, skrah, terry.reedy, vstinner, willingc, xtreak
Date 2020-08-17.06:55:15
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1597647316.03.0.33367933333.issue40204@roundup.psfhosted.org>
In-reply-to
Content
I'm now able to build the Python documentation with Sphinx 3.2.1 without modifying the Doc/Makefile, so using -W option (treat warnings as errors): there are no more Sphinx 3 warnings.

When Sphinx 3 will be more widely available (ex: in Linux distributions), we will be able to consider removing c_allow_pre_v3=True and c_warn_on_allowed_pre_v3=False in doc/conf.py. For that, we should update the documentation to use the Sphinx 3 syntax, see PR 19397 written by Jakob Lykke Andersen.

For now, I prefer to keep Sphinx 2 support and so keep Sphinx 2 syntax in the C domain, since it allows supporting Sphinx 2 and Sphinx 3.
History
Date User Action Args
2020-08-17 06:55:16vstinnersetrecipients: + vstinner, georg.brandl, rhettinger, terry.reedy, doko, benjamin.peterson, ned.deily, ezio.melotti, eric.araujo, skrah, docs@python, python-dev, serhiy.storchaka, willingc, mdk, miss-islington, xtreak, Maciej Olko
2020-08-17 06:55:16vstinnersetmessageid: <1597647316.03.0.33367933333.issue40204@roundup.psfhosted.org>
2020-08-17 06:55:16vstinnerlinkissue40204 messages
2020-08-17 06:55:15vstinnercreate