The following commands emits a lot of warnings: make PYTHON=../python SPHINXOPTS="-q -W -j4" -C Doc/ venv doctest # adapt PYTHON to point to Python 3.8 compiled in debug mmode Travis CI logs: https://travis-ci.org/python/cpython/jobs/458140641 make: Entering directory `/home/travis/build/python/cpython/Doc' ../python -m venv ./venv (...) The venv has been created in the ./venv directory make[1]: Entering directory `/home/travis/build/python/cpython/Doc' mkdir -p build Building NEWS from Misc/NEWS.d with blurb PATH=./venv/bin:$PATH sphinx-build -b doctest -d build/doctrees -D latex_elements.papersize= -q -W -j4 -W . build/doctest /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/babel/localedata.py:17: DeprecationWarning: Using or importing the ABCs from 'collections' instead of from 'collections.abc' is deprecated, and in 3.8 it will stop working from collections import MutableMapping /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/jinja2/runtime.py:318: DeprecationWarning: Using or importing the ABCs from 'collections' instead of from 'collections.abc' is deprecated, and in 3.8 it will stop working from collections import Mapping /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/jinja2/sandbox.py:82: DeprecationWarning: Using or importing the ABCs from 'collections' instead of from 'collections.abc' is deprecated, and in 3.8 it will stop working from collections import MutableSet, MutableMapping, MutableSequence /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/sphinx/environment/__init__.py:340: RemovedInSphinx30Warning: env.versionchanges() is deprecated. Please use ChangeSetDomain instead. for version, changes in other.versionchanges.items(): /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/sphinx/environment/__init__.py:341: RemovedInSphinx30Warning: env.versionchanges() is deprecated. Please use ChangeSetDomain instead. self.versionchanges.setdefault(version, []).extend( /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/docutils/parsers/rst/states.py:2130: RemovedInSphinx40Warning: highlightlang directive is deprecated. Please use highlight directive instead. result = directive_instance.run() /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) /home/travis/build/python/cpython/Doc/tools/extensions/pyspecific.py:274: RemovedInSphinx30Warning: env.note_versionchange() is deprecated. Please use ChangeSetDomain.note_changeset() instead. env.note_versionchange('deprecated', version[0], node, self.lineno) <doctest default[2]>:1: DeprecationWarning: `formatargspec` is deprecated since Python 3.5. Use `signature` and the `Signature` object directly formatargspec(*getfullargspec(f)) <doctest default[0]>:1: DeprecationWarning: the imp module is deprecated in favour of importlib; see the module's documentation for alternative uses import imp obj dead or exiting /home/travis/build/python/cpython/Lib/socket.py:660: ResourceWarning: unclosed <socket.socket fd=9, family=AddressFamily.AF_INET, type=SocketKind.SOCK_STREAM, proto=6, laddr=('172.17.0.8', 40136), raddr=('195.159.176.226', 119)> self._sock = None ResourceWarning: Enable tracemalloc to get the object allocation traceback make[1]: Leaving directory `/home/travis/build/python/cpython/Doc' make: Leaving directory `/home/travis/build/python/cpython/Doc' The command "if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then XVFB_RUN=xvfb-run; fi $XVFB_RUN make buildbottest TESTOPTS="-j4 -uall,-cpu" if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then $XVFB_RUN make PYTHON=../python SPHINXOPTS="-q -W -j4" -C Doc/ venv doctest fi " exited with 0.

They are warnings related to third party packages used for doctest and some of them might become incompatible with https://github.com/python/cpython/pull/10596. Related discussion : issue35109

> They are warnings related to third party packages used for doctest and some of them might become incompatible with https://github.com/python/cpython/pull/10596. Related discussion : issue35109 We should help these packages to be fixed :-)

Looks like they already fixed it. - jinja2: https://github.com/pallets/jinja/commit/31bf9b7e71c3fee3b7866ffdc0f70f4525a490d9 - babel: https://github.com/python-babel/babel/commit/65d6bf39f2a2b4bbbbc02cd1e00c44ce9d7c1c5b We should wait their release :)

