[docs] [issue28450] Misleading/inaccurate documentation about unknown escape sequences

[Lele Gaifax]

New submission from Lele Gaifax:

Python 3.6+ is stricter about escaped sequences in string literals.

The documentation need some improvement to clarify the change: for example https://docs.python.org/3.6/library/re.html#re.sub first says that “Unknown escapes such as \& are left alone” then, in the “Changed in” section below, states that “[in Py3.6] Unknown escapes consisting of '\' and an ASCII letter now are errors”.

When such changes are made, usually the documentation reports the “new”/“current” behaviour, and the history section mention when and how some detail changed.

See this thread for details: https://mail.python.org/pipermail/python-list/2016-October/715462.html

----------
assignee: docs at python
components: Documentation
messages: 278716
nosy: docs at python, lelit
priority: normal
severity: normal
status: open
title: Misleading/inaccurate documentation about unknown escape sequences
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28450>
_______________________________________