[New-bugs-announce] [issue42822] Missing backslashes in documentation for 3.8 and 3.9

Julien Palard report at bugs.python.org
Mon Jan 4 08:03:42 EST 2021

New submission from Julien Palard <julien+python at palard.fr>:

This is just to track the issue, initially reported here:


Then discussed here:


Then reverted:

- in 3.8 https://github.com/python/cpython/pull/24093
- in 3.9 https://github.com/python/cpython/pull/24092

I edited the revert to keep only relevant parts, as only a few bits of the commit were causing troubles.

Issue is: Sphinx 2 and Sphinx 3 have incompatible handling of backslahes, fixing them for Sphinx 3 in Python 3.10, then backporting to 3.8 and 3.9 which use Sphinx 2 caused an issue: `\n` for example are rendered as `n`, easy to notice in the documentaion of print:

    print(*objects, sep=' ', end='n', file=sys.stdout, flush=False)¶

As migration to Sphinx 3 was hard (done for Python 3.10 documentation), it won't be backported to 3.8 and 3.9, which will still be built using Sphinx 2, so some bits had to be reverted for the doc to display the backslash of `\n`.

assignee: mdk
components: Documentation
messages: 384324
nosy: adelfino, mdk
priority: normal
severity: normal
stage: commit review
status: open
title: Missing backslashes in documentation for 3.8 and 3.9
versions: Python 3.8, Python 3.9

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list