sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.61k stars 2.13k forks source link

Expire support for root_doc "contents" rewriting #13082

Open timhoffm opened 3 weeks ago

timhoffm commented 3 weeks ago

Since 2.0, there has been special code to support a root doc "contents", which has not been specified in the config:

https://github.com/sphinx-doc/sphinx/blob/116a430caca98580c8877cf7b0ba270eae9604bf/sphinx/config.py#L769-L781

As cleanup / maintanance, I'd like to remove this code. Question: Is the log warning sufficient so that we can immediately remove, or do you want a formal deprecation?