[3.6] bpo-35564: add master_doc='contents' to conf.py (GH-11290). (GH-12461)

(cherry picked from commit fc8284e22074af8154e9865c8391b955f13a308b)

Co-authored-by: Jean-François B <jfbu@free.fr>

diff --git a/Doc/conf.py b/Doc/conf.py
index e2758bcd00b5bb1c16ad8c30ee1b8ab3c651ad19..fab963e23a0fee0c00f53570144933478edc657c 100644 (file)
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -40,6 +40,8 @@ needs_sphinx = '1.2'
 venvdir = os.getenv('VENVDIR', 'venv')
 exclude_patterns = [venvdir+'/*', 'README.rst']
 
+# Avoid a warning with Sphinx >= 2.0
+master_doc = 'contents'
 
 # Options for HTML output
 # -----------------------

diff --git a/Misc/NEWS.d/next/Documentation/2018-12-22-22-52-05.bpo-35564.TuEU_D.rst b/Misc/NEWS.d/next/Documentation/2018-12-22-22-52-05.bpo-35564.TuEU_D.rst
new file mode 100644 (file)
index 0000000..8ca95ee
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-12-22-22-52-05.bpo-35564.TuEU_D.rst
@@ -0,0 +1 @@
+Explicitly set master_doc variable in conf.py for compliance with Sphinx 2.0