]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-80143: Add clarification for escape characters (#92292)
authorslateny <46876382+slateny@users.noreply.github.com>
Tue, 10 May 2022 16:12:29 +0000 (09:12 -0700)
committerGitHub <noreply@github.com>
Tue, 10 May 2022 16:12:29 +0000 (11:12 -0500)
Doc/reference/lexical_analysis.rst

index 0e64a056a6eb2056c2522042396d2010c7846319..1cf0a5b15cbbb9d9da7e3456dc948dec735f310e 100644 (file)
@@ -480,9 +480,11 @@ declaration is given in the source file; 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
@@ -541,6 +543,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: