[Python-checkins] gh-80143: Add clarification for escape characters (GH-92292) (GH-92630)

ambv webhook-mailer at python.org
Mon May 16 11:32:39 EDT 2022


https://github.com/python/cpython/commit/4d05114ae74a5028c7d645a8257e18c5b9ddfa78
commit: 4d05114ae74a5028c7d645a8257e18c5b9ddfa78
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ambv <lukasz at langa.pl>
date: 2022-05-16T17:32:28+02:00
summary:

gh-80143: Add clarification for escape characters (GH-92292) (GH-92630)

(cherry picked from commit 549567c6e70da4846c105a18a1a89e7dd09680d7)

Co-authored-by: slateny <46876382+slateny at users.noreply.github.com>

files:
M Doc/reference/lexical_analysis.rst

diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index 17c0fb4a51eb4..b8f9ca21c0682 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -447,9 +447,11 @@ see section :ref:`encodings`.
 In plain English: Both types of literals can be enclosed in matching single quotes
 (``'``) or double quotes (``"``).  They can also be enclosed in matching groups
 of three single or double quotes (these are generally referred to as
-*triple-quoted strings*).  The backslash (``\``) character is used to escape
-characters that otherwise have a special meaning, such as newline, backslash
-itself, or the quote character.
+*triple-quoted strings*). The backslash (``\``) character is used to give special
+meaning to otherwise ordinary characters like ``n``, which means 'newline' when
+escaped (``\n``). It can also be used to escape characters that otherwise have a
+special meaning, such as newline, backslash itself, or the quote character.
+See :ref:`escape sequences <escape-sequences>` below for examples.
 
 .. index::
    single: b'; bytes literal
@@ -508,6 +510,8 @@ retained), except that three unescaped quotes in a row terminate the literal.  (
    single: \u; escape sequence
    single: \U; escape sequence
 
+.. _escape-sequences:
+
 Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in string and
 bytes literals are interpreted according to rules similar to those used by
 Standard C.  The recognized escape sequences are:



More information about the Python-checkins mailing list