[Python-checkins] bpo-33766: Document that end of file or string is a newline (GH-7383)
Miss Islington (bot)
webhook-mailer at python.org
Sat Jun 9 20:05:53 EDT 2018
https://github.com/python/cpython/commit/0cf58f494c9f8a017d8f8cf8d69ae2048414068b
commit: 0cf58f494c9f8a017d8f8cf8d69ae2048414068b
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-06-09T17:05:49-07:00
summary:
bpo-33766: Document that end of file or string is a newline (GH-7383)
(cherry picked from commit 0aa17ee6a76df0946d42e7657a501f1862065a22)
Co-authored-by: Ammar Askar <ammar_askar at hotmail.com>
files:
M Doc/reference/lexical_analysis.rst
diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index 1fe1a51a9c7b..84e8c783838b 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -47,11 +47,12 @@ Physical lines
--------------
A physical line is a sequence of characters terminated by an end-of-line
-sequence. In source files, any of the standard platform line termination
-sequences can be used - the Unix form using ASCII LF (linefeed), the Windows
-form using the ASCII sequence CR LF (return followed by linefeed), or the old
-Macintosh form using the ASCII CR (return) character. All of these forms can be
-used equally, regardless of platform.
+sequence. In source files and strings, any of the standard platform line
+termination sequences can be used - the Unix form using ASCII LF (linefeed),
+the Windows form using the ASCII sequence CR LF (return followed by linefeed),
+or the old Macintosh form using the ASCII CR (return) character. All of these
+forms can be used equally, regardless of platform. The end of input also serves
+as an implicit terminator for the final physical line.
When embedding Python, source code strings should be passed to Python APIs using
the standard C conventions for newline characters (the ``\n`` character,
More information about the Python-checkins
mailing list