homepage

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