I still get some warnings about docutils itself, e.g. /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/_html_base.py:1035: SyntaxWarning: invalid escape sequence \( 'mathjax': ('\(%s\)', '\\begin{%s}\n%s\n\\end{%s}'), /Users/guido/v38/lib/python3.8/site-packages/docutils/utils/math/math2html.py:4103: SyntaxWarning: invalid escape sequence \{ """Check for an empty command: look for command disguised as ending. /Users/guido/v38/lib/python3.8/site-packages/docutils/utils/math/math2html.py:4563: SyntaxWarning: invalid escape sequence \e "A \\begin{}...\end command and what it entails (array, cases, aligned)" /Users/guido/v38/lib/python3.8/site-packages/docutils/utils/math/latex2mathml.py:154: SyntaxWarning: invalid escape sequence \i '\in': '\u2209', /Users/guido/v38/lib/python3.8/site-packages/docutils/utils/math/latex2mathml.py:155: SyntaxWarning: invalid escape sequence \e '\equiv': '\u2262'} /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:1197: SyntaxWarning: invalid escape sequence \w none ) = re.split('(\w+)(.*)', settings.literal_block_env) /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:1463: SyntaxWarning: invalid escape sequence \ """Return text with 'problematic' characters escaped. /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:1562: SyntaxWarning: invalid escape sequence \p """Return list of label definitions for all ids of `node` /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:1922: SyntaxWarning: invalid escape sequence \p self.title.insert(0, '\phantomsection%\n ') /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:2269: SyntaxWarning: invalid escape sequence \d match = re.match('(\d*\.?\d*)\s*(\S*)', length_str) /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:2381: SyntaxWarning: invalid escape sequence \i self.out.append('\item[] ') /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:2525: SyntaxWarning: invalid escape sequence \( wrapper = '\(%s\)' /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:2804: SyntaxWarning: invalid escape sequence \c self.out.append('\n\n{\color{red}%s/%s} in \\texttt{%s}%s\n' % /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/latex2e/__init__.py:2892: SyntaxWarning: invalid escape sequence \l self.out.append('}] \leavevmode ') /Users/guido/v38/lib/python3.8/site-packages/docutils/writers/manpage.py:371: SyntaxWarning: invalid escape sequence \- "%(title)s \- %(subtitle)s\n")

Relevant docutils upstream issue : https://sourceforge.net/p/docutils/bugs/373/ . Also the SyntaxWarning was changed to DeprecationWarning with msg349335.

> Relevant docutils upstream issue : https://sourceforge.net/p/docutils/bugs/373/ . Also the SyntaxWarning was changed to DeprecationWarning with msg349335. SyntaxWarning warnings have been fixed in docutils 0.16.

 New changeset 6595cb0af4c51c0381c233b97884fe916a4ddd35 by Dong-hee Na in branch 'master': bpo-35293: Remove RemovedInSphinx40Warning (GH-22198) https://github.com/python/cpython/commit/6595cb0af4c51c0381c233b97884fe916a4ddd35 

 New changeset b7cdea8f087699aaa6486ce5a4f6e5a143dc355e by Miss Islington (bot) in branch '3.8': bpo-35293: Remove RemovedInSphinx40Warning (GH-22198) https://github.com/python/cpython/commit/b7cdea8f087699aaa6486ce5a4f6e5a143dc355e 

 New changeset f3e0eceff6207d5072befeef0e1ec195c3e2b0ab by Miss Islington (bot) in branch '3.9': bpo-35293: Remove RemovedInSphinx40Warning (GH-22198) https://github.com/python/cpython/commit/f3e0eceff6207d5072befeef0e1ec195c3e2b0ab 

/home/travis/virtualenv/python3.6.10/lib/python3.6/site-packages/sphinx/util/nodes.py:151: FutureWarning: The iterable returned by Node.traverse() https://travis-ci.com/github/python/cpython/jobs/386971271 The issue is still left, I am going to investigate this issue.

 New changeset 8394500cca56490cc347604d39ca40abcdce46c3 by Victor Stinner in branch 'master': bpo-35293: Travis CI uses "make venv" for the doc (GH-22307) https://github.com/python/cpython/commit/8394500cca56490cc347604d39ca40abcdce46c3 

 New changeset 9e73cac173e5e9010bd18c8334fffeee1cade3a4 by Victor Stinner in branch '3.9': bpo-35293: Travis CI uses "make venv" for the doc (GH-22307) (GH-22309) https://github.com/python/cpython/commit/9e73cac173e5e9010bd18c8334fffeee1cade3a4 

 New changeset 3acc403f21642f1e916f035abf24c3fb81495b3c by Victor Stinner in branch '3.8': bpo-35293: Travis CI uses "make venv" for the doc (GH-22307) (GH-22309) (GH-22310) https://github.com/python/cpython/commit/3acc403f21642f1e916f035abf24c3fb81495b3c 

Building the documentation of Python 3.8, 3.9 and 3.10 don't produce warnings anymore, I close the issue. I created https://github.com/python/docsbuild-scripts/issues/95 "Update Sphinx to 2.4.4".

 New changeset f8b3c64958753abce7badbff3525863577fe2e04 by Łukasz Langa (Victor Stinner) in branch '3.9': bpo-35293: Travis CI uses "make venv" for the doc (GH-22307) (GH-22309) https://github.com/python/cpython/commit/f8b3c64958753abce7badbff3525863577fe2e04